Skip to main content
POST

Modelos suportados

Autorização

string
obrigatório
Todos os endpoints exigem autenticação por Bearer TokenObtenha sua chave de API:Acesse o gerenciamento de chaves de API para obter sua chave de APIAdicione-a ao cabeçalho da requisição:

Corpo da requisição

string
obrigatório
Nome do modelo
  • z-image-turbo - Geração de imagens leve e rápida, com suporte a chinês e inglês
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de imagem.
  • true: verificar prompts e imagens de entrada com omni-moderation-latest
  • false ou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
string
obrigatório
Descrição textual para a geração da imagem, até 800 caracteres
string
padrão:"1:1"
Proporção da imagemProporções suportadas:
  • 1:1 - Quadrado (padrão)
  • 4:3 - Paisagem 4:3
  • 3:4 - Retrato 3:4
  • 16:9 - Paisagem widescreen
  • 9:16 - Retrato vertical
  • 3:2 - Paisagem 3:2
  • 2:3 - Retrato 2:3
string
padrão:"1K"
Nível de resolução
  • 1K - Resolução padrão (padrão)
  • 2K - Resolução de alta definição
boolean
padrão:"false"
Reescrita inteligente de promptsQuando ativada, a IA otimizará automaticamente o prompt para obter melhores resultados, e os custos aumentarão.
  • false - Desativada (padrão)
  • true - Ativada

Tabela de referência de resoluções

O tamanho da saída é controlado pela combinação size (proporção) + resolution (nível de resolução).

Exemplos de uso

Text-to-Image básico (requisição mínima)
Especificar proporção e resolução
Ativar reescrita inteligente de prompts

Resposta

integer
Código de status da resposta
array
Array de dados da resposta

Observações

  1. Processamento assíncrono: após o envio, um task_id é retornado. Consulte /v1/tasks/{task_id} para obter os resultados
  2. Armazenamento de imagens: as imagens geradas são espelhadas no CDN da plataforma e ficam válidas por longo prazo
  3. Regras de cobrança: cobrado por imagem gerada com sucesso, sem cobrança em caso de falha
  4. Quantidade fixa: o Z-Image-Turbo gera exatamente 1 imagem por requisição; o parâmetro n não é suportado