Interrogez les tâches de génération de l'API Rivya par ID de tâche public, lisez les états queued, processing, succeeded et failed, puis consommez les URL de résultat.

Utilisez GET /api/v1/generations/{taskId} pour vérifier une tâche de génération asynchrone.

Endpoint

GET https://rivya.ai/api/v1/generations/{taskId}

En-tête requis :

Authorization: Bearer rvya_sk_...

Exemple curl

curl https://rivya.ai/api/v1/generations/task_public_id \
  -H "Authorization: Bearer rvya_sk_..."

Valeurs de statut

Valeurs de statut publiques :

queued : tâche acceptée, non terminée
processing : la génération est en cours
succeeded : le résultat est disponible
failed : la tâche a échoué et peut inclure un objet d'erreur public

Réponse réussie

{
  "id": "task_public_id",
  "status": "succeeded",
  "model": "z-image",
  "reserved_credits": 1,
  "final_credits": 1,
  "created_at": "2026-05-10T00:00:00.000Z",
  "updated_at": "2026-05-10T00:01:00.000Z",
  "result": {
    "primary_url": "https://media.example/result.png",
    "urls": ["https://media.example/result.png"]
  },
  "error": null
}

primary_url est la première URL de résultat par commodité. urls contient la liste des URL publiques de résultat lorsqu'elle est disponible.

Réponse échouée

{
  "id": "task_public_id",
  "status": "failed",
  "model": "z-image",
  "reserved_credits": 1,
  "final_credits": 0,
  "created_at": "2026-05-10T00:00:00.000Z",
  "updated_at": "2026-05-10T00:01:00.000Z",
  "result": null,
  "error": {
    "code": "generation_failed",
    "message": "The generation failed."
  }
}

Conseils de polling

Commencez par un court délai, puis augmentez les intervalles de polling. Évitez les boucles serrées.

Modèle recommandé :

attendez 2 à 3 secondes après la soumission
interrogez toutes les 5 à 10 secondes pour les tâches normales
ralentissez pour les longues tâches vidéo et audio
arrêtez le polling quand le statut est succeeded ou failed

Limite de propriété

La tâche doit appartenir au même compte Rivya que celui associé à la clé API. Si elle est introuvable ou n'appartient pas au compte, l'endpoint renvoie not_found.

Statut de génération