メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

CometAPI の動画モデルドキュメントは、ジョブの種類に合ったプロバイダーワークフローを選んで利用します。ほとんどの動画エンドポイントは非同期タスクを作成するため、task ID を保存し、ポーリングで結果を取得してください。コールバックは、モデル固有のページにコールバック対応が記載されている場合にのみ追加してください。

​
動画 API を選ぶ

Sora 動画を作成

Sora 動画ジョブを作成します。

Sora 動画を取得

Sora 動画ジョブを照会します。

Runway 画像から動画

画像から Runway 動画を生成します。

Kling テキストから動画

テキストプロンプトから Kling 動画を生成します。

Seedance 作成

Seedance 動画タスクを作成します。

xAI 動画生成

xAI 動画ジョブを生成します。

​
動画タスクを作成してポーリングする

Models page または model directory から、動画対応の model ID を使用してください。以下の例では、POST /v1/videos で動画タスクを作成し、その後、返された task ID をタスクが終了状態に達するまでポーリングします。
これらの例ではプレースホルダー your-video-model-id を使用しています。リクエストを実行する前に、Models page または model directory にある利用可能な動画 model ID に置き換えてください。
API playground とエンドポイントスキーマを使うには、Create と Query を開いてください。
import os
import time
import requests

headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}

create_response = requests.post(
    "https://api.cometapi.com/v1/videos",
    headers=headers,
    data={
        "model": "your-video-model-id",
        "prompt": "A calm camera move across a desk with a paper airplane",
    },
    timeout=30,
)
create_response.raise_for_status()
task = create_response.json()
task_id = task["id"]

terminal_statuses = {"completed", "failed", "error"}

while True:
    poll_response = requests.get(
        f"https://api.cometapi.com/v1/videos/{task_id}",
        headers=headers,
        timeout=30,
    )
    poll_response.raise_for_status()
    result = poll_response.json()
    print(result["status"], result.get("progress"))

    if result["status"] in terminal_statuses:
        print(result.get("video_url"))
        break

    time.sleep(10)

​
レスポンス例

作成成功時のレスポンスは以下のようになります。ポーリングを始める前に task ID を保存してください。 
{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "your-video-model-id",
  "status": "queued",
  "progress": 0,
  "created_at": 1779872000
}
ポーリング成功時のレスポンスは以下のようになります。完了したレスポンスには video_url が含まれる場合があります。プロバイダーフォーマットによっては、モデル固有の結果フィールドや、そのルートが文書化されている場合は動画コンテンツルートを使用します。 
{
  "id": "task_example",
  "object": "video",
  "model": "your-video-model-id",
  "status": "completed",
  "progress": 100,
  "completed_at": 1779872300,
  "video_url": "https://example.com/generated-video.mp4"
}

​
モデルレコードの例

このモデルカタログレスポンスの例は、/api/models のエンベロープと 1 つの動画モデルレコードの形を示しています。完全なモデル一覧ではありません。
cURL
curl https://api.cometapi.com/api/models

{
  "success": true,
  "page": 1,
  "page_size": 20,
  "total": 302,
  "data": [
    {
      "created": 1767529753,
      "id": "your-video-model-id",
      "code": "your-video-model-id",
      "provider": "ExampleProvider",
      "provider_code": "example",
      "name": "Example video model",
      "model_type": "video",
      "features": [
        "text-to-video"
      ],
      "endpoints": "{\n  \"seedance\": {\n    \"path\": \"/v1/videos\",\n    \"method\": \"POST\"\n  }\n}",
      "pricing": {
        "currency": "USD / M Tokens",
        "input": null,
        "output": null,
        "per_request": null,
        "per_second": 0.024
      }
    }
  ]
}

​
よくあるエラー

ジョブハンドラーから戻る前に、作成レスポンスの ID を保存してください。
ステータス確認の間に遅延とバックオフを追加してください。
選択した動画エンドポイントに記載されている duration と resolution フィールドを使用してください。
video_url は任意として扱い、利用可能な場合はモデル固有の結果フィールドまたは content ルートにフォールバックしてください。
正しい情報源としてポーリングを使用し、コールバック URL が POST リクエストを受け付けることを確認してください。

​
エラーコードとリトライ戦略

prompt、ファイル、duration、または size フィールドが修正されるまでリトライしないでください。
API キーが存在し有効になるまでリトライしないでください。
リトライする前に、task ID、base URL、path、model ID を確認してください。
リトライする前にアップロードサイズを減らしてください。
指数バックオフでリトライし、作成またはポーリングの同時実行数を減らしてください。
バックオフ付きでタスク作成をリトライしてください。タスクが終了エラーに達しない限り、既存タスクのポーリングは継続してください。
実装パターンについては、Error codes and retry strategy、Rate limits and concurrency、Webhook and polling for video generation を参照してください。

​
料金とモデルディレクトリ

Models page

ドキュメントで CometAPI が model ID をどのように公開しているかを確認します。

Model directory

利用可能なモデルと機能を確認します。

Pricing

モデルを呼び出す前に料金を確認します。
Last modified on May 28, 2026