API do Qwen Image 3.0: crie e edite até 2K

Name: Qwen Image 3.0 API
SKU: alibaba/qwen-image-3.0/text-to-image
Price: 0.05 USD
Availability: InStock

Sobre o Qwen Image 3.0

O Qwen Image 3.0 é o modelo de imagem com renderização de texto da Alibaba: prompts de 5.000 caracteres, oito proporções, faixa 1K ou 2K e um endpoint de edição que lê de uma a três referências.

Chame com o nome de modelo alibaba/qwen-image-3.0/text-to-image em POST /jobs/createTask, a partir de 5 créditos por imagem (US$ 0,05). Contas novas ganham 30 créditos grátis para você testar primeiro no Playground.

Parâmetros da requisição

Parâmetro	Obrigatório	Descrição
`seed`	Não	Repetir o mesmo número dá um resultado reproduzível. ≥ 0 · ≤ 2147483647
`prompt`	Sim	Describe the subject, composition, lighting, and any text to render.
`resolution`	Não	Tamanho de saída. Maior fica mais nítido e custa mais. 1k · 2k · Padrão: 2k
`num_outputs`	Não	Quantos resultados gerar de uma vez. ≥ 1 · ≤ 1 · Padrão: 1
`aspect_ratio`	Não	O formato do quadro: horizontal, quadrado ou vertical. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · Padrão: 1:1
`negative_prompt`	Não	O que você não quer ver.
`enable_prompt_expansion`	Não	Deixa o modelo completar um prompt curto com detalhes. Padrão: true
`prompt_optimization_mode`	Não	How prompt expansion rewrites the brief: single pass, or a multi-step agent rewrite. direct · agent · Padrão: direct

Preços

Os preços são em créditos, os mesmos que você usa no site (1 crédito = US$ 0,01). O valor é reservado quando a tarefa é aceita e acertado pelo custo real quando ela termina; tarefas com falha são reembolsadas.

Opção	Créditos por imagem	≈ USD
Padrão	4,5	US$ 0,045

Cada tarefa é arredondada para cima em créditos inteiros, então uma execução no nível mais baixo custa 5 créditos por imagem (US$ 0,05).

Para saber o valor exato antes de rodar, envie o mesmo corpo para POST /jobs/quote.

Início rápido da API

Chame a API do Qwen Image 3.0 em três passos

Crie uma chave de API. Entre na PopNow e crie uma chave no console da API. As chaves começam com sk-popnow- e usam os mesmos créditos do site.
Envie a requisição. Faça POST /jobs/createTask com model alibaba/qwen-image-3.0/text-to-image e um objeto input conforme a tabela de parâmetros. A resposta traz um ID de tarefa na hora.
Pegue o resultado. Consulte GET /jobs/recordInfo com o ID da tarefa, ou passe uma callBackUrl e enviamos o resultado para ela. Baixe os links de saída quando a tarefa der certo.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/qwen-image-3.0/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "aspect_ratio": "1:1",
    "resolution": "2k",
    "num_outputs": 1
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Troque o prompt e os links pelos seus. A aba API traz a referência da resposta, do polling e do callback.

Perguntas sobre a API do Qwen Image 3.0

Quanto custa a API do Qwen Image 3.0?

O Qwen Image 3.0 custa a partir de 5 créditos (US$ 0,05) por imagem com Criar imagem, a tarefa mais barata. Os créditos são os mesmos do site (1 crédito = US$ 0,01), contas novas ganham 30 créditos grátis e tarefas que falham são reembolsadas.

Qual é o nome de modelo do Qwen Image 3.0 na API?

Coloque alibaba/qwen-image-3.0/text-to-image para Criar imagem; alibaba/qwen-image-3.0/edit para Editar imagem no campo model de POST /jobs/createTask.

Quanto texto ele consegue renderizar de fato dentro de uma imagem?

Strings curtas se seguram bem: um cabeçalho, uma placa, um rótulo de produto, um título de mais ou menos oito palavras ou menos. Parágrafos inteiros ainda desandam. Gere qualquer coisa com tipografia na faixa 2k.

Quantas imagens uma requisição pode devolver?

Uma. num_outputs é fixo em 1, então cada requisição devolve uma única imagem e é orçada e acertada separadamente. Para vários sorteios do mesmo briefing, dispare requisições em paralelo sem seed.

Qual a diferença entre image-to-image e text-to-image?

A edição acrescenta um array image_urls obrigatório com uma a três fontes e mantém todos os outros campos. Diga no prompt qual referência contribui com o quê; o modelo não atribui papéis por você.

Ele lê prompts em chinês?

Lê, nativamente, e não há parâmetro de idioma para definir. O orçamento de 5.000 caracteres é o mesmo dos dois lados, assim como o tratamento das strings citadas.

Dá para reproduzir a mesma imagem duas vezes?

Um seed fixo ajuda a controlar a variação aleatória, mas não garante resultados idênticos.

Quais são os limites da API do Qwen Image 3.0?

Resoluções: 1K · 2K; Proporções: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +2; Tamanho do prompt (caracteres): 5,000. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.

Dá para testar o Qwen Image 3.0 sem escrever código?

Dá. O Playground roda o Qwen Image 3.0 com seus créditos da PopNow, não precisa de chave de API e mostra o código de cada geração.

Todos os modelos Qwen Image

O Qwen Image 3.0 Pro eleva o teto em tipografia de várias linhas e textura fina para o quadro final.

Outras APIs de imagem

Mais sobre o Qwen Image 3.0

Experimente: Qwen Image 3.0: gerador de imagens com IA online Crie imagens com o Qwen Image 3.0 na PopNow
Documentação: ID do modelo e esquema de entrada do Qwen Image 3.0 na documentação da API Início rápido da API da PopNow: sua primeira requisição em cinco minutos Guia de geração de imagens com a API da PopNow Webhooks: receba os resultados do Qwen Image 3.0 sem polling