Recursos para Desarrolladores

Documentacion de la API de Qwen-Image-2512

Integra el modelo Qwen-Image-2512 AI de Alibaba en tus aplicaciones. Genera imagenes de alta calidad a partir de descripciones de texto con una API REST sencilla.

1

Autenticacion

La API de Qwen-Image-2512 utiliza autenticacion mediante Bearer Token. Envia tu clave de API en el encabezado de la solicitud.

Autenticacion
Authorization: Bearer sk-your-api-key-here

Manten tu clave de API segura. No la compartas en codigo del lado del cliente.

Precios

TipoCostoDescripcion
Texto a Imagen5 CreditosGenera imagenes a partir de prompts de texto usando Qwen-Image-2512 AI.
2

Crear Tarea

POSThttps://qwen-image-2512.org/api/generate
Generacion Asincrona

Precios

Cada generacion de imagen cuesta 5 creditos.

Inicia una tarea de generacion. La API devuelve un task_id de inmediato, que puedes usar para consultar el resultado.

Parametros del Cuerpo

ParametroTipoRequeridoDescripcion
promptstringRequeridoLa descripcion de texto para la generacion de imagen. Maximo 2000 caracteres.
sizestringOpcionalTamano de imagen. Soportado: 1024*1024, 1024*1536, 1536*1024, 768*1024, 1024*768. Predeterminado: 1024*1024
seednumberOpcionalSemilla aleatoria para resultados reproducibles. -1 para aleatorio. Predeterminado: -1
output_formatstringOpcionalFormato de salida: jpeg, png o webp. Predeterminado: jpeg
callback_urlstringOpcionalURL de Webhook para notificaciones de finalizacion de tarea.

Ejemplos de Solicitud

Ejemplo Texto a Imagen (cURL)
curl -X POST https://qwen-image-2512.org/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene mountain landscape at sunset",
    "size": "1024*1024",
    "output_format": "png"
  }'
Respuesta Exitosa
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "IN_PROGRESS"
  }
}
Respuesta de Error
{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}
3

Consultar Estado

GEThttps://qwen-image-2512.org/api/status

Consulta este endpoint para verificar el progreso de tu tarea. Recomendamos consultar cada 5-10 segundos.

Parametros de Consulta

ParametroTipoDescripcion
task_idstringEl ID de tarea recibido desde el endpoint de generacion. Requerido

Valores de Estado

PENDINGTarea en cola
IN_PROGRESSEn progreso
SUCCESSCompletada
FAILEDOcurrio un error
cURL
curl -X GET "https://qwen-image-2512.org/api/status?task_id=n43abc123def456qwenimg" \
  -H "Authorization: Bearer YOUR_API_KEY"
Respuesta (En progreso)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "IN_PROGRESS",
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}
Respuesta (Completada)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "SUCCESS",
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": ["https://cdn.example.com/image.png"]
  }
}
Respuesta (Fallida)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n43abc123def456qwenimg",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

Codigos de Error

CodigoDescripcion
200Exito
400Bad Request - Parametros invalidos (falta el prompt, tamano invalido, etc.)
401Unauthorized - Clave de API faltante o invalida
404Not Found - El ID de tarea no existe
500Internal Server Error - Por favor, reintenta o contacta al soporte

Necesitas ayuda?

Visita nuestro canal de soporte o envianos un correo electronico.

Contactar a Soporte