Skip to main content
POST
/
kyyReactApiServer
/
v1
/
kyyvideo2
/
videos
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/kyyvideo2/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance_2_0",
    "prompt": "A cat dancing in the rain, cinematic style",
    "duration": 10,
    "aspect_ratio": "16:9",
    "generateAudio": true
  }'

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "seedance_2_0_fast",
  "status": "queued",
  "error": null
}

​
Seedance2.0 Create Video Task

Create high-quality video generation tasks using Seedance2.0’s advanced AI models with support for multiple model options and multimodal reference inputs.

​
Authentication

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

​
Request Parameters

​
model
string
required
Model name, available options:
  • seedance_2_0 - Standard model (only supports generation with reference videos)
  • seedance_2_0_fast - Fast model (only supports generation with reference videos)
  • seedance_2_0_pro - Pro model (optional reference videos)
  • seedance_2_0_fast_pro - Fast Pro model (optional reference videos)
​
prompt
string
required
Video generation prompt describing the desired video contentExample: "A cat dancing in the rain, cinematic style"
​
duration
integer
Video duration in seconds, default 5 seconds, range 4-15 seconds
​
first_image
string
First frame image URL for image-to-video scenariosUse Cases:
  • Standalone: Image-to-video with first frame
  • Combined with last_image: First and last frame scenario
Format Requirements:
  • Format: jpeg, png, webp, bmp, tiff, gif
  • Aspect ratio (width/height): 0.4 ~ 2.5
  • Size: 300-6000 px
  • Value type: Public URL or asset ID (asset://assetID)
Mutually exclusive with referenceImages/referenceVideos/referenceAudios
​
last_image
string
Last frame image URL for first and last frame scenarioFormat Requirements:
  • Format: jpeg, png, webp, bmp, tiff, gif
  • Aspect ratio (width/height): 0.4 ~ 2.5
  • Size: 300-6000 px
  • Value type: Public URL or asset ID (asset://assetID)
Must be used together with first_image
​
aspect_ratio
string
Output video aspect ratio, default 16:9Available options:
  • 16:9 - Landscape
  • 4:3 - Standard
  • 1:1 - Square
  • 3:4 - Portrait
  • 9:16 - Portrait
  • 21:9 - Ultra-wide
  • adaptive - Adaptive
​
generateAudio
boolean
Whether to generate synchronized audio, default true
  • true: Output video includes synchronized audio
  • false: Output video is silent
​
referenceAudios
array
Multimodal reference audio listFormat Requirements:
  • Format: wav, mp3
  • Duration: Single audio 2-15 seconds, max 3 segments, total duration ≤ 15 seconds
  • Size: Single ≤ 15 MB
  • Value type: Public URL or asset ID (asset://assetID)
Mutually exclusive with first_image/last_image
​
referenceImages
array
Multimodal reference image listFormat Requirements:
  • Quantity: 1-9 images
  • Format: jpeg, png, webp, bmp, tiff, gif
  • Aspect ratio (width/height): 0.4 ~ 2.5
  • Size: 300-6000 px
  • Value type: Public URL or asset ID (asset://assetID)
Images involving faces or virtual avatars must be uploaded to the asset library for review first
Mutually exclusive with first_image/last_image
​
referenceVideos
array
Multimodal reference video listFormat Requirements:
  • Resolution: 480p, 720p
  • Duration: Single video 2-15 seconds, max 3 videos, total duration ≤ 15 seconds
  • Aspect ratio (width/height): 0.4 ~ 2.5
  • Size: 300-6000 px
  • Value type: Public URL or asset ID (asset://assetID)
System automatically selects the optimal backend model
Mutually exclusive with first_image/last_image

​
Response Parameters

​
id
string
Unique identifier for the video generation task, used for subsequent status queries
​
object
string
Object type, always video
​
created
integer
Task creation timestamp
​
model
string
Model name used
​
status
string
Task status:
  • queued - Queued
  • processing - Processing
  • completed - Completed
  • failed - Failed
​
error
string
Error message, returned when status is failed

​
Model Features

seedance_2_0

Standard model, only supports generation with reference videos

seedance_2_0_fast

Fast model, only supports generation with reference videos, faster generation speed

seedance_2_0_pro

Pro model, optional reference videos, higher quality

seedance_2_0_fast_pro

Fast Pro model, optional reference videos, balances speed and quality

​
Parameter Selection Rules

Mutually Exclusive Parameters:
  • First/Last Frame Scenario: When using first_image and last_image, cannot use referenceImages, referenceVideos, referenceAudios
  • Multimodal Reference: When using referenceImages, referenceVideos, referenceAudios, cannot use first_image, last_image

​
Model Feature Comparison

ModelReference Video SupportGeneration SpeedVideo Quality
seedance_2_0✅ Only with reference videosStandardStandard
seedance_2_0_fast✅ Only with reference videosFastStandard
seedance_2_0_pro⭕ Optional reference videosStandardHigh Quality
seedance_2_0_fast_pro⭕ Optional reference videosFastHigh Quality
Best Practices:
  1. Video generation is asynchronous, use the returned id to query task status and results
  2. Clearly describe desired visual effects and style in the prompt
  3. Choose the appropriate model based on needs: select standard or fast models when reference videos are needed, choose Pro models for quality
  4. Reference images involving faces must be uploaded to the asset library for review first
  5. Set reasonable video duration (4-15 seconds), shorter duration generates faster
Prompt Suggestions:
  • Include specific scene descriptions
  • Add style keywords (e.g., “cinematic style”, “artistic style”, “realistic style”)
  • Describe actions and movement patterns
  • Specify lighting and color preferences
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/kyyvideo2/videos \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance_2_0",
    "prompt": "A cat dancing in the rain, cinematic style",
    "duration": 10,
    "aspect_ratio": "16:9",
    "generateAudio": true
  }'

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "seedance_2_0_fast",
  "status": "queued",
  "error": null
}