Skip to main content
POST
中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。
  • ByteDance Doubao video generation model
  • Use model parameter to select doubao-seedance-1-0-pro-fast or doubao-seedance-1-0-pro-quality model
  • Supports text-to-video generation
  • Supports first frame / last frame / reference image control
  • Async task management, query results by task ID
Important Change: For better performance and cost control, we no longer support passing base64 image data directly in image_urls. Please use the Upload 画像API first to upload images and get URLs, then call this endpoint.

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-0-pro-fast"
必須
Video generation model nameAvailable models:
  • doubao-seedance-1-0-pro-fast - Fast version (40-90 seconds generation)
  • doubao-seedance-1-0-pro-quality - Quality version (90-300 seconds generation)
boolean
デフォルト:false
省略可能、既定値は false。true にすると、選択されたチャネルの対応状況に応じて素材を準備して審査します。プライベート素材ライブラリ非対応のチャネルでは審査を省略し、従来の生成処理を行います。次のフィールドにメディアを含む非同期生成リクエストで使用できます:image_urls、image_with_roles。テキストのみ、またはmetadataのみに素材を指定する場合は省略するか false にしてください。独立した remix または extend API には適用されません。true の場合は asset:// を拒否します。モデルのメディア形式と数量制限は変わりません。詳細はオンデマンド素材審査を参照してください。
string
必須
Video content descriptionDescribe scenes, actions, styles 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: 2 ~ 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
string
デフォルト:"720p"
Video resolutionOptions:
  • 480p - Standard definition
  • 720p - High definition
  • 1080p - Full HD
Default: 720p1080p Limitation: When using reference images (role: reference in image_with_roles), 1080p resolution is not supported

Resolution and Aspect Ratio Combinations

string[]
First frame image URL array for image-to-video generation⚠️ URL format only (base64 no longer supported)
  • Publicly accessible image URL (http:// or https://)
  • You can use the Upload 画像API to upload local images and get URLs
Example: ["https://example.com/cat.png"]image_urls and image_with_roles cannot be used together
array
Image array with roles for more precise controlExample:
  • image_urls and image_with_roles cannot be used together
  • Only one image per role is supported
  • last_frame is only supported by doubao-seedance-1-0-pro-quality version, fast version does not support first and last frame together
object
Extended parameters (optional)

レスポンス

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