エンドポイント/Media

メディアタスクを取得

IDで非同期メディアタスクのステータスと結果を取得します。ステータスが succeeded または failed になるまで、このエンドポイントをポーリングしてください。

GEThttps://api.foxwire.ai/v1/media/generations/{id}

#認証

すべてのリクエストは Authorization ヘッダーにキーを含めます。

http

Authorization: Bearer sk-corr-...

パラメータ	種類	必須	説明
`id`	string	はい	タスク作成エンドポイントが返したタスクID。

bash

curl https://api.foxwire.ai/v1/media/generations/task_abc123 \
  -H "Authorization: Bearer $CORRY_KEY"

タスクオブジェクトを返します。一般的なフィールド:

フィールド	種類	説明
`id`	string	メディアタスクを取得 id
`status`	string	タスクのステータス:queued / submitted / succeeded / failed / timeout。
`type`	string	メディアの種類:image / video / music。
`model`	string	リクエストしたモデル。
`result.urls`	string[]	成功時に存在します。result.urls は永続的なファイルURLの配列です。
`error`	string	エラーメッセージ。タスクが失敗したときに存在します。
`cost`	string	このタスクの請求額 — USD 文字列(例:"0.1200")。currency フィールドを参照してください。

レスポンス例

{
  "id": "task_abc123",
  "status": "running",
  "type": "image",
  "model": "gpt-image-2"
}

status	説明
`queued`	キューに登録され、開始を待っています。
`running`	アップストリームのプロバイダーで生成中です。
`succeeded`	完了 — result.urls が利用可能です。
`failed`	失敗 — error を参照してください。保留分は自動的に返金されます。

成功時に存在します。result.urls は永続的なファイルURLの配列です。

ステータス	意味
`401`	キーが無効または欠落しています
`404`	要求されたモデルが存在しないか利用できません

json

{
  "error": {
    "message": "Task not found",
    "type": "not_found"
  }
}