ドキュメントを見る
MCP(モデルコンテキストプロトコル)

ジョブと結果

FoxCut の作成は非同期です。送信後にポーリングし、出力 URL を使用してください。

処理の流れ

例
queued → running → succeeded
                 ↘ failed
queued/running → canceled

送信すると、ジョブ ID、クレジット費用、ステータス、get_generation でポーリングするための案内が返されます。完了したジョブには出力アセットの URL とサムネイルが含まれます。

音声の由来と確認

音声ジョブでは speech.provider と speech.model が確認できます。model_source は送信前には job_snapshot、プロバイダーのレシートがある場合は request_header です。記録された Fish モデル ID は FoxCut 製品ラベル foxcut-speak とは異なります。Fish は固定された配信バージョンを返さないため、speech.model_version は null です。成功とは再生可能な音声が保存されたことを示します。speech.content_verification=not_performed の場合、読み上げ内容と演技を聞いて確認する必要があります。

ポーリングの目安

  • 3〜10 秒ごとにポーリングします。ジョブが実行中という理由だけで代替ジョブを作成しないでください。
  • failed と canceled は終端状態として扱います。
  • クライアント再起動後は list_generations でジョブを確認します。
  • 出力 URL は認証済みアカウントに属します。他のアカウントの ID を推測しないでください。