واجهة برمجة تطبيقات Qwen Image 3.0 Pro

مرجع شامل لواجهة برمجة تطبيقات نماذج Qwen Image 3.0 Standard وPro المدعومة من Alibaba Qwen.

إصدارات النموذج

تدعم واجهة برمجة التطبيقات هذه أربعة إصدارات من النموذج:

مقارنة سريعة

نسب العرض إلى الارتفاع المدعومة

تدعم النماذج الأربعة نسب العرض إلى الارتفاع التالية:

16:9، 9:16، 1:1، 4:3، 3:4، 3:2، 2:3

نقطة النهاية

POST /api/v1/image/task

المصادقة {#}

Authorization: Bearer YOUR_API_KEY

إنشاء الصور من النص

استخدم qwen-image-3.0 للنموذج Standard أو qwen-image-3.0-pro للنموذج Pro.

معاملات الطلب

مطلوبة

يجب أن تكون نسبة العرض إلى الارتفاع واحدة من: 16:9، 9:16، 1:1، 4:3، 3:4، 3:2، 2:3.

اختيارية

مثال على طلب Standard

javascriptنسخ
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',
    prompt: 'A professional product photo with soft studio lighting',
    width: 16,
    height: 9,
    resolution: '1k',
    seed: 42
  })
});

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

مثال على طلب Pro

javascriptنسخ
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 detailed editorial product scene with precise typography and cinematic lighting',
    width: 16,
    height: 9,
    resolution: '2k',
    seed: 42
  })
});

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

تحرير الصور

استخدم qwen-image-3.0-edit للنموذج Standard Edit أو qwen-image-3.0-pro-edit للنموذج Pro Edit.

معاملات الطلب

مطلوبة

يجب أن تكون نسبة العرض إلى الارتفاع واحدة من: 16:9، 9:16، 1:1، 4:3، 3:4، 3:2، 2:3.

اختيارية

مثال على طلب Standard Edit

javascriptنسخ
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-edit',
    prompt: 'Transform the input into a polished editorial portrait with soft studio lighting',
    width: 16,
    height: 9,
    resolution: '1k',
    image_url_list: ['https://example.com/image1.jpg'],
    seed: 42
  })
});

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

مثال على طلب Pro Edit متعدد الصور

javascriptنسخ
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-edit',
    prompt: 'Combine the products from these references into one cohesive campaign image',
    width: 16,
    height: 9,
    resolution: '2k',
    image_url_list: [
      'https://example.com/image1.jpg',
      'https://example.com/image2.jpg',
      'https://example.com/image3.jpg'
    ],
    seed: 42
  })
});

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

تنسيق الاستجابة

الاستجابة الأولية

تعيد جميع النماذج task_id للاستقصاء:

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

استجابة الاستقصاء

استقصِ GET /api/v1/image/{task_id} للتحقق من حالة المهمة:

jsonنسخ
{
  "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"
}

قيم الحالة

• submitted: تم قبول المهمة
• processing: جارٍ الإنشاء
• succeed: اكتمل الإنشاء بنجاح
• failed: فشل الإنشاء

أفضل الممارسات

نصائح لإنشاء الصور من النص

1. كن محددًا: ضمّن الموضوع والأسلوب والإضاءة والتكوين ومتطلبات النص في المطالبة.
2. اختر الدقة: حدد 1k أو 2k بناءً على دقة الإخراج المطلوبة.
3. حدد نسبة العرض إلى الارتفاع: طابق النسبة مع وجهة الاستخدام، مثل 16:9 للافتات أو 9:16 للمحتوى الرأسي.
4. استخدم البذرة لإمكانية التكرار: عيّن seed ثابتًا عندما تحتاج إلى إعدادات إنشاء قابلة للتكرار.

نصائح لتحرير الصور

1. استخدم تعليمات واضحة: صِف ما يجب تغييره وما يجب أن يظل متسقًا.
2. رتّب المدخلات المتعددة بعناية: قدم 1–3 صور واشرح دور كل مرجع في المطالبة.
3. اختر دقة الإخراج: حدد 1k أو 2k بشكل مستقل عن أبعاد صورة الإدخال.
4. استخدم مدخلات عالية الجودة: تنتج الصور المصدر الواضحة عمومًا نتائج تحرير أكثر تحكمًا.