Skip to main content
← Z-Image Turbo Endpoint: POST https://api.higgsfield.ai/z-image/turbo Endpoint ID: z-image/turbo ▶Open API PlaygroundZ-Image Turbo · Generate↗

Usage notes

  • Text-to-image only. prompt must contain non-whitespace text and at most 800 characters.
  • prompt_extend defaults to false; enabling it uses the enhanced pricing tier.
  • The schema accepts 1k and 2k tiers, ten aspect ratios, and an optional integer seed from 0 to 2147483647.

Quick start

Input schema

integer
Optional random seed for similar, reproducible results. Minimum: 0. Maximum: 2147483647.
string
required
Positive prompt describing the desired content, style, and composition. Minimum characters: 1. Maximum characters: 800.
string
default:"1k"
Output resolution tier. Both tiers produce PNG images. Allowed values: "1k", "2k".
string
default:"1:1"
Output aspect ratio. Exact provider-recommended dimensions are selected automatically. Allowed values: "1:1", "2:3", "3:2", "3:4", "4:3", "7:9", "9:7", "9:16", "16:9", "21:9".
boolean
default:"false"
Rewrite and reason over the prompt before generation; this uses the enhanced price tier.

Response

Submission returns a request handle. Poll status_url until status is completed, or use webhooks.
Accepted
A completed response includes the following output fields:
See idempotent requests, polling, request errors and authentication for shared request handling.