画像

イメージ生成はドキュメント ナビゲーションで表現されるため、API ドキュメントでは一貫した製品マップが維持されます。パブリックエンドポイントの可用性はスキーマ主導型です。製品コードからイメージ エンドポイントを呼び出す前に、GET /api/openapi.json を確認してください。

＃＃ リクエスト

イメージ エンドポイントが有効な場合、非同期タスク モデルが期待されます。プロンプトとモデル オプションを使用してタスクを作成し、完了をポーリングします。リクエストでは引き続きベアラー認証が使用されます。

Authorization: Bearer FISHAUDIO_API_KEY

他のドキュメントから他の環境のパスを推測しないでください。デプロイされた環境には、OpenAPI スキーマに存在するパスのみを使用します。

＃＃ 応答

通常、イメージ タスクの応答には、タスク ID、ステータス、成功した場合の結果イメージ URL、失敗した場合のエラー コードが含まれます。ユーザーがページの更新またはワーカーの再起動後に結果を回復できるように、ポーリング前にタスク ID を保存します。

請求とクレジット

画像生成は、モデル、解像度、参照画像、または成功したタスクによって料金が発生する場合があります。タスクを作成する前にプロンプ​​トのサイズと入力メディアを検証し、大きなバッチの前に プロファイル を確認してください。

エラー

サポートされていないモデル、無効な参照画像、クレジット不足、処理失敗を個別に処理します。イメージ エンドポイントが GET /api/openapi.json にない場合、その機能はアカウントで公開されていないものとして扱います。

正式な OpenAPI エンドポイント

• モデル一覧: GET /api/open/v1/media/models?mediaType=image
• 画像生成: POST /api/open/v1/media/images/jobs
• タスク取得: GET /api/open/v1/media/images/jobs/{jobId}

生成リクエストには一意の Idempotency-Key ヘッダーが必須です。この API は Web 会員クレジットではなく API クォータを使用し、プロバイダー、ストレージ、または永続化の失敗時にはクォータを冪等に返金します。