Referência da API

Documentação da Qwen API

Referência objetiva para autenticação, geração Qwen Image, tarefas assíncronas, IDs de modelos e erros.

Criar chave de API Modelos

Início rápido

A API usa JSON padrão via HTTPS. Crie uma chave, envie uma geração e consulte o ID da tarefa.

01
Criar uma chave Bearer
02
Enviar uma geração
03
Consultar o ID da tarefa

URL base

Todas as solicitações públicas usam o domínio qwenapi.org.

https://qwenapi.org

Autenticação

Envie sua chave Qwen API no cabeçalho Authorization em cada solicitação de geração, status e histórico.

Authorization: Bearer $QWEN_API_KEY

Mantenha as chaves de API no servidor. Não as exponha em bundles do navegador, repositórios públicos ou logs do cliente.

Gerar uma imagem

Envie um ID de modelo ativo e os campos de entrada documentados.

POST/api/v1/images/generations

curl https://qwenapi.org/api/v1/images/generations \
  -H "Authorization: Bearer $QWEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-3",
    "prompt": "Editorial product photo in soft morning light",
    "aspect_ratio": "16:9",
    "resolution": "1K"
  }'

Resposta de aceite

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n86...qw3",
    "status": "IN_PROGRESS"
  }
}

Obter status da tarefa

Use o ID da tarefa para obter progresso, erros e URLs finais.

GET/api/v1/tasks/:task_id

curl "https://qwenapi.org/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $QWEN_API_KEY"

IN_PROGRESS

O backend aceitou a tarefa e está processando.

SUCCESS

As URLs de saída estão prontas.

FAILED

A tarefa parou com um erro estruturado.

IDs de modelos ativos

Somente estes IDs apontam atualmente para rotas de produção com cobrança.

Modelo	Custo	Entrada	Saída
qwen-image-3	10 credits / image	Text, up to 3 images	PNG or JPEG
qwen2-image	10 credits / image	Text or image	PNG or JPEG
qwen-image-2512	5 credits / image	Text or images	PNG, JPEG, WebP
qwen-multi-angles	5 credits / image	1-3 images	PNG or JPEG
qwen-layered	10 credits / layer	Image and instruction	Layer images

Erros

Os códigos HTTP acompanham erros JSON estruturados. Guarde o ID da tarefa para o suporte.

400invalid_requestValide o ID do modelo e os campos da solicitação.

401unauthorizedVerifique se a chave Bearer está presente e ativa.

402insufficient_creditsAdicione créditos no painel de cobrança.

404not_foundConfirme que o ID da tarefa pertence a uma rota Qwen.

429rate_limitedAguarde e tente novamente com jitter.

500server_errorTente mais tarde e guarde o ID para o suporte.