動画 API を選ぶ
Seedance 動画を作成
Seedance の動画タスクを作成します。
HappyHorse 動画を作成
HappyHorse のテキストから動画へのジョブを作成します。
Sora 2 動画を作成
Sora 2 の動画ジョブを作成します。
Sora 2 動画を取得
Sora の動画ジョブを照会します。
Veo 3 動画を作成
Veo の動画ジョブを作成します。
Wan 動画を作成
Wan のテキストから動画へのジョブを作成します。
xAI 動画を作成
xAI の動画ジョブを生成します。
Vidu 動画を作成
Vidu のテキストから動画へのジョブを作成します。
Omni 動画を作成(ベータ)
ベータ版の Omni 動画ジョブを作成します。
Kling のテキストから動画タスクを作成
テキストプロンプトから Kling 動画を生成します。
Runway の画像から動画タスクを作成
画像から Runway 動画を生成します。
動画タスクを作成してポーリングする
Models page または model directory から、動画対応の model ID を使用します。以下の例では、まずPOST /v1/videos で動画タスクを作成し、その後タスクが終了状態に到達するまで返されたタスク ID をポーリングします。
これらの例では、プレースホルダー
your-video-model-id を使用しています。リクエストを実行する前に、Models page または model directory で利用可能な動画 model ID に置き換えてください。レスポンス例
作成リクエストが成功した場合のレスポンスは、次のようになります。ポーリングを始める前にタスク ID を保存してください。video_url が含まれる場合があります。また、一部のプロバイダ形式では、モデル固有の結果フィールド、またはそのルートがドキュメント化されている場合は動画コンテンツルートが使用されます。
モデルレコードの例
このモデルカタログレスポンスの例は、
/api/models のエンベロープと、1 つの動画モデルレコードの形状を示しています。完全なモデル一覧ではありません。cURL
一般的なエラー
タスク ID がありません
タスク ID がありません
ジョブハンドラーから返す前に、create レスポンスの ID を保存してください。
ポーリングが速すぎます
ポーリングが速すぎます
ステータス確認の間に遅延とバックオフを追加してください。
サポートされていない duration または size
サポートされていない duration または size
選択した動画 endpoint に対してドキュメント化されている duration フィールドと resolution フィールドを使用してください。
video_url がありません
video_url がありません
video_url はオプションとして扱い、利用可能な場合はモデル固有の結果フィールドまたは content ルートにフォールバックしてください。コールバックを受信していません
コールバックを受信していません
polling を信頼できる情報源として使用し、コールバック URL が POST リクエストを受け付けることを確認してください。
エラーコードと再試行戦略
400
400
プロンプト(Prompt)、ファイル、duration、または size フィールドが修正されるまで再試行しないでください。
401
401
API キーが存在し、有効になるまで再試行しないでください。
404
404
再試行する前に、タスク ID、base URL、path、model ID を確認してください。
413
413
再試行する前にアップロードサイズを減らしてください。
429
429
指数バックオフで再試行し、create または polling の同時実行数を減らしてください。
500 or 503
500 or 503
バックオフを使ってタスク作成を再試行してください。タスクが終了エラーに達しない限り、既存タスクの polling は継続してください。
料金とモデルディレクトリ
モデルページ
CometAPI がドキュメント内で model ID をどのように公開しているかを確認してください。
モデルディレクトリ
利用可能なモデルとその機能を確認してください。
料金
モデルを呼び出す前に料金を確認してください。