Seedance 2.0 Mini API
ByteDance による Seedance 2.0 Mini 動画生成モデル向けの完全な API リファレンスです。
モデルバリアント {#}
この API は 3 つのモデルバリアントをサポートします。
クイック比較
対応アスペクト比
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
解像度オプション
Seedance 2.0 Mini Text to Video
エンドポイント
POST /api/v1/video/task
リクエストパラメータ
必須
任意
リクエスト例
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model_name: 'seedance-v2.0-mini-text-to-video',
prompt: 'A golden retriever running through a sunlit meadow',
duration: 6,
resolution: '720p',
aspect_ratio: '16:9',
sound: true
})
});
const { data } = await response.json();
const taskId = data.task_id;
Seedance 2.0 Mini Image to Video
リクエストパラメータ
必須
任意
リクエスト例
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model_name: 'seedance-v2.0-mini-image-to-video',
image_url: 'https://example.com/image.jpg',
image_end_url: 'https://example.com/end-frame.jpg',
prompt: 'Camera slowly pulls back to reveal the full landscape',
duration: 6,
resolution: '720p',
aspect_ratio: '16:9',
sound: true
})
});
const { data } = await response.json();
const taskId = data.task_id;
Seedance 2.0 Mini Reference to Video
リクエストパラメータ
必須
参照メディア
各リクエストには画像または動画を 1 つ以上含める必要があります。画像を参照する場合は 1～9 枚の画像を送信してください。images 配列を省略または空にできるのは、videos 配列に参照動画が 1 つ以上含まれる場合のみです。音声のみのリクエストには対応していません。
@ (AT) 参照プレースホルダー
@ (AT) 参照機能は、番号付きの <<<...>>> プレースホルダーを通じて参照メディアをプロンプトに関連付けます。番号はメディアタイプごとに独立して 1 から始まり、対応する配列の順序に従います。
各プレースホルダーは、対応する配列内に存在する項目を指す必要があります。
任意
参照動画の料金
Seedance V2.0 Mini Reference-to-Video は、他の Seedance 2.0 参照バリアントと同じ、解像度別・秒単位の課金体系に従います。videos 配列に参照動画が 1 つ以上含まれる場合、生成料金の合計は 2 倍になります。この倍率は、アップロードした参照動画の数や長さにかかわらず一度だけ適用されます。
リクエスト例
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model_name: 'seedance-v2.0-mini-reference-to-video',
prompt: 'Place the explorer from <<<image_1>>> in the environment from <<<image_2>>>, following the camera movement in <<<video_1>>> and speaking with the reference voice from <<<audio_1>>>',
duration: 8,
resolution: '720p',
aspect_ratio: '16:9',
sound: true,
images: [
'https://example.com/explorer-reference.jpg',
'https://example.com/environment-reference.jpg'
],
videos: ['https://example.com/camera-movement-reference.mp4'],
audios: ['https://example.com/voice-reference.mp3']
})
});
const { data } = await response.json();
const taskId = data.task_id;
レスポンス形式
初回レスポンス
すべてのモデルはポーリング用の task_id を返します。
{
"code": 0,
"message": "success",
"data": {
"task_id": "{task_id}",
"response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
"task_status": "submitted"
}
}
ポーリングレスポンス
GET /api/v1/video/{taskId} をポーリングしてステータスを確認します。
{
"code": 0,
"message": "success",
"data": {
"task_id": "{task_id}",
"response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
"task_status": "succeed",
"task_status_msg": null,
"task_result": {
"videos": [
{
"url": "https://example.com/generated-video.mp4"
}
]
}
}
}
ステータス値
submitted: タスクが受け付けられ、処理待ちですprocessing: 動画生成が進行中ですsucceed: 動画生成が完了しましたfailed: 動画生成に失敗しました
処理時間
通常の処理時間は、長さと解像度によって 2-6 分です。
5-10 秒ごとにポーリングしてステータスを確認します。
ベストプラクティス
- モーションを明確に説明する：プロンプトに具体的な動きの説明を含めます
- 解像度の選択：より高速な処理には
480p、より高品質には 720p を使用します
- 音声強化：より没入感のある動画体験のために
sound を有効にしておきます
- 画像から動画：
image_url で明確な最初のフレームを指定し、開始フレームと終了フレームを制御したい場合は image_end_url を使用します
- 参照メディア：対応している画像、動画、音声の参照を使用し、画像または動画を 1 つ以上含めます
- 参照動画の料金：参照動画を 1 つ以上含む Reference-to-Video リクエストは、アップロードした動画の数や長さにかかわらず 2 倍の料金になります
- Seed パラメータ：
seed を送信しないでください。Seedance 2.0 Mini モデルは対応していません