Qwen Image 3.0 Pro API

O Qwen Image 3.0 Pro Edição de imagem edita de uma a três imagens de referência conforme uma instrução. Com uma referência, é uma mudança cirúrgica — uma chamada de capa, uma peça de roupa, uma luz. Com duas ou três, ele combina, desde que o prompt diga o que cada origem traz.

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

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.

Refinar uma imagem fornecida

Use este modo quando de uma a três imagens aprovadas precisam passar para o resultado. Liste-as em image_urls na ordem em que o prompt as cita e dê um papel a cada uma — o rosto da primeira, a roupa da segunda —, porque os papéis nunca são deduzidos.

Capas de revista e editoriais sem censura

Mantenha uma capa aprovada e mude um elemento por passada: uma chamada, uma peça de roupa ou a luz. Trocar o estilo e o texto na mesma chamada é onde os rostos escapam, então divida em duas requisições.

Rascunhos de pôster e mídia exterior

Pegue um pôster aprovado e troque a linha de data ou o texto legal para a próxima veiculação. Cite o texto antigo e o novo, mantenha aspect_ratio no formato da imagem e descreva todo o resto como inalterado.

Mockups de embalagem e rótulo

Envie um render do produto e troque o rótulo: cite o nome da marca e a frase curta, diga em que superfície eles ficam e use negative_prompt contra restos de letras do rótulo antigo.

# 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/edit",
  "input": {
    "aspect_ratio": "1:1",
    "image_urls": [
      "https://example.com/reference.png"
    ],
    "num_outputs": 1,
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "resolution": "2k"
  }
}'

# 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.