API de Qwen Image 3.0 Pro

Referencia completa de la API para los modelos Qwen Image 3.0 Pro de Alibaba Qwen.

Variantes del modelo

Esta API admite dos variantes del modelo:

Comparación rápida

Relaciones de aspecto compatibles

Ambos modelos admiten 7 relaciones de aspecto:

16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3

Qwen Image 3.0 Pro (Texto a imagen)

Punto de conexión

POST /api/v1/image/task

Autenticación

Authorization: Bearer YOUR_API_KEY

Parámetros de la solicitud

Obligatorios

Nota: La relación anchura:altura debe ser una de las siguientes: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3

Opcionales

Ejemplo de solicitud

javascriptCopiar
const response = await fetch('https://api.flaq.ai/api/v1/image/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'qwen-image-3.0-pro',
    prompt: 'A professional product photo with studio lighting',
    width: 16,
    height: 9,
    seed: 42
  })
});

const { data } = await response.json();
const taskId = data.task_id;

// Poll for results
const pollResponse = await fetch(
  `https://api.flaq.ai/api/v1/image/${taskId}`,
  {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  }
);

const result = await pollResponse.json();
console.log(result.data.task_result.images[0].url);

Qwen Image 3.0 Pro Edit (Edición de imágenes)

Punto de conexión

POST /api/v1/image/task

Parámetros de la solicitud

Obligatorios

Nota: La relación anchura:altura debe ser una de las siguientes: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3

Opcionales

Ejemplo de edición de una sola imagen

javascriptCopiar
{
  model_name: 'qwen-image-3.0-pro-edit',
  prompt: 'Transform this image into a professional portrait with soft studio lighting',
  width: 16,
  height: 9,
  image_url_list: ['https://example.com/image1.jpg']
}

Ejemplo de composición de varias imágenes

Se pueden combinar hasta 3 imágenes en una sola solicitud:

javascriptCopiar
{
  model_name: 'qwen-image-3.0-pro-edit',
  prompt: 'Combine these images into a cohesive landscape',
  width: 16,
  height: 9,
  image_url_list: [
    'https://example.com/image1.jpg',
    'https://example.com/image2.jpg',
    'https://example.com/image3.jpg'
  ],
  seed: 42
}

Formato de respuesta

Respuesta inicial

Todos los modelos devuelven un task_id para consultar el estado:

jsonCopiar
{
  "code": 0,
  "data": {
    "task_id": "{task_id}",
    "task_status": "submitted",
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}"
  },
  "message": "success"
}

Respuesta de la consulta de estado

Consulte GET /api/v1/image/{taskId} para comprobar el estado:

jsonCopiar
{
  "code": 0,
  "data": {
    "task_id": "{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "response_url": "https://api.flaq.ai/api/v1/image/{task_id}",
    "task_result": {
      "credit": 0.0997,
      "images": [
        {
          "url": "https://example.com/generated-image.jpeg"
        }
      ]
    }
  },
  "message": "success"
}

Valores de estado

• submitted: Tarea aceptada
• processing: Generación en curso
• succeed: Generación completada correctamente
• failed: La generación ha fallado

Prácticas recomendadas

Consejos para texto a imagen

1. Sea específico: Incluya detalles sobre el sujeto, el estilo, la iluminación y la composición en el prompt
2. Selección de la relación de aspecto: Elija la proporción según su caso de uso (16:9 para banners web, 9:16 para dispositivos móviles, 1:1 para redes sociales)
3. Use una semilla para garantizar la reproducibilidad: Establezca un valor de seed fijo cuando necesite resultados coherentes entre solicitudes

Consejos para la edición de imágenes

1. Instrucciones claras: Especifique claramente qué desea cambiar en el prompt
2. Composición de varias imágenes: Proporcione hasta 3 imágenes y describa cómo deben combinarse
3. Calidad de imagen: Las imágenes de entrada de mayor calidad suelen producir mejores resultados de edición