Model CenterMaiopc

sd_2.0_discount

POST/kyyReactApiServer/v2/model-center/tasks

Compatible APIs

This page documents the standard V2 Model Center API and its parameters. For official-protocol compatible APIs below, open the corresponding page for connection instructions; refer to the model provider’s official documentation for submission parameters, query parameters, and responses.

Asset libraries

Usage note: To avoid task failures caused by image, video, or audio review, upload assets to the asset library before using them in generation requests.

Model information

Field	Value
Model ID (`model`)	`sd_2.0_discount`
Model type	Video models
Set the request `model` field to the Model ID shown above. Using the model name will fail to resolve the model.

Authentication

Get Key

All requests must include a Bearer token in the request headers:

cURL

Authorization: Bearer <API_KEY>

Request parameters

Send the following fields in the JSON request body. model is required — use the Model ID from the Model information section above.

promptstringrequired

Prompt

Text prompt input.

Minimum：1

reference_imagesimage[]

Reference images

参考图

Range：0 – 9

Items：0 - 9

Provide a publicly accessible resource URL.

reference_videosvideo[]

Reference videos

Reference video inputs.

Range：0 – 3

Items：0 - 3

Provide a publicly accessible resource URL.

reference_audiosaudio[]

Reference audios

Reference audio inputs.

Range：0 – 3

Items：0 - 3

Provide a publicly accessible resource URL.

durationintegerrequired

Duration

Generated video duration.

Range：4 – 15

Default：5

aspect_ratiostring

Aspect ratio

Output aspect ratio.

Allowed values：16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive

Default：16:9

resolutionstring

Resolution

Output resolution tier.

Allowed values：480p, 720p, 1080p, 4k

Default：720p

seedinteger

Seed

Deterministic generation seed.

Default：-1

first_imageimage[]

First frame

First-frame image input.

Range：0 – 1

Items：0 - 1

Provide a publicly accessible resource URL.

last_imageimage[]

Last frame

Last-frame image constraint.

Range：0 – 1

Items：0 - 1

Provide a publicly accessible resource URL.

callback_urlstring

回调地址。当前字段会被接收，具体回调行为以后端实现为准。

camera_fixedboolean

是否固定镜头。

draft_taskobject

草稿任务引用。结构：{"id":"..."}。

execution_expires_afterinteger

任务过期时间，单位秒。

external_task_idstring

调用方业务任务 ID，用于调用方侧关联和排查。建议传入且保证业务唯一。

framesinteger

生成帧数。

generate_audioboolean

Generate audio

Whether to generate an audio track.

Default：true

priorityinteger

任务优先级。

return_last_frameboolean

是否要求返回尾帧。查询结果中的 lastFrameUrl 用于读取尾帧地址。

safety_identifierstring

终端用户安全标识。

service_tierstring

服务等级。

toolsarray

Prompt

官方工具配置

watermarkboolean

Watermark

Whether to add provider or platform watermark.

Default：false

Asset and Scenario Limits

Prompt text: Chinese prompts should be no more than 500 characters; English prompts should be no more than 1000 words.
Image input: supports jpeg, png, webp, bmp, tiff, gif, heic, and heif; each image must be under 30 MB, aspect ratio must be within (0.4, 2.5), and width/height must be within (300px, 6000px).
Image count: first-frame scenario supports 1 image; first/last-frame scenario supports 2 images; multimodal reference scenario supports 1-9 images.
Video input: supports mp4 and mov; each video duration must be [2, 15] seconds, up to 3 reference videos are allowed, total video duration must not exceed 15 seconds, each video must be under 50 MB, and frame rate must be [24, 60].
Audio input: supports wav and mp3; each audio duration must be [2, 15] seconds, up to 3 reference audio files are allowed, total audio duration must not exceed 15 seconds, and each audio file must be under 15 MB.
Scenario exclusivity: first-frame, first/last-frame, and multimodal reference scenarios (reference image, video, audio) cannot be mixed. Audio cannot be submitted alone and must include at least 1 reference image or video.
The current system does not support base64 input for image/audio. Use public URLs or the assetId returned by the asset upload API.

This model group supports the Seedance2.0 asset library. API users should call the asset upload API to obtain an assetId, wait for review to pass, then use assetId://{assetId} in media URL fields.

Response contract

Task status is normalized to queued, processing, completed, or failed. Result URLs are returned only when status is completed;

Field	Description
`id`	Task ID used to poll status and results.
`object`	Resource type, usually `video` for this model.
`created`	Task creation time as a Unix timestamp in seconds.
`model`	Model name used for this request.
`status`	`queued`, `processing`, `completed`, or `failed`.
`progress`	Task progress, usually returned by the query API.
`result_url`	Generic result URL, returned only after completion.
`video_url`	Typed result URL for this resource, returned only after completion.
`amount`	Credits consumed by this task.
`actualDuration`	Duration used by this task.
`upstream_url`	Upstream original URL.
`upstream_urls`	Upstream original URL list.
`task_id`	Additional result field exposed by model configuration.
`media_url`	Additional result field exposed by model configuration.
`error_message`	Additional result field exposed by model configuration.
`last_frame_url`	Additional result field exposed by model configuration.
`official_result`	Additional result field exposed by model configuration.
`usage.total_tokens`	Additional result field exposed by model configuration.
`error`	Error message on failure; usually `null` while queued, processing, or completed.

Query task result

Generation tasks run asynchronously. The submit endpoint returns a task id; poll the query endpoint below with that id until status becomes completed or failed.

http

GET https://zcbservice.aizfw.cn/kyyReactApiServer/v2/model-center/tasks/{id}
Authorization: Bearer <API_KEY>

idstringrequired

The task ID returned by the submit endpoint.

When status is completed, the result URL is returned via result_url and video_url. See the Response contract above for the remaining fields. Completed tasks may also return upstream_url / upstream_urls.

Poll every 5–10 seconds and stop once status is completed or failed. Result URLs expire, so download and store them promptly.