API リファレンス
画像から動画
Seedance 2.0 Open API で画像や参照素材から動画を生成します。
このモードでは、mediaUrls に 1 つ以上の公開メディア URL を渡します。
Endpoint
POST /api/open/v1/video/generations対応する参照素材
| Type | Common formats | Typical usage |
|---|---|---|
| 画像 | .jpg, .jpeg, .png, .webp, .gif, .bmp | 開始フレーム、終了フレーム、スタイル参照 |
| 動画 | .mp4, .mov, .m4v | 動きやカメラワークの参照 |
| 音声 | .mp3, .wav | リズムやタイミングの参照 |
リクエスト例
curl --request POST \
--url https://www.seedance2.ink/api/open/v1/video/generations \
--header 'Authorization: Bearer sd2_live_your_api_key' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance-2.0",
"prompt": "A young woman blows out birthday candles, warm indoor lighting, shallow depth of field",
"mediaUrls": [
"https://example.com/photo.jpg"
],
"aspectRatio": "16:9",
"duration": 5,
"resolution": "720p"
}'成功レスポンス
{
"success": true,
"requestId": "req_1234567890",
"status": "queued",
"creditsCharged": 64
}リクエスト項目
| Field | Type | Required | Description |
|---|---|---|---|
model | string | Yes | seedance-2.0、seedance-2.0-fast、seedance-1.5-pro のいずれかです。 |
prompt | string | Yes | 生成したい動画を説明する自然言語プロンプトです。 |
mediaUrls | string[] | Yes | 公開アクセス可能な参照メディア URL を 1 件から 5 件まで指定します。 |
aspectRatio | string | No | 16:9、9:16、1:1 のいずれかです。 |
duration | integer | No | seedance-2.0 と seedance-2.0-fast は 4-15 秒、seedance-1.5-pro は 5 または 10 秒です。 |
resolution | string | No | 480p、720p、1080p のいずれかです。 |
webhookUrl | string | No | 完了時に結果を受け取るコールバック URL です。 |
metadata | object | No | リクエストと一緒に保存する任意のメタデータです。 |
結果の確認
curl https://www.seedance2.ink/api/open/v1/video/generations/req_1234567890 \
--header 'Authorization: Bearer sd2_live_your_api_key'{
"success": true,
"requestId": "req_1234567890",
"status": "succeeded",
"model": "seedance-2.0",
"prompt": "A river flowing through an autumn forest, aerial view, cinematic motion",
"duration": 5,
"aspectRatio": "16:9",
"output": {
"type": "video",
"url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
},
"error": null
}ジョブをキャンセル
curl --request POST \
--url https://www.seedance2.ink/api/open/v1/video/generations/req_1234567890/cancel \
--header 'Authorization: Bearer sd2_live_your_api_key'{
"success": true,
"requestId": "req_1234567890",
"status": "cancelled"
}メモ
mediaUrlsには最大5件まで指定できます。- 公開アクセス可能な HTTPS URL を使用してください。
- 参照素材が不要な場合は テキストから動画 を使ってください。