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
boolean
기본값:false
선택 사항이며 기본값은 false입니다. true로 설정하면 선택된 채널의 지원 여부에 따라 소재를 준비하고 심사합니다. 비공개 소재 라이브러리가 없는 채널은 심사를 건너뛰고 기존 생성 흐름을 사용합니다.다음 필드에 미디어를 포함하는 비동기 생성 요청에 사용할 수 있습니다: image_urls, image_with_roles.텍스트만 있거나 metadata에만 소재를 지정한 요청에서는 생략하거나 false로 설정하세요. 별도의 remix 또는 extend API에는 적용되지 않습니다. true이면 asset://를 거부합니다. 모델의 기존 미디어 형식과 개수 제한은 그대로 적용됩니다. 요청 시 소재 심사를 참고하세요.
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

응답

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