ビデオ

一貫した製品マップを維持するためにビデオ生成はこのドキュメント構造に含まれていますが、パブリック エンドポイントの可用性はOpenAPI スキーマとアカウント構成から確認する必要があります。

＃＃ リクエスト

ビデオ エンドポイントが有効になっている場合は、非同期タスク モデルが期待されます。作成リクエストには通常、プロンプト、モデル、期間、アスペクト比、およびオプションのフレームまたは参照メディアが含まれます。すべてのリクエストはベアラー認証を使用します。

Authorization: Bearer FISHAUDIO_API_KEY

GET /api/openapi.json によって返されたエンドポイント パスのみを使用します。他の展開からクライアントにパスをコピーしないでください。

＃＃ 応答

ビデオ タスクの応答は通常、最初にタスク ID とステータスを返し、完了後に結果のビデオ URL を返します。ビデオ生成はブラウザー セッションを超えて存続する可能性があるため、タスク ID と元のプロジェクト ID を一緒に保存します。

請求とクレジット

ビデオタスクはコストがかかる場合があります。長時間、高解像度、またはバッチ生成に対してユーザー確認を強制します。バッチを作成する前に プロファイル を確認し、クレジットが不足している場合はキューを一時停止します。

エラー

無効なプロンプト、サポートされていないモデル、アクセスできない参照メディア、不十分なクレジット、および処理の失敗を処理します。スキーマがビデオ エンドポイントを公開していない場合は、非表示のルートを試行する代わりに、機能を使用不可として表示します。

現行の公開エンドポイント

検証済みモデルは GET /api/open/v1/media/models?mediaType=video、作成は POST /api/open/v1/media/videos/jobs、照会は GET /api/open/v1/media/videos/jobs/{jobId} を使用します。作成時には一意の Idempotency-Key が必須です。同じキーで再試行すると最初の応答が返り、重複作成や重複課金は発生しません。課金は Web 会員クレジットではなく API クォータから行われ、作成、保存、非同期処理、タイムアウトの失敗時には冪等に返金されます。