Modelo leve de texto para imagem com geração rápida, renderização de texto em chinês e inglês e resoluções flexíveis.
Exemplos
Prompt de entrada | Imagem de saída |
|---|---|
Photo of a stylish young woman with short black hair standing confidently in front of a vibrant cartoon-style mural wall. She wears an all-black outfit: a puffed bomber jacket with a ruffled collar, cargo shorts, fishnet tights, and chunky black Doc Martens, with a gold chain dangling from her waist. The background features four colorful comic-style panels: one reads “GRAND STAGE” and includes sneakers and a Gatorade bottle; another displays green Nike sneakers and a slice of pizza; the third reads “HARAJUKU st” with floating shoes; and the fourth shows a blue mouse riding a skateboard with the text “Takeshita WELCOME.” Dominant bright colors include yellow, teal, orange, pink, and green. Speech bubbles, halftone patterns, and playful characters enhance the urban street-art aesthetic. Daylight evenly illuminates the scene, and the ground beneath her feet is white tiled pavement. Full-body portrait, centered composition, slightly tilted stance, direct eye contact with the camera. High detail, sharp focus, dynamic framing. | ![]() |
Visão geral do modelo
Nome do modelo | Descrição | Especificações da imagem de saída |
|---|---|---|
z-image-turbo | Modelo leve e rápido para geração de imagens | Resolução da imagem: de 512×512 a 2048×2048 pixels. Consulte as resoluções recomendadas nas configurações do parâmetro size. Formato da imagem: png Quantidade de imagens: fixa em 1. |
Pré-requisitos
Crie uma chave de API e defina a chave de API como variável de ambiente.
Chamada HTTP síncrona
Singapore:POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Beijing:POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Substitua {WorkspaceId} pelo seu ID do workspace real.
Parâmetros da solicitação |
Este exemplo retorna uma imagem diretamente para acelerar a resposta. Para ativar a reescrita inteligente, defina prompt_extend=true. Nesse caso, o sistema retorna o prompt otimizado, o raciocínio e a imagem, o que aumenta o tempo de resposta. |
Cabeçalhos da solicitação | |
Content-Type string (Obrigatório)Tipo de conteúdo da solicitação. Use application/json. | |
Authorization string (Obrigatório)Autentica a solicitação com uma chave de API do Model Studio. Exemplo: Bearer sk-xxxx. | |
Corpo da solicitação | |
model string (Obrigatório)Nome do modelo: z-image-turbo. | |
input object (Obrigatório)Conteúdo de entrada.
Propriedades messages array (Obrigatório)Array de conteúdo da solicitação. Apenas turno único: informe um conjunto de role e content. Não há suporte para múltiplos turnos.
Propriedades role string (Obrigatório)Função da mensagem: user.contentarray (Obrigatório)Array de conteúdo da mensagem. Deve conter um objeto de texto.
Propriedades text string(Obrigatório)Prompt positivo que descreve o conteúdo, o estilo e a composição desejados.Suporta chinês e inglês. Limite de 800 caracteres (cada caractere, letra, número ou símbolo conta como um). O sistema trunca caracteres excedentes.Exemplo: Um gato laranja sentado com expressão feliz, animado e fofo, realista e preciso.Nota: Há suporte para apenas um objeto de texto. Informar zero ou múltiplos objetos de texto resulta em erro. | |
parameters object (Opcional)Parâmetros de geração de imagem.
Propriedades size string (Opcional)Resolução da imagem de saída no formato largura×altura.
Resoluções recomendadas para um total de 1024*1024 pixels:
Resoluções recomendadas para um total de 1280*1280 pixels:
Resoluções recomendadas para um total de 1536*1536 pixels:
bool (Opcional)Ativa a reescrita inteligente de prompts via otimização LLM e saída de raciocínio.
integer (opcional)Semente de número aleatório. Intervalo válido: [0,2147483647].Usar o mesmo seed gera saídas semelhantes. Se omitido, o algoritmo usa uma semente aleatória.Nota: A geração de imagens é probabilística. Mesmo com o mesmo seed, os resultados podem variar. |
Parâmetros da resposta |
Os dados da tarefa (status e URLs das imagens) ficam retidos por apenas 24 horas e depois são removidos automaticamente. Salve as imagens geradas imediatamente. |
output objectSaída do modelo.
Propriedades choices arrayConteúdo de saída do modelo. O array contém um elemento.
Propriedades finish_reason stringMotivo da conclusão. O valor stop indica sucesso.message objectMensagem de resposta do modelo.
Propriedades role stringFunção da mensagem. O valor é assistant.contentarray
Propriedades image stringURL da imagem gerada (PNG). Válida por 24 horas. Baixe-a imediatamente.text stringRetorna o prompt de entrada (prompt_extend=false) ou o prompt reescrito (prompt_extend=true).stringProcesso de raciocínio do modelo. Retornado apenas quando prompt_extend=true. | |
usage objectInclui estatísticas de uso apenas para gerações bem-sucedidas.
Propriedades width integerLargura da imagem gerada (pixels).height integerAltura da imagem gerada (pixels).image_count integerNúmero de imagens geradas: 1.input_tokens integerTokens de entrada (0 quando prompt_extend=false).output_tokens integerTokens de saída (0 quando prompt_extend=false).output_tokens_detailsobjectDetalhes dos tokens de saída (apenas quando prompt_extend=true).
Propriedades reasoning_tokens integerTokens usados para raciocínio.integerTotal de tokens (0 quando prompt_extend=false). | |
request_id stringIdentificador exclusivo da solicitação para rastreamento e solução de problemas. | |
code stringCódigo de erro. Retornado apenas para solicitações com falha. Consulte Códigos de erro. | |
message stringMensagem de erro detalhada. Retornada apenas para solicitações com falha. Consulte Códigos de erro. |
Limites
- As URLs das imagens são válidas por 24 horas. Baixe-as imediatamente.
- Moderação de conteúdo: Tanto o
promptde entrada quanto a imagem de saída passam por moderação de conteúdo. Conteúdo não compatível retorna um erroIPInfringementSuspectouDataInspectionFailed. Consulte Códigos de erro.
Faturamento e limitação de taxa
- Para preços e cota gratuita, consulte Preços do modelo.
- Para limites de taxa, consulte Z-Image.
- O faturamento baseia-se na quantidade de imagens geradas com sucesso e no status de prompt_extend. Chamadas com falha não geram cobranças nem consomem a cota gratuita.
