API Z-Image para Geração de Texto para Imagem de Baixo Custo

Gere imagens através de POST https://api.goenhance.ai/api/v1/images/generations com model: z-image. O Z-Image custa um valor fixo de $0,004 (0,2 tokens) por imagem — o menor preço por imagem no catálogo de imagens da GoEnhance — e retorna um img_uuid assíncrono para polling ou callbacks.
Criar uma Chave de API
Uma cena de estúdio criativo cinematográfico representando a geração de texto para imagem do Z-Image

Uma API Focada em Texto para Imagem

Geração Focada em Prompt

Use o campo obrigatório prompt (1–2000 caracteres) para descrever a imagem. O endpoint unificado atual requer model: z-image.
Um visual imaginativo de cena única mostrando um prompt detalhado se tornando uma imagem finalizada

Preço Fixo de $0,004 por Imagem

Cada geração do Z-Image custa 0,2 tokens, equivalente a $0,004. Não há níveis de resolução ou volume neste modelo, o que torna a estimativa de custo simples.
Uma configuração de produção de cena única refinada representando geração eficiente de imagens em escala
Use apenas os campos suportados pelo esquema de requisição <code>z-image</code>.

Parâmetros e Capacidades da API Z-Image

ID Exato do Modelo

Defina model exatamente como z-image. O nome do produto na página permanece Z-Image.

Prompt Obrigatório

Forneça um prompt não vazio de 1 a 2000 caracteres descrevendo a imagem a ser gerada.

Sete Proporções de Aspecto

Escolha exatamente uma entre 1:1, 2:3, 3:2, 4:3, 3:4, 16:9 ou 9:16. Omita ratio para usar o padrão do modelo.

Callback Opcional

Defina custom_callback_url para um endpoint HTTPS público para receber atualizações de processamento, sucesso e falha.

Apenas Texto para Imagem

Esta rota não aceita imagens de referência ou entradas de edição. Use outro modelo de imagem da GoEnhance quando seu fluxo de trabalho precisar de edição baseada em referência.

Validação de Esquema

Proporções não suportadas são rejeitadas durante a validação de esquema antes que os tokens sejam deduzidos. Não existe proporção auto ou 21:9 para o Z-Image.
Uma tarifa única torna fácil calcular o orçamento de uma API de geração de imagens por IA econômica.

Preços Simples e Fixos para Z-Image

$0,004 por Imagem

Cada geração bem-sucedida é precificada exatamente em $0,004 por imagem.

0,2 Tokens por Imagem

A mesma cobrança é de 0,2 tokens. Os tokens da GoEnhance são precificados em $10 por 500 tokens, ou $0,02 por token.

Sem Níveis de Resolução ou Volume

O Z-Image possui um nível fixo por imagem. A requisição não expõe um parâmetro de resolução, e a taxa publicada não muda por volume.

Integre o Z-Image em Três Passos

1

1. Envie um Prompt

Envie um POST autenticado para https://api.goenhance.ai/api/v1/images/generations com {"model":"z-image","prompt":"...","ratio":"16:9"}.
2

2. Salve o img_uuid

Uma submissão bem-sucedida retorna data.img_uuid. Armazene-o com o registro da sua aplicação em vez de aguardar a imagem de forma síncrona.
3

3. Faça o Polling ou Receba um Callback

Faça o polling de GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=..., ou registre uma custom_callback_url para lidar com estados de processamento, sucesso e falha.
Crie uma Chave de API
Use o Z-Image onde o custo previsível por imagem e um formato de solicitação compacto são importantes.

Onde uma API de Texto-para-Imagem de Baixo Custo se Encaixa

Ilustrações de Conteúdo

Gere conceitos visuais para artigos, guias e fluxos de trabalho editoriais a partir de prompts de texto.

Conceituação de Produtos

Crie direções visuais iniciais para produtos, embalagens, ambientes ou temas de campanha antes da produção.

Exploração Criativa de Anúncios

Produza conceitos distintos baseados em prompts para revisão criativa, rastreando um custo fixo por imagem gerada.

Pipelines Visuais Localizados

Adapte prompts para temas e formatos regionais enquanto seleciona uma proporção compatível de paisagem, retrato ou quadrada.

Geração de Fundo

Gere fundos de cena e ativos atmosféricos para fluxos de trabalho de design posteriores que não requerem edição de referência.

Prototipagem de Alto Volume

Use a tarifa fixa de $0,004 para estimar o custo de geração de protótipos sem cálculos de resolução ou níveis de volume.
Detalhes de integração para desenvolvedores que avaliam uma API de texto para imagem de baixo custo.

Perguntas frequentes da API Z-Image

Qual endpoint devo usar para a API Z-Image?

Use POST https://api.goenhance.ai/api/v1/images/generations e defina model como z-image. Uma rota legada POST /api/v1/z-image também existe, mas o endpoint de imagem unificado é o caminho de integração documentado atual.

Por que algumas pesquisas usam o nome Turbo?

Alibaba/Tongyi refere-se ao modelo upstream como Z-Image Turbo. No catálogo e na documentação da API da GoEnhance, o nome do produto é Z-Image e o ID exato do modelo é z-image.

Quanto custa uma geração Z-Image?

O preço fixo é de $0,004 por imagem, equivalente a 0,2 tokens. Não há níveis de resolução ou níveis de volume para este modelo.

Quais proporções o Z-Image suporta?

Exatamente sete: 1:1, 2:3, 3:2, 4:3, 3:4, 16:9 e 9:16. A rota não aceita auto ou 21:9.

Posso enviar uma imagem de referência ou editar uma imagem existente?

Não. O Z-Image nesta rota é apenas de texto para imagem e não aceita imagens de referência, entradas de imagem para imagem ou solicitações de edição. Escolha um modelo diferente da GoEnhance para edição baseada em referência.

Posso solicitar uma resolução ou várias imagens em uma única chamada?

Não. O esquema do Z-Image não possui campo de resolução nem parâmetro n ou de contagem de lote. Envie solicitações de geração separadas quando precisar de múltiplas saídas.

Como os trabalhos assíncronos do Z-Image são concluídos?

A resposta da geração retorna img_uuid. Faça o polling de /api/v1/jobs/detail?img_uuid=... ou forneça custom_callback_url para receber mudanças de status.

A GoEnhance é afiliada ao Alibaba?

Não. O Z-Image é originário da organização Tongyi/Qwen do Alibaba. A API Aberta GoEnhance é uma plataforma independente de terceiros e não é afiliada nem endossada pelo Alibaba.

Comece a desenvolver com a API Z-Image