FLUX 3 Image Klein

مثال سريع

أرسل طلب صورة واحفظ id المُعاد ثم استعلم حتى تصبح المهمة completed أو failed. تستخدم API مهام غير متزامنة ومخرجات URL.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"flux-3-image-klein","prompt":"An amber bottle on pale limestone in soft morning light","resolution":"1k","aspect_ratio":"3:2"}'

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

POST https://api.seedrouter.ai/v1/images/generations

احتفظ بالمفتاح على الخادم. نجاح HTTP يؤكد المهمة ولا يعني أن صورتها جاهزة.

المعاملات

تُقبل 11 خانة. فقط model وprompt مطلوبان. احذف الحقول الاختيارية لاستخدام الافتراضيات؛ لا تُقبل null.

النسب: auto، 21:9، 2:1، 16:9، 3:2، 7:5، 4:3، 5:4، 1:1، 4:5، 3:4، 5:7، 2:3، 9:16، 1:2، 9:21.

في Playground نموذج ثابت وعشرة عناصر إدخال، منها n ثابت عند 1. قيم الأمان فوق 2 عبر API فقط، باستثناء المسؤولين.

الأوضاع والقيود

دون مراجع، يكون التوليد من النص. مرجع واحد يتيح التحرير، وعدة مراجع تتيح تركيب الصور. مع auto يتبع التحرير نسبة المرجع الأول. يحدد التوليد النصي النسبة من الموجّه، ويعود إلى 1:1 إن لم يحددها. الدقة الافتراضية 1k في كل الأوضاع.

مستويات الدقة تصف الحجم التقريبي: 768sq نحو 768 × 768؛ 1K نحو 1 MP؛ 1.5K نحو 2 MP؛ 2K نحو 4 MP؛ 4K نحو 16 MP. افحص الملف المُعاد للأبعاد الفعلية.

لا تقبل النقطة width أو height أو أبعاد البكسل في size أو negative_prompt أو guidance أو grounding أو prompt_upsampling أو mask أو mask_url. الحقول المجهولة تعيد HTTP 400 قبل الاحتساب. لا تتاح مخرجات WebP أو مدخلات base64 أو البث أو callbacks.

الصور المرجعية وتحرير المناطق

ارفع المراجع إلى URL عام قبل الإرسال. يتضمن الجسم روابط، لا بايتات ملفات أو data URL.

{
  "model": "flux-3-image-klein",
  "prompt": "Use Image 1 as the subject and Image 2 as the setting; match the perspective and light",
  "image_urls": ["https://example.com/subject.png", "https://example.com/setting.png"],
  "aspect_ratio": "auto",
  "resolution": "2k",
  "seed": 0,
  "steps": 16,
  "output_format": "png"
}

استبدل الروابط التوضيحية بصورك المتاحة. المراجع مرتبة: ref_image_0 هو الأول. تعليمات المربعات المحددة جزء من نص prompt وليست حقلًا منفصلًا. تستخدم الإحداثيات [y1, x1, y2, x2] بعد تطبيعها إلى 0–1000. قد يحتوي كائن التخطيط id وbbox وdesc؛ ويمكن للتحرير استخدام id وfrom وsrc_bbox وtgt_bbox وdesc. رمّز الطلب كاملًا بصيغة JSON لإضافة تسلسلات الهروب لعلامات الاقتباس داخل الموجّه بشكل صحيح.

الاحتساب

كل طلب ناجح صورة واحدة. الدقة وحدها تحدد السعر؛ الخطوات والبذرة والنسبة وعدد المراجع والصيغة لا تضيف رسومًا. التوليد النصي والتحرير بالسعر نفسه. الطلبات الفاشلة لا تُحتسب. راجع الأسعار الحالية.

استجابة المهمة والاستعلام

الإرسال:

{"id":"task_example","model":"flux-3-image-klein","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

مهمة مكتملة (رابط توضيحي):

{
  "id": "task_example",
  "model": "flux-3-image-klein",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.png"}]}
}

اقرأ output.data[0].url. اسمح بما يصل إلى عشر دقائق للتوليد، خصوصًا 4K. الاستعلام للقراءة فقط؛ انتهاء مهلة العميل لا يسمح بطلب مدفوع آخر. الاستجابات العامة لا تتضمن تكلفة أو رصيد الحساب.

الأخطاء

تستخدم أخطاء HTTP الصيغة {"error": {"code": integer, "message": string}}. راجع دليل الأخطاء المشترك. تعرض المهمة الفاشلة الخطأ مع status: "failed". صحّح المعاملات غير الصالحة قبل إعادة الإرسال؛ احتفظ بالمعرّف لمراجعة الطلب المُرسل.

نصائح وأدلة مرتبطة

استخدم وصفًا إيجابيًا وسمّ المناطق أو التفاصيل التي تريد الحفاظ عليها. قد تغيّر الخطوات الأقل الجودة دون خفض السعر. قارن تغييرًا واحدًا كل مرة.

• FLUX 3 Image Klein Playground
• دليل التنزيل والأوزان وComfyUI
• دورة حياة المهمة