Bir Runway görevi alın

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

Herhangi bir id ile bu endpoint’i kullanın; bu değer, herhangi bir /runwayml/v1 oluşturma isteğinden döndürülür. Görevi oluşturan hesapla aynı hesaba ait bir CometAPI API anahtarıyla kimlik doğrulaması yapın. oluşturdu.

Görev durumunu takip edin

Yanıt bir görev nesnesidir. id, status ve output öğelerini doğrudan okuyun yanıttan; data zarfı olmadan.

`status`	Sonraki adım
Eksik, `PENDING` veya `THROTTLED`	Birkaç saniye bekleyin ve görevi yeniden isteyin.
`RUNNING`	Yoklamaya devam edin. Varsa `progress`, 0 ile 1 arasında bir kesirdir.
`SUCCEEDED`	Sonuç URL’lerini şuradan okuyun `output`.
`FAILED`	Yoklamayı durdurun ve varsa `failure` ile `failureCode` öğelerini inceleyin.
`CANCELLED`	Yoklamayı durdurun; görev iptal edildi.

Yeni gönderilmiş bir görev, kısa süreliğine HTTP 400 durumunu şu değerle birlikte döndürebilir code: "task_not_exist". Birkaç saniye bekleyin ve aynı id kullanarak yeniden deneyin. Sorun devam ederse görev kimliğini ve kimlik doğrulaması için kullanılan hesabı kontrol edin. Durumunu kontrol etmek için oluşturma isteğini yeniden göndermeyin.

Çıktıyı depolayın

output dizisi, oluşturma endpoint’ine ve seçilen biçime göre görüntü, video veya ses URL’leri içerir. Tamamlanan varlıkları hemen indirin ve kendi depolama alanınızda saklayın. Sonuç URL’leri geçicidir. Yeni bir entegrasyon için, bir model ve oluşturma endpoint’i seçmek üzere şu bölüme bakın: Runway genel bakışı.

Yetkilendirmeler

Authorization

string

header

gerekli

Use your CometAPI API key.

Yol Parametreleri

string

gerekli

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

Yanıt

Task details. Fields vary with the task state.

string

gerekli

Task ID returned by a Runway task-creation request.

status

enum<string>

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

Mevcut seçenekler:

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.

Gerekli aralık: 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

Son değiştirilme tarihi 18 Eylül 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"
}

İçerik moderasyonu

API anahtarları

Görev durumunu takip edin

Çıktıyı depolayın

Yetkilendirmeler

Yol Parametreleri

Yanıt

​Görev durumunu takip edin

​Çıktıyı depolayın

Yetkilendirmeler

Yol Parametreleri

Yanıt

Görev durumunu takip edin

Çıktıyı depolayın