mingyanmingyan
wechatwechat
mingyan

Seedance X1 - Create Task

Create Seedance X1 video generation tasks with first-frame, first/last-frame, and multimodal reference inputs

POST/kyyReactApiServer/v1/seedance-x1/videos

Seedance X1 Create Video Task

Create a Seedance X1 video generation task. The request body uses the content[] structure and supports text prompts, images, videos, and audio references.

Authentication

Get Key
All requests require a Bearer token in the request header:
cURL
Authorization: Bearer {{key}}

Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl is the shared prefix for all public APIs. The api field in the current page frontmatter shows the full endpoint. Use this baseUrl as the common prefix when reading or composing request paths.

Request Parameters

modelstringrequired
User-facing model name. Available values:
  • seedance_2_0_x1_official
  • seedance_2_0_x1_discount
  • seedance_fast_2_0_x1_official
  • seedance_fast_2_0_x1_discount
resolutionstring
Output resolution. Default: 720p
Available values:
  • 480p
  • 720p
  • 1080p
ratiostring
Output aspect ratio. Default: 16:9
Available values:
  • 21:9
  • 16:9
  • 4:3
  • 1:1
  • 3:4
  • 9:16
durationinteger
Video duration in seconds. Default: 5, range: 4-15
contentarrayrequired
Content list. It must include one type=text prompt item and at least one image or reference asset.
content[].typestringrequired
Content type. Available values:
  • text
  • image_url
  • video_url
  • audio_url
content[].textstring
Text prompt. Required when content[].type=text.
content[].rolestring
Semantic role of the media item.
image_url supports:
  • first_frame
  • last_frame
  • reference_image
video_url supports:
  • reference_video
audio_url supports:
  • reference_audio
content[].image_url.urlstring
Image URL or asset ID. Required when content[].type=image_url.
A single image without role is treated as the first-frame image.
content[].video_url.urlstring
Video URL or asset ID. Required when content[].type=video_url.
content[].audio_url.urlstring
Audio URL or asset ID. Required when content[].type=audio_url.

Response Parameters

idstring
Unique video generation task ID for later status queries
objectstring
Object type, always video
createdinteger
Task creation timestamp
modelstring
User-facing model name used for the request
statusstring
Task status:
  • queued - Queued
  • processing - Processing
  • completed - Completed
  • failed - Failed
errorstring
Error message returned when creation fails

Parameter Rules

content composition rules:
  • content must include a type=text prompt item
  • Text-only generation is not supported; provide at least one image or reference asset
  • last_frame must be used together with first_frame
  • First/last-frame mode cannot be mixed with reference_image, reference_video, or reference_audio
  • reference_audio cannot be used alone; it must be combined with reference_image or reference_video
The following top-level fields are not supported: callback_url, priority, safety_identifier, service_tier, execution_expires_after, tools, generate_audio, return_last_frame, seed, and watermark.

Models

ModelDescriptionResolutions
seedance_2_0_x1_officialStandard series480p, 720p, 1080p
seedance_2_0_x1_discountStandard discount series480p, 720p, 1080p
seedance_fast_2_0_x1_officialFast series480p, 720p, 1080p
seedance_fast_2_0_x1_discountFast discount series480p, 720p, 1080p