マーケットサポート← アプリに戻る

タスク詳細の取得

GEThttps://97ai.97claude.com/api/generate/{taskId}

taskId（パスパラメータ）で非同期生成タスクの状態と結果を照会します。state が success または fail になるまで、数秒ごとにこのエンドポイントをポーリングしてください。

  • state は次のいずれか：waiting、queuing、generating、success、fail
  • 成功時、resultUrls に生成されたメディア URL が入ります（テキスト出力の場合は resultText）
  • creditsConsumed は実際に課金されたコストを反映します。失敗したタスクは課金されません
  • balance は精算後の残りクレジット残高です

リクエスト

認証

Authorization ヘッダーに bearer トークンを指定してください。

Authorization: Bearer <YOUR_API_KEY>
クエリパラメータ
taskIdstring (path)必須

POST /api/generate が返すタスク識別子。

例： task_12345678

レスポンス

200 · 成功レスポンス — application/json
taskIdstring必須

タスク識別子

例： task_12345678
statestring必須

waiting | queuing | generating | success | fail

例： success
resultUrlsstring[]任意

state が success のときの生成メディア URL

例： ["https://.../out.jpg"]
resultTextstring任意

テキスト生成モデルのテキスト出力

creditsConsumedinteger必須

このタスクで実際に課金されたクレジット

例： 5
failMsgstring任意

state が fail のときの失敗メッセージ

balanceinteger必須

残りのクレジット残高

例： 1950
ステータスコード
コード説明
200成功 — リクエストは正常に処理されました
400不正なリクエスト — パラメータが正しくないか不足しています
401未認証 — 認証情報が不足しているか無効です
405メソッド不許可 — このリクエストメソッドはサポートされていません
500サーバーエラー — 予期しないエラーが発生しました。再試行してください

例

リクエスト — cURL
cURL
curl -X GET "https://97ai.97claude.com/api/generate/task_12345678" \
  -H "Authorization: Bearer YOUR_API_KEY"
レスポンス — 200
JSON
{
  "taskId": "task_12345678",
  "state": "success",
  "resultUrls": ["https://example.com/generated.jpg"],
  "resultText": null,
  "creditsConsumed": 5,
  "failMsg": "",
  "balance": 1950
}