Documentación de Qwen API
Referencia concisa para autenticación, generación Qwen Image, tareas asíncronas, IDs de modelo y errores.
Inicio rápido
La API usa JSON estándar sobre HTTPS. Crea una clave, envía una generación y consulta el ID de tarea.
- 01
Crear una clave Bearer
- 02
Enviar una generación
- 03
Consultar el ID de tarea
URL base
Todas las solicitudes públicas usan el dominio qwenapi.org.
https://qwenapi.orgAutenticación
Envía tu clave Qwen API en la cabecera Authorization de cada solicitud de generación, estado e historial.
Authorization: Bearer $QWEN_API_KEY
Guarda las claves API en tu servidor. No las expongas en bundles del navegador, repositorios públicos o logs del cliente.
Generar una imagen
Envía un ID de modelo activo y sus campos de entrada documentados.
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"
}'Respuesta de aceptación
{
"code": 200,
"message": "success",
"data": {
"task_id": "n86...qw3",
"status": "IN_PROGRESS"
}
}Obtener estado
Usa el ID de tarea para obtener progreso, errores y URLs finales.
curl "https://qwenapi.org/api/v1/tasks/$TASK_ID" \ -H "Authorization: Bearer $QWEN_API_KEY"
IN_PROGRESS
El backend aceptó la tarea y está trabajando.
SUCCESS
Las URLs de salida están listas.
FAILED
La tarea se detuvo con un error estructurado.
IDs de modelos activos
Solo estos IDs se resuelven actualmente a rutas de producción con facturación.
| Modelo | Coste | Entrada | Salida |
|---|---|---|---|
| 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 |
Errores
Los códigos HTTP incluyen errores JSON estructurados. Conserva el ID de tarea para soporte.
400invalid_requestValida el ID del modelo y los campos de la solicitud.401unauthorizedComprueba que la clave Bearer existe y está activa.402insufficient_creditsAñade créditos en el panel de facturación.404not_foundVerifica que el ID de tarea pertenece a una ruta Qwen.429rate_limitedEspera y reintenta con jitter.500server_errorReintenta más tarde y conserva el ID para soporte.