Z-Image

POST

/api/v1/jobs/createTask

Photorealistic Z-Image generation through LiangXin unified asynchronous image tasks.

Query Task Status

After submitting a task, use the unified query endpoint to check progress and retrieve results:

Get Task Details

Learn how to query task status and retrieve generation results

For production use, we recommend using the callBackUrl parameter to receive automatic notifications when generation completes, while still keeping GET /api/v1/jobs/recordInfo polling as a fallback.

Market Overview

Explore all available LiangXin image models

Task Status API

Query task state, failures, and final result URLs

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200200 - Request successful

application/json

Task submitted successfully. Use data.taskId to query task progress or correlate callback events.

Body

🔴500500 - Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v1/jobs/createTask' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "z-image",
  "callBackUrl": "https://your-domain.com/api/callback",
  "input": {
    "prompt": "Generate a photorealistic image of a cafe terrace in Paris on a crisp spring morning",
    "image_size": "square_hd",
    "seed": 12345,
    "num_inference_steps": 28,
    "output_format": "png",
    "enable_safety_checker": true
  }
}'

Response Example

200 - 200 - Request successful

The task was accepted and can be queried by taskId.

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_z_image_1765166238716"
  }
}

Modified at 2026-05-01 14:34:15

Seedream5.0 Lite - Edit Image

Google - Gemini 2.5 Flash Image Preview

Z-Image

Query Task Status#

Related Resources#

Request

Responses

Query Task Status

Related Resources