Hent en Runway-oppgave

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"
}

Bruk dette endepunktet med id som returneres av enhver /runwayml/v1-opprettelses forespørsel. Autentiser med en CometAPI API-nøkkel fra samme konto som opprettet oppgaven.

Følg oppgavestatusen

Responsen er et oppgaveobjekt. Les id, status og output direkte fra responsen, uten en data-innpakning.

`status`	Neste trinn
Mangler, `PENDING` eller `THROTTLED`	Vent noen sekunder, og hent oppgaven på nytt.
`RUNNING`	Fortsett å polle. `progress`, når den finnes, er en brøk fra 0 til 1.
`SUCCEEDED`	Les resultat-URL-er fra `output`.
`FAILED`	Stopp pollingen og undersøk `failure` og `failureCode`, når de finnes.
`CANCELLED`	Stopp pollingen; oppgaven ble kansellert.

En nylig sendt oppgave kan kortvarig returnere HTTP 400 med code: "task_not_exist". Vent noen sekunder, og prøv på nytt med samme id. Hvis dette fortsetter, kontrollerer du oppgave-ID-en og kontoen som ble brukt til autentisering. Ikke send opprettelsesforespørselen på nytt for å kontrollere statusen.

Lagre utdataene

Arrayet output inneholder URL-er til bilder, videoer eller lyd, avhengig av opprettelsesendepunktet og det valgte formatet. Last ned fullførte ressurser straks og lagre dem i din egen lagring. Resultat-URL-ene er midlertidige. For en ny integrasjon velger du en modell og et opprettelsesendepunkt i Runway-oversikten.

Autorisasjoner

Authorization

string

header

påkrevd

Use your CometAPI API key.

Stien-parametere

string

påkrevd

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

Svar

Task details. Fields vary with the task state.

string

påkrevd

Task ID returned by a Runway task-creation request.

status

enum<string>

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

Tilgjengelige alternativer:

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.

Nødvendig område: 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

Sist endret 18. september 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"
}

Innholdsmoderering

API-nøkler

Følg oppgavestatusen

Lagre utdataene

Autorisasjoner

Stien-parametere

Svar

​Følg oppgavestatusen

​Lagre utdataene

Autorisasjoner

Stien-parametere

Svar

Følg oppgavestatusen

Lagre utdataene