Passer au contenu principal
GET
/
runwayml
/
v1
/
tasks
/
{id}
Poll a Runway official-format task
curl --request GET \
  --url https://api.cometapi.com/runwayml/v1/tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "3d957031-9a2a-45e2-9dc7-bc8513059c50",
    "action": "IMAGE_TO_VIDEO",
    "status": "QUEUED",
    "fail_reason": "",
    "submit_time": 1773366766,
    "start_time": 0,
    "finish_time": 0,
    "progress": "0%",
    "data": {
      "id": "3d957031-9a2a-45e2-9dc7-bc8513059c50",
      "status": "PENDING",
      "createdAt": "2026-03-13T09:52:46+08:00"
    }
  }
}
Utilisez cet endpoint pour examiner une tâche Runway par id via le wrapper au format officiel.

​
Vérifiez d’abord ces champs

  • code et message externes pour le statut au niveau du wrapper
  • data.status et data.progress pour l’état actuel de la tâche
  • data.data imbriqué pour les métadonnées de tâche spécifiques au fournisseur

​
Quand l’utiliser

  • Après avoir appelé une page de création de tâche Runway au format officiel, comme text-to-image, image-to-video, video-to-video ou upscale
  • Lorsque vous avez besoin de la réponse unifiée du wrapper plutôt que de la route feed au format inversé

​
Comportement de nouvelle tentative

  • Une tâche tout juste créée peut brièvement renvoyer task_not_exist
  • Attendez quelques secondes puis réessayez avant de considérer l’id de tâche comme invalide
  • Une fois la tâche visible, cette route et le wrapper inverse feed peuvent renvoyer la même enveloppe en file d’attente ou en cours
La validation en direct du 2026-03-13 a renvoyé une réponse encapsulée avec code: success, status: QUEUED et un objet data imbriqué plutôt qu’un objet de tâche Runway brut.

Autorisations

​
Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

En-têtes

​
X-Runway-Version
string

Optional Runway version header, for example 2024-11-06.

Paramètres de chemin

​
id
string
requis

Runway task id returned by the create endpoint.

Réponse

200 - application/json

Current wrapper task state or not-yet-visible error.

​
code
string | null
requis
​
message
string
requis
​
data
object