v1.0.0Estável

Z Image Turbo API

Integre capacidades de geração de imagens com IA de alto desempenho. Esta documentação fornece referência completa da API, guias de integração e exemplos de código para ajudar desenvolvedores a criar rapidamente aplicações de geração de imagens com IA.

Início rápido

Conclua sua primeira chamada à API em apenas duas etapas: envie uma tarefa de geração e, em seguida, consulte o status.

Enviar tarefa

Envie uma requisição POST para o endpoint de geração para obter um ID de tarefa.

Consultar status

Use o ID de tarefa para verificar o progresso até obter a URL da imagem.

Autenticação

Cabeçalho HTTP

Authorization: Bearer {YOUR_API_KEY}

Observação: mantenha sua chave de API segura e não a exponha em código do lado do cliente.

POST

https://zimageturbo.ai/api/generate

Create a new image generation task. This endpoint is asynchronous and returns a task_id plus initial status; call /api/status to retrieve the final images.

This endpoint responds immediately with task_id. Poll /api/status until the status becomes SUCCESS to obtain image URLs.

Parâmetros do corpo

Nome do parâmetro	Tipo	Obrigatório	Descrição
prompt	string	Sim	Text prompt for generation (max 1000 characters).
aspect_ratio	string	Sim	Aspect ratio for the generated image. Allowed values: 1:1, 4:3, 3:4, 16:9, 9:16.

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}

GET

https://zimageturbo.ai/api/status

Consulta o status de execução e os resultados de uma tarefa.

Parâmetros de consulta

Nome do parâmetro	Obrigatório	Descrição
task_id	Sim	O ID retornado ao enviar a tarefa.

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "xxx",
      "size": "1024*1024",
      "seed": "-1"
    },
    "response": [
      "https://xxx.com/sample.jpeg"
    ],
    "consumed_credits": 15,
    "created_at": "2025-12-05 13:05:09",
    "error_message": null
  }
}

Cobrança

Custo por geração

$0.02 / requisição

Tarefas com falha não são cobradas.

Tratamento de erros

401 UnauthorizedChave de API inválida
402 Payment RequiredSaldo insuficiente
429 Too Many RequestsMuitas requisições

Sobre o Z Image Turbo

Z Image Turbo é um mecanismo de geração otimizado com base nos modelos de difusão mais recentes. Ele foca em aumentar a velocidade de inferência para 300% em relação aos modelos tradicionais, mantendo uma fidelidade extremamente alta. Ideal para interação em tempo real, geração de assets para jogos e cenários de design para e-commerce.

Z-Image-Turbo — 6B-parameter, ultra-fast text-to-image

Z-Image-Turbo is a 6B-parameter text-to-image model from Tongyi-MAI, engineered for production workloads where latency and throughput really matter. It uses only 8 sampling steps to render a full image, achieving sub-second latency on data-center GPUs and running comfortably on many 16 GB VRAM consumer cards.

Ultra-fast generation with production-ready quality

Where many diffusion models need dozens of steps, Z-Image-Turbo is aggressively optimised around an 8-step sampler. That keeps inference extremely fast while still delivering photorealistic images and reliable on-image text, making it a strong fit for interactive products, dashboards, and large-scale backends—not just offline batch jobs.

Why it looks so good?

• Photorealistic output at speed — Generates high-fidelity, realistic images that work for product photos, hero banners, and UI visuals without multi-second waits.
• Bilingual prompts and text — Understands prompts in English and Chinese, and can render multilingual text directly in the image—helpful for cross-market campaigns, posters, and screenshots.
• Low-latency, low-step design — Only 8 function evaluations per image deliver extremely low latency, ideal for chatbots, configuration tools, design assistants, and any “click → image” experience.
• Friendly VRAM footprint — Runs well in 16 GB VRAM environments, reducing hardware costs and making local or edge deployments more realistic.
• Scales for bulk generation — Its efficiency makes large jobs—catalogues, continuous feed images, or auto-generated thumbnails—practical without blowing up compute budgets.
• Reproducible generations — A controllable seed parameter lets you recreate a previous image or generate small, controlled variations for brand safety and experimentation.

How to use

prompt – natural-language description of the scene, style, and any on-image text (English or Chinese).
size (width / height) – choose the output resolution; supports square and rectangular images up to high resolutions (for example, 1536 × 1536).
seed – set to -1 for random results, or use a fixed integer to make outputs reproducible.