mingyanmingyan
wechatwechat
mingyan

Seedance2.0 Special Price - Create Task

Create Seedance2.0 special-price video tasks

POST/kyyReactApiServer/v1/seedance-special/videos

Seedance2.0 Special Price Create Task

Use a full model code to create a video task. The model code includes model type, resolution, and whether video reference is used.

认证

获取 Key
cURL
Authorization: Bearer {{key}}

Request Parameters

modelstringrequired
Model name. When using a _with_video_ref model, content must include a video_url item with role=reference_video.
  • sd_2.0_special_720p
  • sd_2.0_special_1080p
  • sd_2.0_special_2k
  • sd_2.0_special_4k
  • sd_2.0_special_720p_with_video_ref
  • sd_2.0_special_1080p_with_video_ref
  • sd_2.0_special_2k_with_video_ref
  • sd_2.0_special_4k_with_video_ref
  • sd_2.0_fast_special_720p
  • sd_2.0_fast_special_720p_with_video_ref
sd_2.0_fast_special only supports 720p.
resolutionstring
Optional. The full model code already includes resolution. If provided, it must match the resolution in model.
ratiostring
Aspect ratio. Default: 16:9.
durationinteger
Duration in seconds. Default: 5. Range: 4-15.
generate_audioboolean
Whether to generate audio. Default: true.
return_last_frameboolean
Whether to return the last-frame image. Default: false. When set to true and the task generates a last frame, read last_frame_url from the query API.
toolsarray
Advanced tool configuration. Default: not sent. Supported tools depend on the enabled model capabilities.
seedinteger
Random seed. Default: -1, which lets the model service choose a random seed. A fixed value improves reproducibility, but generation is still probabilistic.
contentarrayrequired
Content array. One type=text prompt is required.
content[].rolestring
first_frame, last_frame, reference_image, reference_video, or reference_audio.
For real-person or avatar images, upload the asset first and reference it with assetId://{assetId}.

Response Parameters

idstring
Video task ID used to query task status and result.
objectstring
Object type, fixed as video.
createdinteger
Task creation timestamp.
modelstring
Model used by this request.
statusstring
Task status, usually queued or processing after creation.

Status

  • queued: the task has been created and is waiting to be processed.
  • processing: the task is being processed.
  • completed: the task succeeded and video_url is available from the query API.
  • failed: the task failed and error is available from the query API.

Request Body Example

Real-person reference
{
  "model": "sd_2.0_fast_special_720p",
  "ratio": "16:9",
  "duration": 4,
  "return_last_frame": true,
  "generate_audio": true,
  "content": [
    {
      "type": "text",
      "text": "A natural talking-head commercial, the person looks at the camera with a confident expression"
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "assetId://202607041749401700000000"
      }
    }
  ]
}
Multi-modal reference
{
  "model": "sd_2.0_fast_special_720p_with_video_ref",
  "ratio": "9:16",
  "duration": 5,
  "return_last_frame": true,
  "generate_audio": true,
  "tools": [
    {
      "type": "image_reference"
    }
  ],
  "content": [
    {
      "type": "text",
      "text": "A first-person fruit tea commercial using video 1 as the composition reference and audio 1 as background music"
    },
    {
      "type": "audio_url",
      "role": "reference_audio",
      "audio_url": {
        "url": "https://example.com/reference.mp3"
      }
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "https://example.com/reference.jpg"
      }
    },
    {
      "type": "video_url",
      "role": "reference_video",
      "video_url": {
        "url": "https://example.com/reference.mp4"
      }
    }
  ]
}