تخطَّ إلى المحتوى

مستندات المطور UlazAI

الصورة API

بريد /api/v1/generate/

نقطة النهاية لتوليد الصور الأساسية

استخدم نقطة النهاية هذه لجميع عمليات التكامل الجديدة. اختر نموذجًا مع model وتمرير اختياريا image_urls لتحرير سير العمل على النماذج المدعومة.

حالة الاستطلاع مع /api/v1/generate/{generation_id}/ والاستخدام /api/v1/generate/history/ للتاريخ الوظيفي.

طلب العقد

الميدان يكتب مطلوب ملاحظات
prompt سلسلة نعم من 1 إلى 5000 حرف
model سلسلة لا الافتراضات ل gpt_image_15
size سلسلة لا تعتمد القيم المسموح بها على النموذج المحدد. gpt_image_2 كما يقبل النسب المخصصة مثل 5:7 أو 1024x768.
quality سلسلة لا وضع الدقة أو الجودة، خاص بالنموذج
image_urls صفيف [سلسلة] لا* يستخدم لتحرير سير العمل على نماذج مثل gpt_image_2, qwen_image، و wan_2_7_image. مطلوب ل ideogram_character.

محدد النموذج

قم بتبديل الإعدادات المسبقة للنموذج لتحديث أمثلة الطلب على الفور.

FLUX 3 Klein model=flux_3_klein

FLUX 3 Klein from Black Forest Labs with fast 1K/2K/4K generation, edits with up to 10 reference images, a seed, and 1-4 images per request.

الأحجام المسموح بها: 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, 9:21, auto

قيم الجودة المسموح بها: 1K, 2K, 4K

وضع التحرير: مدعومة

مقتطفات الطلب المباشر

تتبع المقتطفات أدناه الإعداد المسبق للنموذج المحدد.

الضفيرة

جافا سكريبت (جلب)

بايثون (الطلبات)

أمثلة على الاستجابة

201 تم الإنشاء

{
  "success": true,
  "data": {
    "generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
    "status": "processing",
    "estimated_time": "varies by model and queue",
    "credits_used": 8,
    "credits_remaining": 124,
    "message": "Generation started successfully"
  }
}

402 الدفع مطلوب

{
  "success": false,
  "error": "Insufficient credits. Need 18, have 7",
  "credits_needed": 18,
  "credits_balance": 7
}

400 طلب سيء

{
  "success": false,
  "error": "Invalid size. Must be one of: 1:1, 3:2, 2:3"
}