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

このエンドポイントでは、任意の id を使用します。これは任意の /runwayml/v1 作成リクエストによって返されます。タスクを作成したアカウントと同じアカウントの CometAPI API キーで認証してください。

タスクの状態を追跡する

レスポンスはタスクオブジェクトです。id、status、および output を直接レスポンスから読み取ります。data エンベロープは使用しません。

`status`	次の手順
存在しない、`PENDING`、または `THROTTLED`	数秒待ってから、タスクを再度リクエストします。
`RUNNING`	ポーリングを継続します。存在する場合、`progress` は 0 から 1 の割合です。
`SUCCEEDED`	結果 URL の取得元 `output`.
`FAILED`	ポーリングを停止し、存在する場合は `failure` と `failureCode` を確認します。
`CANCELLED`	ポーリングを停止します。タスクはキャンセルされました。

送信直後のタスクでは、一時的に HTTP 400 と code: "task_not_exist"が返されることがあります。数秒待ってから、同じ id を使用して再試行してください。これが続く場合は、タスク ID と認証に使用したアカウントを確認してください。ステータスを確認するために、作成リクエストを再送信しないでください。

出力を保存する

output 配列には、作成エンドポイントおよび選択した形式に応じて、画像、動画、または音声の URL が含まれます。完了したアセットを速やかにダウンロードし、自身のストレージに保存してください。結果 URL は一時的です。新しい統合では、モデルと作成エンドポイントを次の場所で選択してください。 Runway の概要.

承認

Authorization

string

header

必須

Use your CometAPI API key.

パスパラメータ

string

必須

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

レスポンス

Task details. Fields vary with the task state.

string

必須

Task ID returned by a Runway task-creation request.

status

enum<string>

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

利用可能なオプション:

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.

必須範囲: 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

最終更新日 2026年9月18日

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

コンテンツモデレーション

APIキー

タスクの状態を追跡する

出力を保存する

承認

パスパラメータ

レスポンス

​タスクの状態を追跡する

​出力を保存する

承認

パスパラメータ

レスポンス

タスクの状態を追跡する

出力を保存する