タスクを照会する（Seedance）

このシリーズはOpenAIの動画生成形式をサポートしています（詳細はリンク 動画生成Sora互換形式 を参照してください）。

動画生成タスクを作成し、タスクIDを使用してステータスと結果を照会するために使用します。

タスク作成の主要フィールド：

• model：必須、モデル名。
• prompt：必須、動画生成のメイン説明文。
• content：任意。Volcano Ark の content 配列で、テキスト、画像、動画、音声素材を混在して配置できます。
• function_mode：任意、通常、万能リファレンスなどのアドバンスドモードで使用されます。

互換性のある入力パラメータ：

• mode：t2v / i2v / i2v_first_last / reference_images / reference_material
• image_url / image_urls / input_reference
• end_image_url / last_image_url
• video_urls / audio_urls
• seconds / duration
• aspect_ratio / ratio / size
• quality / resolution
• fps
• generate_audio / watermark

呼び出しの詳細：

• mode=reference_material または function_mode=omni_reference の場合、content を介してテキストとリファレンス素材を渡すことを推奨します。
• content テキスト項目の記述形式は { "type": "text", "text": "测试文字" } です。
• content 画像、動画、音声素材項目はそれぞれ image_url、video_url、audio_url のオブジェクト形式を使用します。例: { "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image", "name": "1" }。
• role で素材の用途を識別でき、name はプロンプト内で名前指定による参照に使用できます。
• ratio、duration、resolution、fps は、最終的な生成設定に影響します。

Gemini Omni の呼び出し：

• gemini-omni は、本 Seedance タスク API からも呼び出せます。
• mode=t2v はテキストから動画の生成に使用し、mode=r2v は参照画像/参照素材を用いた生成に使用し、mode=edit は動画編集に使用します。
• テキストは prompt または content の text 項目に配置できます。画像は image_url / image_urls / reference_images / input_reference / content に、動画は video_urls / content に配置できます。
• 再生時間フィールドは duration または seconds を使用でき、4 / 6 / 8 / 10 秒のいずれかに自動でマッチします。

照会結果の注目フィールド：

• items[].status
• items[].content.video_url または items[].video_url
• items[].error
• items[].progress

Error fields: error.code, error.message.

{
"error": {
"code": "invalid_request_error",
"message": "requires at least one image in `images`"
}
}