seedance-2.0/reference API ドキュメント — ByteDance（dreamtoai 経由）

seedance-2.0/reference

ビデオByteDanceSeedance 2.0参考生视频

Playground を開く API キーを管理

字节跳动最新一代视频模型

認証

Base URL: https://api.dreamtoai.com
Authorization: Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
モデル名 (model): seedance-2.0/reference

接続プロトコル

このプロトコルを選ぶ理由

适合需要提交任务并轮询状态的图像、视频、音频生成工作流。

エンドポイント URL

POST/v1/jobs

Authorization: Bearer YOUR_API_KEYContent-Type: application/json

リクエスト／レスポンス JSON

リクエスト

{
  "model": "seedance-2.0/reference",
  "input": {
    "prompt": "A cinematic daisy field",
    "reference_image_urls": [
      "https://example.com/frame-1.png",
      "https://example.com/frame-2.png"
    ],
    "reference_video_urls": [
      "https://example.com/input.mp4"
    ],
    "reference_audio_urls": [
      "https://example.com/audio.mp3"
    ],
    "aspect_ratio": "16:9",
    "duration": 4,
    "resolution": "480p",
    "seed": -1,
    "generate_audio": true,
    "mode": "reference",
    "channel": "byte2.0"
  }
}

レスポンス

{
  "id": "job_example",
  "object": "job",
  "status": "processing",
  "model": "seedance-2.0/reference",
  "created": 1710000000,
  "request_id": "req_example"
}

リクエスト／レスポンスのフィールド

リクエストのフィールド

フィールド	型	必須
prompt	string	Y
reference_image_urls	array	Y
reference_video_urls	array	N
reference_audio_urls	array	N
aspect_ratio	enum	N
duration	integer	N
resolution	enum	N
seed	integer	N
generate_audio	boolean	N
mode	string	N
channel	string	N

レスポンスのフィールド

フィールド	型	必須
output.task_id	string	N
output.status	string	N
output.videos[]	video	N

コード例

cURLrequest.sh

curl -X POST "https://api.dreamtoai.com/v1/jobs" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "seedance-2.0/reference",
  "input": {
    "prompt": "A cinematic daisy field",
    "reference_image_urls": [
      "https://example.com/frame-1.png",
      "https://example.com/frame-2.png"
    ],
    "reference_video_urls": [
      "https://example.com/input.mp4"
    ],
    "reference_audio_urls": [
      "https://example.com/audio.mp3"
    ],
    "aspect_ratio": "16:9",
    "duration": 4,
    "resolution": "480p",
    "seed": -1,
    "generate_audio": true,
    "mode": "reference",
    "channel": "byte2.0"
  }
}'

# 参照ファイルをアップロードする cURL
curl -X POST "https://api.dreamtoai.com/v1/files/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "kind=video" \
  -F "purpose=reference" \
  -F "[email protected]"

# タスク状態を確認する cURL
# job_example を送信レスポンスが返す task_id に置き換えてください
curl -X GET "https://api.dreamtoai.com/v1/jobs/job_example" \
  -H "Authorization: Bearer YOUR_API_KEY"