Obtenir une tâche Runway

GET

runwayml

tasks

{id}

cURL

TASK_ID="<task_id>"

curl "https://api.cometapi.com/runwayml/v1/tasks/$TASK_ID" \
  --header "Authorization: Bearer $COMETAPI_KEY"

import os
import requests

task_id = "<task_id>"
response = requests.get(
    f"https://api.cometapi.com/runwayml/v1/tasks/{task_id}",
    headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
    timeout=60,
)
response.raise_for_status()
print(response.json())

const taskId = "<task_id>";

const response = await fetch(
  `https://api.cometapi.com/runwayml/v1/tasks/${taskId}`,
  { headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` } },
);
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/runwayml/v1/tasks/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cometapi.com/runwayml/v1/tasks/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/runwayml/v1/tasks/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "00000000-0000-4000-8000-000000000001"
}

Utilisez ce point de terminaison avec le id renvoyé par toute création /runwayml/v1 requête. Authentifiez-vous avec une clé API CometAPI du même compte que celui qui a créé la tâche.

Suivre l’état de la tâche

La réponse est un objet de tâche. Lisez id, status et output directement dans la réponse, sans enveloppe data.

`status`	Étape suivante
Absent, `PENDING`, ou `THROTTLED`	Attendez quelques secondes, puis demandez à nouveau la tâche.
`RUNNING`	Continuez l’interrogation. `progress`, lorsqu’il est présent, est une fraction comprise entre 0 et 1.
`SUCCEEDED`	Lisez les URL de résultat depuis `output`.
`FAILED`	Arrêtez l’interrogation et examinez `failure` et `failureCode`, lorsqu’ils sont présents.
`CANCELLED`	Arrêtez l’interrogation ; la tâche a été annulée.

Une tâche tout juste soumise peut brièvement renvoyer HTTP 400 avec code: "task_not_exist". Attendez quelques secondes et réessayez avec le même id. Si le problème persiste, vérifiez l’ID de la tâche et le compte utilisé pour l’authentification. Ne soumettez pas de nouveau la requête de création pour vérifier son état.

Stocker la sortie

Le tableau output contient des URL d’images, de vidéos ou d’audio selon le point de terminaison de création et le format sélectionné. Téléchargez rapidement les ressources terminées et stockez-les dans votre propre espace de stockage. Les URL de résultat sont temporaires. Pour une nouvelle intégration, choisissez un modèle et un point de terminaison de création dans la présentation de Runway.

Autorisations

Authorization

string

header

requis

Use your CometAPI API key.

Paramètres de chemin

string

requis

Task ID returned by a /runwayml/v1 creation request.

Réponse

Task details. Fields vary with the task state.

string

requis

Task ID returned by a Runway task-creation request.

status

enum<string>

Task state, when available. Poll until SUCCEEDED, FAILED, or CANCELLED.

Options disponibles:

PENDING,

THROTTLED,

RUNNING,

SUCCEEDED,

FAILED,

CANCELLED

createdAt

string<date-time>

Task submission timestamp, when available.

progress

number

Fraction completed, when reported for a running task.

Plage requise: 0 <= x <= 1

output

string<uri>[]

Result URLs for a succeeded task. Download the assets promptly for storage.

failure

string

Failure explanation, when present on a failed task.

failureCode

string

Machine-readable failure code, when present.

estimatedCost

object

Task estimate metadata, when returned.

Show child attributes

cost

object

Task cost metadata, when returned.

Show child attributes

Dernière modification le 18 septembre 2026

cURL

TASK_ID="<task_id>"

curl "https://api.cometapi.com/runwayml/v1/tasks/$TASK_ID" \
  --header "Authorization: Bearer $COMETAPI_KEY"

import os
import requests

task_id = "<task_id>"
response = requests.get(
    f"https://api.cometapi.com/runwayml/v1/tasks/{task_id}",
    headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
    timeout=60,
)
response.raise_for_status()
print(response.json())

const taskId = "<task_id>";

const response = await fetch(
  `https://api.cometapi.com/runwayml/v1/tasks/${taskId}`,
  { headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` } },
);
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cometapi.com/runwayml/v1/tasks/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cometapi.com/runwayml/v1/tasks/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cometapi.com/runwayml/v1/tasks/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "00000000-0000-4000-8000-000000000001"
}

Modération de contenu

Clés API

Suivre l’état de la tâche

Stocker la sortie

Autorisations

Paramètres de chemin

Réponse

​Suivre l’état de la tâche

​Stocker la sortie

Autorisations

Paramètres de chemin

Réponse

Suivre l’état de la tâche

Stocker la sortie