Introdução
O Qwen Image 3.0 Pro Texto para imagem é o nível de acabamento da linha. Ele recebe a mesma requisição do Qwen Image 3.0 e investe mais em detalhe — principalmente na tipografia com vários elementos e na renderização de materiais como pele, tecido e vidro.
O Qwen Image 3.0 Pro é o nível de alto detalhe da linha de imagem Qwen da Alibaba: prompts de até 5.000 caracteres, oito proporções, um nível de 1K ou 2K e edição com uma a três referências. Feito para imagens que vão ser entregues, sem censura.
Escolha o modo do Qwen Image 3.0 Pro pelo material de partida
| Material de partida | Modo |
|---|---|
| Uma direção de arte ou um brief de design por escrito | Qwen Image 3.0 Pro Texto para imagem |
| Uma imagem de origem aprovada para revisar | Qwen Image 3.0 Pro Edição de imagem |
Recursos e destaques
Composição de imagem pensada para o texto
O Qwen Image 3.0 Pro é útil para conceitos visuais em que o texto fornecido, a composição e o tratamento da imagem precisam ser pensados juntos. Trate as letras geradas como um rascunho de design e revise antes de publicar.
Compor do zero e revisar uma origem são trabalhos diferentes
Use texto para imagem para montar um visual a partir de um brief escrito. Use a edição de imagem quando uma imagem existente traz a identidade, o layout ou o material que precisa ser mantido enquanto uma mudança definida é feita.
Revise a hierarquia antes do detalhe decorativo
Em pôsteres, embalagens e conceitos de campanha, decida primeiro a hierarquia da mensagem e o ponto focal. Um resultado bonito ainda falha na tarefa se o texto aprovado ou os dados do produto não aparecerem corretamente.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Até 5.000 caracteres, em chinês ou inglês. Cite toda string que precisa aparecer e diga onde ela fica; três ou quatro strings curtas por quadro é a faixa confiável. pelo menos 1 caracteres · no máximo 5000 caracteres |
aspect_ratio | Não | Compõe o quadro em vez de recortá-lo. 3:4 e 2:3 são os formatos para os quais capas e cartazes são diagramados; as oito custam o mesmo por imagem. |
resolution | Não | 1k ou 2k, padrão 2k, e a única variante de preço. A vantagem desta faixa é praticamente invisível em 1k — use 1k só para rascunhos de composição. |
num_outputs | Não | Fixo em 1: uma imagem por requisição. |
enable_prompt_expansion | Não | Ligada por padrão nesta família. Ela completa briefings magros e reescreve os detalhados, então desligue assim que o prompt for uma descrição precisa de plano. Valor padrão: |
negative_prompt | Não | Até 2.000 caracteres de exclusões. Em trabalho de tipografia ele se paga contra letras duplicadas, marcas d'água perdidas e bordas de rótulo borradas. no máximo 2000 caracteres |
prompt_optimization_mode | Não | Como a expansão de prompt reescreve o seu brief enquanto |
seed | Não | Omita enquanto explora; fixe assim que um layout acertar e depois mude uma chamada de capa por vez, para ver o efeito de cada edição isolado. |
Preços
| Especificação | Preço |
|---|---|
| $0.04 / imagem |
| $0.075 / imagem |
Casos de uso
Começar por um brief escrito
Use este nível quando a imagem vai ser entregue como voltar e traz vários elementos de texto: um cabeçalho, uma linha de data, uma frase curta. Deixe a resolução em 2k, cite cada texto e diga onde cada um fica.
Mockups de embalagem e rótulo
Rótulos de garrafas, caixas e latas em que o nome da marca e uma frase curta precisam ser legíveis numa superfície curva. Cite cada texto, diga o material e deixe o prompt negativo cuidar de letras duplicadas que aparecerem.
Capas de revista e editoriais sem censura
Um retrato de página inteira com um cabeçalho real, um número de edição e duas chamadas de capa, gerado em uma única chamada. O estilo pode mudar sem mudar nada na requisição: o mesmo endpoint cuida da tipografia e do estilo.
Rascunhos de pôster e mídia exterior
Imagens em 3:4 e 2:3 com manchete, linha de data e texto legal já compostos na imagem, no nível 2k. O bastante para levar a uma revisão antes de alguém colocar tipografia de verdade sobre uma imagem limpa.
Guia de prompt e dicas práticas
Cite cada texto e diga onde ele fica
Diga separadamente o cabeçalho, as chamadas de capa e as versaletes, cada um entre aspas simples e cada um com uma posição. Três ou quatro textos curtos por imagem é a faixa confiável; negative_prompt pode manter fora letras duplicadas e marcas-d’água soltas.
Fixe o seed e depois varie uma linha
Quando o layout acertar, anote o seed e mude uma chamada de capa por vez. Se preferir várias leituras do mesmo layout em vez de uma imagem fechada, deixe o seed de fora e envie o brief como requisições paralelas.
Adapte o exemplo incluído
Comece pelo exemplo publicado com aspect_ratio: 3:4 e resolution: 2k. Troque o assunto e a direção criativa, mas mantenha o contrato de entrada deste modo.
A glossy fashion magazine cover, full-bleed portrait of an adult woman in a black lace bodysuit under a sheer open kimono, arms raised adjusting her hair, studio rim light on a deep charcoal background; masthead text 'SPICY' in large condensed type across the top, cover lines reading 'THE LATE SHIFT' and 'ISSUE 07' in small caps, high-end print typography, razor-sharp 2K detail.
É a requisição exata por trás da capa mostrada neste endpoint: um retrato sangrado em 3:4 no nível 2k, com cabeçalho, linha da edição e chamadas de capa todos citados no prompt.
Confira o resultado antes de iterar
A tipografia com vários elementos é o motivo para usar este nível, e mesmo assim ela tem um teto: três ou quatro textos curtos por imagem são confiáveis; uma página inteira de texto, não. Gere tipografia em 2k — o nível 1k é para rascunhos de composição. Glifos raros e alfabetos não latinos são renderizados, mas precisam de revisão antes de qualquer entrega.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-3.0-pro/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k",
"num_outputs": 1,
"aspect_ratio": "1:1",
"prompt_optimization_mode": "direct"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
