Skip to main content
POST

Authorizations

string
required
All endpoints require Bearer Token authentication.Get the API Key:Visit API Key management page to get your API Key.Add the following to the request headers when using it:

Body

string
required
Model name.Fixed value: "z_image_turbo"
object
required
Model parameter object.
string
required
Caller-defined task ID, used for idempotent submission and result queries.
  • Length: 1-64 characters
  • Only letters, numbers, underscores, and hyphens are allowed
  • Cannot be reused under the same API Key
Z-Image Turbo only supports text-to-image. Reference images (image_url), image editing, resolution tiers (resolution), and batch image generation (output_n) are not supported; passing a custom pixel size size will directly return Model "z_image_turbo" does not support size parameter. Each request returns exactly 1 image. If you need multiple images, please submit multiple times with different seed values.If you need reference images, image-to-image, or a larger canvas, please use GPT-Image 2, Seedream 5.0 Pro, or Nano Banana Pro instead.

Response

string
The caller’s task ID, which can be used to query the result.
string
Initial status, fixed as "pending".
number
Estimated credit usage for this task.
string
Creation time, in ISO 8601 format.

Query Results

After submission succeeds, call with the same out_task_id:
Task statuses include pending, processing, completed, and failed. After the task is completed, the output image is located in data.output, and the actual credits used are in data.credits_used. If task generation fails, the system will automatically refund the pre-deducted credits for this task.