Skip to main content
POST
中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。
  • ByteDance Doubao video generation model 1.5 Pro version
  • Supports text-to-video generation
  • Supports first frame / last frame control
  • Does not support reference image mode
  • Supports audio generation (1.5 Pro exclusive feature)
  • Async task management, query results by task ID

Authorizations

string
必須
All endpoints require Bearer Token authenticationGet your API Key from the API Key Management PageAdd to request header:

Body

string
デフォルト:"doubao-seedance-1-5-pro"
必須
Video generation model nameAvailable models:
  • doubao-seedance-1-5-pro - 1.5 Pro version, supports audio generation and first/last frame control
string
必須
Video content descriptionDescribe scenes, actions, and style in detail for better generation resultsExample: "Sunset at the beach, golden sunlight on the sea, waves gently hitting the sand"
integer
デフォルト:5
Video duration (seconds)Supported range: 4 ~ 12 secondsDefault: 5
string
デフォルト:"16:9"
Video aspect ratioOptions:
  • 16:9 - Landscape
  • 9:16 - Portrait
  • 1:1 - Square
  • 4:3 - Traditional ratio
  • 3:4 - Vertical traditional ratio
  • 21:9 - Ultra-wide
Default: 16:9

Resolution and Aspect Ratio Combinations

string[]
Compatibility image URL array for first/last-frame image-to-video generationCompatibility rules:
  • 1 image: treated as first_frame
  • 2 images: treated as first_frame and last_frame
  • More than 2 images: only the first two are used
We recommend using image_with_roles to explicitly specify first and last framesExample: ["https://example.com/first.png", "https://example.com/last.png"]image_urls and image_with_roles cannot be used together
array
Image array with roles for explicit first/last-frame controlExample:
  • image_urls and image_with_roles cannot be used together
  • Only one first frame and one last frame are supported
  • 1.5 Pro does not support the reference_image role. Use Seedance 2.0 if you need reference image control
object
Extended parameters

Differences from 1.0

素材審査

画像を含むリクエストでは, 一部のチャネルが生成の送信前に画像を自動で審査します. 追加のパラメーターは不要で, 従来の画像フィールドに画像 URL を指定するだけです.
  • 受理されたリクエストはすぐに動画タスクを返します. 審査が必要な場合, タスクは queued のままとなり, リクエスト内の全素材が通過してから生成を送信します. 初回の審査には数分かかることがあります. 同じユーザーが同じチャネルで同じ URL を再利用すると審査結果も再利用されます.
  • 素材準備は 1 ラウンドあたり既定で最長 20 分です. 審査拒否または準備タイムアウトの場合, タスクは failed で終了し, 理由は error.message で確認できます. 審査を通過しなかった場合, 動画生成料金は発生しません.
  • 画像は公開 HTTP(S) URL で指定してください. Base64 とローカルパスは使えません. 画像は 20 MB 以内 (一部のチャネルは最大 30 MB) です. モデル本来の形式制限は変わりません.
  • 審査を行うチャネルは受理時に画像 URL を検証します. URL に認証情報が含まれる, または 2048 バイトを超える場合は, HTTP 400 (error.code は invalid_private_assets) を返します.
  • 素材は URL で識別されます. ファイル内容を変更した場合は新しい URL を使ってください.
  • 旧 asset:// 参照は廃止され, HTTP 400 を返します.

レスポンス

string
Unique task identifier for status queries
string
Object type, always generation.task
string
モデル name used
string
Task status
  • queued - Queued for processing
  • in_progress - Processing
  • completed - Successfully completed
  • failed - Failed
integer
Task progress percentage (0-100)
integer
Task creation timestamp (Unix timestamp)
object
Task metadata