Seedream4.5 - Text to Image
POST
/api/v1/jobs/createTask
Model Value
seedream-v4-5Request Body
| Field | Type | Required | Notes |
|---|---|---|---|
model | string | Yes | Must be seedream-v4-5. |
callBackUrl | string | No | Public HTTPS URL for final callback. |
input.prompt | string | Yes | Non-empty prompt. |
input.aspect_ratio | string | No | Defaults to square_1_1. Accepts 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 and Magnific aliases. |
input.seed | integer | No | Optional deterministic seed passed to upstream. |
input.enable_safety_checker | boolean | No | Optional upstream safety checker flag. |
input.aspect_ratio returns HTTP 400.Minimal Runnable Example
model and input.prompt are required. Add optional fields from the table above only when your use case needs them. To receive a webhook, add a top-level callBackUrl field with a public HTTPS URL.Query Task Status
GET /api/v1/jobs/recordInfo?taskId=... to retrieve progress and final results. For production usage, pass callBackUrl when creating the task and still keep polling as a fallback.Callback
callBackUrl is optional. When provided, LiangXin sends the same payload shape as recordInfo after the task reaches success or fail. Your server should return any 2xx status. Webhook delivery is retried briefly, but clients should not rely on webhooks only.Response And Error Format
200 and a public taskId. Store this ID and query it with GET /api/v1/jobs/recordInfo.{
"code": 400,
"msg": "input.prompt is required",
"data": null
}{
"error": {
"message": "invalid token",
"type": "new_api_error",
"code": ""
}
}400 invalid request, missing model, unsupported model, invalid model parameter, or price not configured; 401 invalid or missing API key; 403 insufficient quota or access denied; 413 request body too large; 422 upstream validation rejected the request; 429 current group/upstream load is saturated; 500 upstream or internal task error.Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST '/api/v1/jobs/createTask' \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "seedream-v4-5",
"input": {
"prompt": "A cinematic product photo of a premium tea bottle on a stone table, natural morning light"
}
}'Response Response Example
200 - 200 - Task accepted
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_seedream-v4-5_1777600000000"
}
}Modified at 2026-05-01 06:34:47