أنشئ صور منتجات، ملصقات، وتعديلات مرجعية باستخدام FLUX 3 Image، والمتاح عبر CometAPI تحت المعرف flux-3-image، بأسعار تبدأ من $0.0384 لكل طلب. يرشدك هذا الدليل إلى اختيار إعدادات الصورة، إعداد الطلب، التعامل مع مهمة غير متزامنة، ومراجعة الصورة النهائية. ستحتاج إلى حساب CometAPI، ومفتاح API، وتكوين طلب FLUX 3 Image المخصّص لحسابك.
النقاط الرئيسية
استخدم التحويل من نص إلى صورة لإنشاء تراكيب جديدة، والتحرير الموجّه بالمرجع عندما يجب أن يبقى المنتج أو الموضوع قابلاً للتعرّف.
استخدم مسودة صغيرة لمراجعة التكوين قبل الإنفاق على صورة نهائية أكبر.
استخدم بيانات اعتماد CometAPI ومخطط الطلب الخاص بالنموذج؛ مفاتيح وأمثلة BFL-native تخص تكاملاً منفصلاً.
قدّر التكاليف وفق تسعير CometAPI المعمول به، ثم قِس الإنفاق لكل مخرجات معتمدة.
تمت المراجعة للوضوح ودقة المصدر ومصطلحات API الحالية.
أكمل دورة واحدة: الإرسال، استرجاع النتيجة، التنزيل، والمراجعة البصرية قبل تشغيل دفعة.
ما هي FLUX 3 Image API؟
FLUX 3 Image هو نموذج Black Forest Labs لإنشاء الصور الثابتة وتعديلها. يصف النص مشهداً جديداً؛ وتوفّر الصور المرجعية مادة بصرية للحفاظ عليها، أو دمجها، أو تغييرها. بالنسبة لفريق تجارة إلكترونية، قد يعني ذلك تطوير مشهد منتج من موجز، ثم إعادة استخدام صورة منتج معتمدة مع تغيير البيئة حولها.
اختر سير العمل قبل كتابة الوصف. من أجل صورة جديدة، حدّد الموضوع، والمشهد، والإضاءة، والإطار. ومن أجل تعديل، عرّف الصورة المصدر، وسمِّ التغيير المطلوب، وحدّد التفاصيل التي يجب أن تبقى سليمة. ومن أجل تركيب يستخدم عدة مراجع، عيّن لكل مرجع دوراً حتى لا تتعارض هوية المنتج والأسلوب البصري.
مواصفات FLUX 3 Image ومعاملات API
خطّط لصورتك باستخدام الإعدادات أدناه. تتحكم إعدادات النموذج وفق مرجع BFL FLUX 3 Image API؛ أما المصادقة وتوجيه الطلبات فبحسب تكامل CometAPI لديك. استخدم أسماء الحقول المقبولة في مسار FLUX 3 Image ضمن CometAPI لديك.
القدرة / الإعداد
ما الذي يتحكم به
كيفية استخدامه مع CometAPI
هوية النموذج
FLUX 3 Image؛ معرف الكتالوج flux-3-image
استخدم مسار النموذج المحدد واتّبع أسلوب التوجيه في مثال حسابك.
التوليد / الوصف (prompt)
المشهد، التكوين، أو تعليمات التحرير
ابدأ بموضوع واضح واحد ومُخرج مقصود واحد.
الصور المرجعية / native images
قائمة مرتبة من 1–10 صور مرجعية، تُقدَّم كروابط HTTP(S) أو base64 في الواجهة الأصلية
أكّد اسم الحقل في البوابة، وصيغة الإدخال، وحدّ المراجع.
نسبة العرض إلى الارتفاع / native aspect_ratio
نسب أبعاد اللوحة. مع auto، تُمنح الأولوية للنسبة المطلوبة في الوصف؛ وإلا تحتفظ التعديلات بإطار المرجع الأول.
مستويات أصلية: 768sq، و1k (الافتراضي)، و1.5k، و2k، و4k. الأبعاد الدقيقة تعتمد على نسبة العرض إلى الارتفاع.
في التعديلات، match_input يحافظ على حجم المرجع الأول، مع تقليصه إلى 4 ميغابكسل إذا كان أكبر؛ aspect_ratio صريح يختار أقرب مستوى. العرض والارتفاع الصريحان لهما أولوية.
الأبعاد الدقيقة / width + height
زوّد كلا القيمتين معاً كأعداد صحيحة بين 256–6256 بكسل. تتجاوزان resolution وaspect_ratio. المساحة الإجمالية محدودة بـ 16,822,272 بكسل، أو 4,194,304 بكسل عند استخدام مراجع.
استخدم الأبعاد الصريحة لحجم تسليم ثابت، مثل 1024 × 1280. أكّد أن مسار CometAPI لديك يقبل هذه الضوابط الأصلية.
التحكم في التخطيط
توجيه مواضع العناصر عبر صناديق احتواء
استخدم صيغة التخطيط الموثّقة عندما تهمّك الدقة في التموضع.
التعديلات المستهدفة
تغييرات على مواضيع أو مناطق محددة
قارن المصدر والنتيجة في المناطق التي ينبغي أن تبقى دون تغيير.
المصادقة
اختر الأبعاد بإحدى ثلاث طرق: مستوى دقة مع نسبة عرض إلى ارتفاع، أو عرض وارتفاع لأبعاد دقيقة، أو match_input للتحرير. احتفظ بالمرجع الأصلي لتتمكّن من مقارنة الإطار والتفاصيل بعد التوليد. نقطة النهاية الأصلية ترفض الحقول غير المدعومة؛ استخدم المخطط الخاص بالمسار الذي تستدعيه.
FLUX.2 مقابل FLUX 3 Image
البعد
FLUX 2 MAX / FLUX 2 PRO
FLUX 3 Image
تقييم عملي
حالة الاستخدام
تحويل نص-إلى-صورة/تحرير قوي، ومتغيرات عائلية
تركيب صور مفصل وتعديلات محافظة على البكسل
قارن نفس عبارات العلامة التجارية
الدقة
توليد عالي الدقة يعتمد على المتغير
عرض أصلي صريح 2K/4K
افحص التفاصيل الدقيقة على تكبير كامل
التحرير
قدرات مراجع متعددة في متغيرات محددة
عروض لتعديلات موضعية
قياس الانجراف في المناطق غير المُعدّلة
التكلفة
تختلف حسب المتغير والمنصة
تسعير CometAPI للتكوين المحدد
قارن لكل صورة معتمدة
وصول CometAPI
متاح عبر CometAPI كـ FLUX 2 PRO وFLUX 2 MAX
متاح عبر CometAPI كـ flux-3-image
تحقّق من الطلب الخاص بالنموذج قبل تغيير توجيه الإنتاج
التقييم
استخدم المتغير الدقيق المُنشر اليوم
شغّل نفس الوصف ومجموعة المراجع
قارن المخرجات المعتمدة وتكلفة سير العمل الإجمالية ووقت التنفيذ
احتفظ بتكامل FLUX.2 الحالي كخط أساس للمقارنة أثناء تقييم FLUX 3 Image. شغّل نفس الموجزات والأصول المرجعية عبر كلا سيرَي العمل، ثم قارن المخرجات المعتمدة، ووقت الإنجاز، والتكلفة الإجمالية.
كيف تولّد صورة باستخدام FLUX 3 Image API في CometAPI؟
POST https://api.cometapi.com/flux/v1/flux-3-image
المصادقة تستخدم رمز Bearer (نمط CometAPI). الطلبات غير متزامنة بشكل افتراضي.
3. مثال أساسي من نص إلى صورة (cURL)
curl https://api.cometapi.com/flux/v1/flux-3-image \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Ultra-wide cinematic shot of a fog-drenched coastal highway at dawn, cliffs on one side, turquoise sea on the other, a single vintage car with headlights on, soft golden rim light",
"aspect_ratio": "21:9",
"resolution": "1k"
}'
استعلم حتى تكون قيمة status هي "Ready". سيظهر رابط الصورة في result.sample (نزّله بسرعة؛ الروابط الموقّعة مؤقتة).
لانتظار متزامن في نفس الطلب، أضف "async": false إلى الجسم (أبقِ الاتصال مفتوحاً؛ استخدم مهلة سخية للعميل).
5. مثال Python (إرسال + استعلام)
import os
import time
import requests
API_KEY = os.environ["COMETAPI_KEY"]
BASE = "https://api.cometapi.com/flux/v1"
def generate_image(payload, name="flux3_image"):
# Submit
r = requests.post(
f"{BASE}/flux-3-image",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json=payload,
timeout=60,
)
r.raise_for_status()
task = r.json()
task_id = task["id"]
# Poll
while True:
time.sleep(1.5)
result = requests.get(
f"{BASE}/get_result",
params={"id": task_id},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=60,
).json()
status = result.get("status")
if status not in ("Pending", "Reasoning", "Generating"):
break
if status != "Ready":
raise RuntimeError(result)
# Download
img_url = result["result"]["sample"]
img = requests.get(img_url, timeout=120)
with open(f"{name}.png", "wb") as f:
f.write(img.content)
return f"{name}.png"
# Example call
generate_image({
"prompt": "A two-color risograph narrative illustration... a rabbit rides a pumpkin...",
"aspect_ratio": "16:9",
"resolution": "1k",
})
يدعم FLUX 3 Image التحويل من نص إلى صورة والتحرير/تعدد المراجع عبر نفس نقطة النهاية—فقط أدرج images واصفاً كيفية استخدامها في الوصف (لا يوجد حقل "mode" منفصل).
بديل: مسار متوافق مع OpenAI
يمكنك أيضاً تجربة نقطة الصور الموحّدة مع معرف النموذج:
POST https://api.cometapi.com/v1/images/generations
(المسار الأصلي /flux/v1/... مُفضّل لمعاملات FLUX 3 الكاملة).
### نصائح
- تحقّق من مدى التوفر الحالي والأسعار الدقيقة على [صفحة نموذج CometAPI Flux 3 Image](https://www.cometapi.com/models/flux/flux-3-image/).
- قم دائماً بتنزيل رابط result.sample بسرعة.
- لأحدث قائمة للمعاملات أو أمثلة ساحة اللعب، راجع وثائق Flux لدى CometAPI ومرجع FLUX 3 Image الرسمي من Black Forest Labs.
هذا يعكس التدفق الرسمي لدى BFL مع استخدام مصادقة CometAPI وبنيتها الموحّدة.
## كيف تكتب وصفاً لـ FLUX 3 Image؟ أمثلة
### مثال: وصف تصوير منتج
استخدم هذا الوصف لأول اختبار تصوير منتج.
A premium amber perfume bottle centered on matte limestone,
three-quarter product perspective, exact bottle silhouette,
softbox key light camera-left, detailed contact shadow,
subtle natural reflections, beige seamless studio backdrop,
no extra bottles, no watermark, no altered brand lettering.
Output: clean 4:5 e-commerce hero creative.
استبدل قيمة prompt في request.json بهذا الموجز، مع الحفاظ على جسم الطلب بحسب ما يتوقعه مسار CometAPI لديك. قماش 4:5 مناسب لوضعية بورتريه للمنتج. إذا كان مسارك يقبل ضوابط الأبعاد الأصلية، فإن 1024 × 1280 هو خيار 4:5 دقيق؛ زوّد القيمتين معاً.
ابدأ بمسودة صغيرة وتحقّق من محيط زجاجة العطر، والملصق، والانعكاسات، والكائنات الإضافية. إذا كانت هوية المنتج الدقيقة مهمة، فاستخدم مرجع المنتج بدلاً من توقع إعادة بنائه بوصف نصي فقط. سجّل الوصف وإعدادات الإخراج قبل إجراء تغييرات.
### مثال: الطباعة وتخطيط الملصق
وصف ملصق مع نص عنوان محدد صراحةً.
An editorial art poster on warm off-white paper.
Title text exactly: THE SEED PARADE.
Three stylized walking seed characters below the title.
Two-color risograph-inspired printing, generous margins,
balanced hierarchy, crisp legible typography, portrait format.
استخدم هذا الموجز كـ prompt في طلب CometAPI واختر لوحة بورتريه. ابدأ بمسودة للتحقق من موضع العنوان وترتيب الشخصيات، ثم زد حجم الإخراج للعمل الفني النهائي.
عامل دقة الأحرف كشرط قبول قابل للقياس. راجع كل حرف وعلامة ترقيم في إخراج الدقة النهائية؛ الصور المبهرة لا تضمن صفر أخطاء في نص علامتك الخاصة.
## كيف تعدّل الصور باستخدام المراجع
لأجل تعديل، اشرح التغيير الذي تريده والتفاصيل المطلوب الحفاظ عليها. تأخذ واجهة FLUX 3 Image الأصلية المراجع عبر images؛ وطابقها مع حقل الإدخال المناظر في مثال CometAPI لديك. ضع مرجع المنتج أولاً واحتفظ بهذا الترتيب في الوصف.
### تحرير صورة واحدة: غيّر الخلفية مع الحفاظ على المنتج
احتفظ بـ edit.py بجانب submit.py وpoll.py وdownload.py. اضبط PRODUCT_IMAGE_URL على رابط HTTPS عام لصورة منتج، ثم شغّل python edit.py. يتطلب المثال أدناه مساراً يقبل مصفوفة images الأصلية. استخدم جسم طلب تحرير بدون حقول مصدر متعارضة، وغيّر المطابقة إذا كان مثال CometAPI لديك يستخدم حقل إدخال مختلف. لاستئناف مهمة تحرير محفوظة، شغّل python poll_download.py editing-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
This request variant requires a route accepting the native images array.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [os.environ["PRODUCT_IMAGE_URL"]]
payload["prompt"] = (
"Use image 1 as the authoritative product reference. "
"Replace only the studio background with pale limestone and warm "
"morning window light. Preserve bottle shape, cap, label text, logo "
"position, and product color. Do not crop the product or add objects."
)
task_id = submit(payload, "editing-task.json")
image_url = wait_for_image(task_id)
print(download_image(image_url, "edited-product"))
اختر صورة منتج حادة مع ملصق قابل للقراءة ومحيط واضح. أرسلها بصيغة إدخال الصور المقبولة في مسار CometAPI لديك. إذا كان ذلك المسار يدعم إعداد الدقة الأصلي، استخدم match_input للاحتفاظ بإطار وحجم المرجع وفق حدود النموذج في التحرير.
تعرض [معرض BFL](https://bfl.ai/models/flux-3-image) مثال تعديل موضعي بإضافة غواصين اثنين. توضح هذه الأصول الرسمية قبل/بعد ما يجب فحصه؛ إنها ليست مخرجات من طلب CometAPI تم تشغيله لهذا المقال.
مثال تحرير رسمي من BFL، قبل: المشهد الأصلي تحت الماء مع غواص واحد.
مثال تحرير رسمي من BFL، بعد: تمت إضافة غواصين إلى المشهد. افحص الخلفية غير المتغيرة وكذلك المواضيع الجديدة.
### تحرير مراجع متعدد الصور: دمج الأسلوب وهوية المنتج
احتفظ بالمنتج أولاً ومرجع الإضاءة/الأسلوب ثانياً. اضبط PRODUCT_IMAGE_URL وSTYLE_IMAGE_URL، واحفظ الكود أدناه باسم multi_edit.py بجانب ملفات العميل الثلاثة، ثم شغّل python multi_edit.py. يتطلب هذا المثال مساراً يقبل مرجعين على الأقل في images. ابدأ بجسم طلب تحرير بدون حقول مصدر متعارضة. استأنف مهمة محفوظة عبر python poll_download.py multi-edit-task.json.
import json
import os
from pathlib import Path
from submit import submit
from poll import wait_for_image
from download import download_image
Preserve this order: product first, lighting/style second.
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["images"] = [
os.environ["PRODUCT_IMAGE_URL"],
os.environ["STYLE_IMAGE_URL"],
]
payload["prompt"] = (
"Image 1 defines product identity. Image 2 defines lighting and color. "
"Create one promotional image with the exact product from image 1 "
"and the lighting mood of image 2. Preserve product lettering and "
"geometry. Do not copy logos, text, or extra objects from image 2."
)
task_id = submit(payload, "multi-edit-task.json")
print(download_image(wait_for_image(task_id), "multi-edited-product"))
أرفق المرجعين كليهما باستخدام صيغة CometAPI الخاصة بالنموذج. راجع أولاً ما إذا كانت هوية المنتج قد حُفظت؛ ثم قيّم ما إذا كان المرجع الثاني قد أضاف الإضاءة واللون المقصودين. إذا أدخل أيضاً كائنات أو نصوصاً غير مرغوبة، بسّط ذلك المرجع أو اجعل الوصف أكثر صراحة.
## كيف تستخدم صناديق الاحتواء للتحكم في التخطيط
استخدم الصناديق عندما يجب أن يحتل الزجاجة والعنوان مناطق متوقعة. اكتب تسمية مشهد مع معرّف لكل عنصر، ثم ألحِق مصفوفة JSON إلى الوصف. صيغة BFL تستخدم bbox بالترتيب [top, left, bottom, right] على شبكة 0–1000؛ تنتمي الصناديق داخل الوصف، وليس في حقل API منفصل.
المثال أدناه يحجز مساحة لعنوان فوق الزجاجة. احتفظ بإعداد بورتريه في request.json واحفظ هذا الملف باسم layout.py بجانب submit.py. شغّل python layout.py، ثم python poll_download.py layout-task.json. استخدم مساراً يدعم صيغة التخطيط هذه؛ وافحص النتيجة للتحقق مما إذا كانت الزجاجة والعنوان يشغلان المناطق المقصودة.
import json
from pathlib import Path
from submit import submit
caption = (
"A portrait perfume advertisement: an amber bottle <bottle_1> "
"below a headline <title_1>, on a warm beige background."
)
elements = [
{"id": "title_1", "bbox": [80, 120, 220, 880],
"desc": "Dark brown text reading AMBER, centered"},
{"id": "bottle_1", "bbox": [300, 300, 880, 700],
"desc": "One amber glass perfume bottle with a black cap"},
]
payload = json.loads(Path("request.json").read_text(encoding="utf-8"))
payload["prompt"] = caption + " " + json.dumps(elements)
print(submit(payload, "layout-task.json"))
حافظ على تناسق نسبة العرض إلى الارتفاع مع التخطيط. توجه الصناديق التموضع بدلاً من قصّ الكائن إلى حد صارم. افحص تهجئة العنوان وتباعُد الأحرف في الصورة المحفوظة؛ أضف حروف العلامة النهائية في أداة تصميم عندما تكون الطباعة الدقيقة ضرورية.
## كم تبلغ تكلفة FLUX 3 Image API؟
تقدّم CometAPI FLUX 3 Image بدءاً من [$0.0384 لكل طلب](https://www.cometapi.com/models/flux/flux-3-image/) (9 نوفمبر 2026). استخدم هذا المعدّل الابتدائي لميزانية أولية، ثم طبّق السعر الظاهر لتكوينك المختار. تفترض الأمثلة أدناه أن كل طلب مفوتر يستخدم المعدّل الابتدائي.
| الطلبات المفوترة | السعر المفترض/طلب | التكلفة التوضيحية |
| ---------------- | ------------------ | ------------------ |
| 1 | $0.0384 | $0.0384 |
| 10 | $0.0384 | $0.3840 |
| 100 | $0.0384 | $3.84 |
| 1000 | $0.0384 | $38.40 |
تحقّق من السعر لتكوينك وحسابك قبل تنفيذ دفعة. السعر الابتدائي العام لا يحدد سعر كل خيار دقة أو تحرير. تتبّع المحاولات الإبداعية المرفوضة بالإضافة إلى المخرجات المعتمدة: إذا أنفقت $3.84 على 100 طلب مفوتر واعتمدت 80 مخرجاً، فتكلفة API لكل مخرج معتمد هي $0.048، قبل المراجعة البشرية والتخزين. هذا حساب توضيحي، وليس معدل قبول مقاساً.
### خيارات الدقة حسب سير العمل
| سير العمل | الاختبار الأول | فحص الاعتماد |
| --------------------------- | ----------------------------------------------- | ------------------------------------------- |
| استكشاف الوصف | أصغر مستوى مدعوم ومفيد | التكوين وتموضع الموضوع |
| صور منتجات التجارة الإلكترونية | مسودة مع القص المقصود | هندسة المنتج، الملصقات، وتفاصيل الحواف |
| عمل حملات أو أعمال تحريرية | مسودة أولاً؛ إخراج أكبر بعد اعتماد التخطيط | الطباعة والتفاصيل بحجم التسليم |
| تعديلات معتمدة على المراجع | إعداد مدعوم يناسب المصدر | المناطق غير المتغيرة، وهوية المنتج، والإضاءة |
## متى ينبغي استخدام FLUX 3 Video بدلاً من ذلك؟
استخدم FLUX 3 Image للأصول الثابتة مثل صورة بطل المنتج، الملصق، أو إطار الحملة. إذا كان المُخرج يحتاج حركة، انظر [FLUX 3 Video على CometAPI](https://www.cometapi.com/models/flux/flux-3/) المُدرج تحت المعرف المنفصل flux-3. يستخدم [سير عمل الفيديو](https://apidoc.cometapi.com/api/video/flux-3/create) إعدادات وفوترة خاصة بالفيديو. احتفظ بطلبات الصور والفيديو منفصلة؛ مدة التشغيل، والصوت، وعناصر إطارات الفيديو لا تنتمي إلى طلب صورة ثابتة.
من أجل حملة تشمل كلا الصيغتين، اعتمد تكوين الصورة الثابتة أولاً، ثم حضّر موجز الحركة بشكل منفصل. تحقّق من متطلبات إدخال المراجع لنموذج الفيديو قبل إعادة استخدام صورة معتمدة كمصدر.
## الخلاصة
ابدأ بموجز منتج واحد ومهمة صورة صغيرة. أرسلها عبر مسار FLUX 3 Image في CometAPI لديك، احفظ معرّف المهمة، واسترجع الصورة المكتملة، ثم راجع النتيجة قبل التوسّع. استخدم العرض والارتفاع عندما تحتاج لوحة دقيقة، أو match_input لتحرير مرجعي حيثما كان مدعوماً. قارن إجمالي الإنفاق بعدد الصور التي تعتمدها حتى تعكس ميزانيتك النتائج القابلة للاستخدام.
## بيانات تحسين محركات البحث (SEO)
Meta title: FLUX 3 Image API Guide: Generation, Editing & CometAPI
Meta description: استخدم FLUX 3 Image على CometAPI للتوليد والتحرير. تعرّف على معاملات الصورة، التعامل مع المهام غير المتزامنة، أمثلة الأوصاف، وتسعير يبدأ من $0.0384 لكل طلب.
Keywords: FLUX 3 Image API، CometAPI FLUX 3 Image، تحرير صور FLUX 3، تسعير FLUX 3، توليد بالصور المرجعية، ترحيل FLUX.2
URL slug: flux-3-image-api-guide
مفتاح CometAPI API لطلبات البوابة
اتّبع ترويسات المصادقة في مثال CometAPI؛ احتفظ بالمفتاح على الخادم.
التعامل مع النتيجة
توليد غير متزامن: أرسل مهمة، تتبّع معرف المهمة، واسترجع الصورة النهائية.
استخدم قالب Python أدناه عندما يتبع مسار حسابك عقد مهمة FLUX الموثّق في CometAPI.
التسعير
تسعير CometAPI يبدأ من $0.0384 لكل طلب (9 نوفمبر 2026).
استخدم قسم السعر أدناه كميزانية توضيحية؛ تحقّق من التكوين المختار.
حقول إضافية
تختلف المخططات الأصلية ومخططات البوابة عبر أجيال النماذج
FLUX 3 Image الأصلي يقبل width وheight. لا تعِد استخدام seed أو input_image من نموذج أقدم؛ استخدم images للمراجع الأصلية واتّبع مخطط البوابة في CometAPI.
