Get Task Details
GET
/api/v1/jobs/recordInfo
Supported Models
z-image, seedream-v4-5, seedream-v5-lite, gemini-2.5-flash-image-preview, nano-banana-pro, nano-banana-pro-flash, imagen4-fast, imagen4-ultra, and flux-2-pro.Query Parameter
| Field | Type | Required | Notes |
|---|---|---|---|
taskId | string | Yes | The public taskId returned by POST /api/v1/jobs/createTask. |
Task States
| State | Meaning |
|---|---|
waiting | Task was submitted and is waiting for upstream processing. |
queuing | Task is queued locally or upstream. |
generating | Upstream is currently processing the task. |
success | Task completed successfully. Parse data.resultJson for resultUrls. |
fail | Task reached a terminal failure. Read failCode and failMsg. |
Response Fields
| Field | Type | Notes |
|---|---|---|
code | integer | HTTP-style business code. Successful queries return 200. |
msg | string | success for successful query responses. |
data.taskId | string | Public task ID. |
data.model | string | Original requested model name. |
data.state | string | One of waiting, queuing, generating, success, fail. |
data.param | string | Original createTask request serialized as JSON string. |
data.resultJson | string | Empty until success. On success it is a JSON string such as {\"resultUrls\":[\"https://...\"]}. |
data.failCode | string | Empty unless state is fail. |
data.failMsg | string | Empty unless state is fail. |
data.costTime | integer | Milliseconds between submit and finish; 0 until finished. |
data.completeTime | integer | Unix milliseconds; 0 until finished. |
data.createTime | integer | Unix milliseconds. |
data.updateTime | integer | Unix milliseconds. |
Callback Payload
callBackUrl, LiangXin posts the same code, msg, and data structure to that URL when the task reaches success or fail. Polling remains recommended as a fallback.Best Practices
taskId. Download or persist generated result URLs promptly because upstream/CDN retention is not guaranteed by this endpoint.Error Responses
400 means taskId is missing. 401 means the API key is missing or invalid. 403 means token/user access is denied. 404 means the task does not exist or does not belong to this API key's user. 500 means the server could not query or serialize the task.Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET '/api/v1/jobs/recordInfo?taskId={{taskId}}'Response Response Example
200 - 200 - Task details success
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_z-image_1777600000000",
"model": "z-image",
"state": "success",
"param": "{\"model\":\"z-image\",\"callBackUrl\":\"https://your-domain.com/api/callback\",\"input\":{\"prompt\":\"A cafe terrace\",\"image_size\":\"square_hd\"}}",
"resultJson": "{\"resultUrls\":[\"https://cdn.example.com/result.png\"]}",
"failCode": "",
"failMsg": "",
"costTime": 18000,
"completeTime": 1777600000000,
"createTime": 1777599982000,
"updateTime": 1777600000000
}
}Modified at 2026-05-01 06:34:47