動画生成タスクを取得

GET /v1/videos/{id}?model={model} を使用します。model は作成時と同じ値が必須です。新しい ID は ioa_v1. で始まる署名付きハンドルで、元のマッピングと上流資格情報に結び付きます。model の指定は引き続き必要です。

リクエスト項目

id：作成時の完全な ID を不透明な文字列として保存し URL エンコードします。上流 ID に置換しません。model：作成時の InOneAPI 公開モデル ID、必須。Authorization：同じユーザー所有でモデル権限がある有効なキー。本文やページング指定はありません。以下の ID は例示用なので実際の作成レスポンスに置き換えてください。

curl --get 'https://api.inoneapi.com/v1/videos/ioa_v1.REPLACE_WITH_RETURNED_TASK_ID' \
  --header "Authorization: Bearer $INONEAPI_API_KEY" \
  --data-urlencode 'model=YOUR_MODEL_ID'

レスポンス項目

{
  "id":"ioa_v1.REPLACE_WITH_RETURNED_TASK_ID",
  "status":"succeeded",
  "created_at":"2026-09-05T08:30:00Z",
  "completed_at":"2026-09-05T08:31:12Z",
  "video_url":"https://example.com/output.mp4",
  "error":null
}
FieldTypeレスポンス項目
idstringタスク識別子。ゲートウェイの Trace ID ではありません。
statusstringqueued：待機、running：処理中、succeeded：成功、failed：失敗、cancelled：取消、expired：期限切れ。設定で正規化します。
created_atstringISO 8601 作成日時。プロバイダーが提供する場合のみ。DSL は Unix 時刻から日時へ変換しません。
completed_atstring/nullISO 8601 完了日時。処理中は省略または null。
video_urlstring/null成功時の動画 URL。その他の状態では通常省略または null。有効期限と署名はプロバイダー依存で、永続保存は保証しません。
errorobject/nullエラーオブジェクトまたは null。code は識別コード、message は説明。返却項目は設定依存。
{"id":"ioa_v1.REPLACE_WITH_RETURNED_TASK_ID","status":"failed","error":{"code":"GENERATION_FAILED","message":"Generation could not be completed"}}

ポーリングとエラー

2～5 秒間隔で総タイムアウトを設定。queued/running のみ継続し、すべての終了状態で停止。429 は Retry-After に従い、5xx は上限付きバックオフ。401/403 は認証、404 はモデル・ID・ルートを確認。HTTP 200 だけでは成功を意味しません。取得失敗を理由に再作成しないでください。

現在の制限

新しい署名付きハンドルはユーザーと公共モデルを検証し、元のマッピングと上流資格情報に照会を固定します。タスク DB は不要です。署名やユーザー・モデルが不一致の場合は 404 VIDEO_TASK_NOT_FOUND。元の経路が利用不能でも別社へ切り替えず、503 UPSTREAM_UNAVAILABLE となる場合があります。旧形式の生 ID に同等の保証はなく、元の上流設定を維持してください。共通キャンセルは提供せず、コールバックは対応プロバイダーのみが送信します。

オンライン体験

Playground とモデル詳細の「今すぐ試す」ではテキストから動画を生成し、3 秒ごとに最大 10 分間タスクを確認します。待機の停止や確認エラーの後は「確認を再開」で元のタスクを取得し、再作成を防ぎます。待機の停止は上流の生成をキャンセルしません。成功した結果は動画プレーヤーで表示します。保存済みの会話にはタスクと結果 URL を保持しますが、外部 URL の有効期限は延長されません。

動画生成タスクを取得 · ドキュメント · InOneAPI