Referênciav1.0.0 Está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.

https://zimageturbo.ai

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

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

Cabeçalho HTTP

Authorization: Bearer {YOUR_API_KEY}

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.

Resposta (JSON)

{
  "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.

Exemplo de resposta

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.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 — modelo texto-para-imagem de 6B parâmetros, ultrarrápido

Z-Image-Turbo é um modelo texto-para-imagem de 6 bilhões de parâmetros da Tongyi-MAI, criado para workloads em produção em que latência e throughput são críticos. Ele utiliza apenas 8 etapas de amostragem para renderizar uma imagem completa, alcançando latência abaixo de um segundo em GPUs de data center e rodando confortavelmente em muitas placas de vídeo de 16 GB de VRAM para consumidores.

Geração ultrarrápida com qualidade pronta para produção

Enquanto muitos modelos de difusão precisam de dezenas de etapas, o Z-Image-Turbo é agressivamente otimizado em torno de um amostrador de 8 etapas. Isso mantém a inferência extremamente rápida, ao mesmo tempo em que entrega imagens fotorrealistas e texto confiável na imagem, tornando-o uma ótima opção para produtos interativos, dashboards e backends em larga escala — não apenas jobs em lote offline.

Por que as imagens ficam tão boas?

Saída fotorrealista em alta velocidade — Gera imagens de alta fidelidade e realistas que funcionam para fotos de produto, banners de destaque e visuais de interface sem esperas de vários segundos.
Prompts e texto bilíngues — Entende prompts em inglês e chinês e pode renderizar texto multilíngue diretamente na imagem — útil para campanhas globais, pôsteres e capturas de tela.
Baixa latência com poucas etapas — Apenas 8 avaliações de função por imagem oferecem latência extremamente baixa, ideal para chatbots, ferramentas de configuração, assistentes de design e qualquer experiência do tipo “clique → imagem”.
Uso amigável de VRAM — Roda bem em ambientes com 16 GB de VRAM, reduzindo custos de hardware e tornando mais viáveis implantações locais ou na borda.
Escala para geração em massa — Sua eficiência torna viáveis grandes jobs — catálogos, feeds contínuos de imagens ou miniaturas geradas automaticamente — sem estourar o orçamento de computação.
Gerações reprodutíveis — Um parâmetro de semente controlável permite recriar uma imagem anterior ou gerar pequenas variações controladas para segurança de marca e experimentação.

Como usar

promptprompt – descrição em linguagem natural da cena, estilo e qualquer texto na imagem (em inglês ou chinês).
sizesize (largura / altura) – escolha a resolução de saída; suporta imagens quadradas e retangulares em altas resoluções (por exemplo, 1536 × 1536).
seedseed – defina como -1 para resultados aleatórios ou use um inteiro fixo para tornar as saídas reprodutíveis.

Z-Image-Edit Prompts