Model Centermingyan

seedream-5.0

POST/kyyReactApiServer/v2/model-center/tasks

Model information

Field	Value
Model ID (`model`)	`seedream-5.0`
Model type	Image 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 – 10

Items：0 - 10

Provide a publicly accessible resource URL.

aspect_ratiostring

Aspect ratio

Output aspect ratio.

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

Default：1:1

resolutionstring

Resolution

Output resolution tier.

Allowed values：2K, 3K, 4K

Default：2K

watermarkboolean

Watermark

Whether to add provider or platform watermark.

Default：false

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 `image` 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.
`image_url`	Typed result URL for this resource, returned only after completion.
`amount`	Credits consumed by this task.
`actualDuration`	Duration used by this task.
`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 image_url. See the Response contract above for the remaining fields.

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