curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seedance-2.5-draft-to-video",
"source_task_id": "task-unified-1774857405-abc123"
}
'{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "seedance-2.5-draft-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 165,
"video_duration": 0
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 50,
"user_group": "default"
}
}Seedance 2.5
Seedance 2.5 Draft-to-Video プレビューから正式動画へ
- 完成した Seedance 2.5 プレビュー動画（作成時に
draft: trueを指定したタスク）を、同じ内容の 1080p 正式動画に変換します - 指定できるフィールドは
model、source_task_id、output_format、callback_urlの 4 つのみです。プロンプト、素材、長さ、アスペクト比、乱数シード、音声設定はすべてプレビュー動画から引き継がれます。再指定は不要であり、指定することもできません。それ以外のフィールドを渡すと 400 パラメータエラーが返されます - プレビュー動画の
draft_expires_atより前に変換リクエストを送信してください。デフォルトの有効期限はプレビュー動画の完成から 24 時間です。実際の期限は、タスク照会で返されるdraft_expires_atを基準にしてください - システムはリクエスト受け付け時と生成処理への送信前に有効期限を確認します。待機中に期限が切れた場合、変換タスクは失敗し、その変換料金が返金されます。待機時間を考慮し、余裕を持って送信してください
- 有効期限内であれば、同じプレビュー動画を複数回変換できます。変換ごとに個別に課金されます
- 非同期処理モードです。返却されたタスク ID で照会してください。照会結果には
source_task_idが含まれます - 生成された動画リンクの有効期限は 24 時間です。お早めに保存してください
課金ルール：
- プレビュー動画とは別に課金され、解像度は固定で
1080pとして計算されます - 出力時間には、元のプレビュー動画に記録された実際の出力時間を使用します。実際の値がない場合は、元のタスクに記録された有効な出力時間を使用します
- プレビュー動画に動画入力がない場合、課金対象の長さは出力時間です。動画入力がある場合（Reference-to-Video、Video Edit、Video Extend を含む）、課金対象の長さは
出力時間 + max(入力動画の時間, 出力時間)となり、0.1 秒単位で切り上げます - プレビュー動画でコンテンツフィルターを無効にした場合（
content_filter: false）、正式動画にも +10%（1.1x）の料金が適用されます - 変換に失敗した場合、その変換料金は返金されます。プレビュー動画の料金は返金されません
POST
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seedance-2.5-draft-to-video",
"source_task_id": "task-unified-1774857405-abc123"
}
'{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "seedance-2.5-draft-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 165,
"video_duration": 0
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 50,
"user_group": "default"
}
}承認
##すべてのAPIはBearer Tokenによる認証が必要です##
APIキーの取得：
APIキー管理ページ にアクセスしてAPIキーを取得してください
リクエストヘッダーに以下を追加：
Authorization: Bearer YOUR_API_KEY
ボディ
application/json
動画生成モデル名
利用可能なオプション:
seedance-2.5-draft-to-video 例:
"seedance-2.5-draft-to-video"
完成した Seedance 2.5 プレビュー動画タスクの Task ID
取得方法： プレビュー動画の作成リクエスト（draft: true）で返された id フィールド
条件：
- タスクが現在のアカウントに属していること
- タスクのモデルが Seedance 2.5 の 5 つの生成モデルのいずれかであること
- タスク作成時に
draft: trueを指定していること - タスクのステータスが
completedであること - 現在時刻がタスク照会結果の
draft_expires_atより前であること
例:
"task-unified-1774857405-abc123"
出力コンテナ形式、デフォルトは mp4
選択可能な値：
mp4：H.264 エンコード、互換性が最も高く標準的な色精度（デフォルト）mov：H.264 + yuv444p クロマサンプリング + PCM 音声。色再現性が高く、カラーグレーディングやキーイング、合成などのポストプロダクション向け。ブラウザ内での再生に対応しない場合があるため、ダウンロードして VLC / mpv / ffplay で再生してください。追加料金なし
プレビュー動画の出力形式は引き継がれません。mov が必要な場合はここで指定してください
利用可能なオプション:
mp4, mov 例:
"mp4"
タスク完了後の HTTPS コールバックアドレス
コールバックタイミング：
- タスク完了（completed）または失敗（failed）時にトリガー
- 課金確認完了後に送信
セキュリティ制限：
- HTTPS プロトコルのみ対応
- プライベートIPアドレスへのコールバックは禁止（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x など）
- URL の長さは
2048文字以内
コールバックメカニズム：
- タイムアウト：
10秒 - 失敗後最大
3回リトライ（失敗後1/2/4秒でそれぞれリトライ） - コールバックレスポンスボディのフォーマットはタスク照会APIの返却フォーマットと同一
- 2xx ステータスコードを成功とみなし、その他のステータスコードでリトライをトリガー
例:
"https://your-domain.com/webhooks/video-task-completed"
レスポンス
正式動画への変換タスクの作成に成功
タスク作成タイムスタンプ
例:
1761313744
タスクID
例:
"task-unified-1774857405-abc123"
実際に使用されたモデル名
例:
"seedance-2.5-draft-to-video"
タスクの具体的なタイプ
利用可能なオプション:
video.generation.task タスク進捗パーセンテージ (0-100)
必須範囲:
0 <= x <= 100例:
0
タスクステータス
利用可能なオプション:
pending, processing, completed, failed 例:
"pending"
動画タスクの詳細情報
Show child attributes
Show child attributes
タスクの出力タイプ
利用可能なオプション:
text, image, audio, video 例:
"video"
使用量と課金情報
Show child attributes
Show child attributes