الإجابة السريعة
FLUX 3 هو نموذج فيديو متعدد الوسائط من Black Forest Labs لتوليد النص إلى فيديو والصورة إلى فيديو مع صوت متزامن. على CometAPI، معرّف النموذج الإنتاجي هو flux-3. يعتمد سير العمل غير المتزامن المُتحقق على POST /v1/videos لإنشاء مهمة، و**GET /v1/videos/{task_id}** للاستطلاع، و**GET /v1/videos/{task_id}/content** لتنزيل ملف MP4 المكتمل.
تحديث التوافر (تم التحقق في 24 سبتمبر 2026): نقلت Black Forest Labs نموذج FLUX 3 Video إلى ما بعد مرحلة الوصول المبكر في يوليو وأتاحت الإصدار الأول من النص إلى فيديو والصورة إلى فيديو بشكل عام عبر BFL API وشركاء مختارين في 4 أغسطس 2026. أضافت CometAPI معرّف النموذج الإنتاجي flux-3 ضمن تنسيق Video API في 13 أغسطس 2026. استخدم إعلان إصدار BFL وصفحة نموذج CometAPI المباشرة كمصدر موثوق للتوافر والحقول والأسعار.
ما الذي تغيّر منذ الوصول المبكر لـ FLUX 3؟
التغيير المهم هو التوافر التشغيلي. ركّزت التغطية المبكرة على إطلاق يوليو القائم على التقديم، لكن إصدار BFL في أغسطس قدّم نقطة نهاية للفيديو قابلة للاستدعاء، وقيودًا منشورة، وتسعيرًا إنتاجيًا. بعد ذلك، أتاحت CometAPI النموذج flux-3 عبر سير عمل Video API الموحّد.
يظل مقال CometAPI السابق، FLUX 3 API: Availability, Early Access, Video & Dev، مفيدًا لتاريخ الإطلاق والتقييم الأولي في يوليو. وتغطي مقارنة Best AI Video APIs in 2026 الأوسع اختيار السوق على المستوى العام. يحافظ هذا الدليل على تلك الموضوعات باختصار ويركّز على الطلبات العملية، والاستطلاع، والمطالبات، والتحكم في التكلفة، والتعامل الإنتاجي.
ما هو FLUX 3؟
FLUX 3 هو عائلة نماذج متعددة الوسائط من BFL للفيديو والصوت والصور والتنبؤات المتعلقة بالإجراء. يدعم الإصدار الحالي للفيديو النص إلى فيديو، الصورة إلى فيديو، واستكمال الفيديو عبر نقطة نهاية واحدة أصلية من المزوّد.
بالنسبة لمطوري الفيديو، القدرات الأبرز تصل إلى 20 ثانية عند 24 إطار/ث، إخراج HD أو Full HD، صوت متزامن، خطاب متعدد اللغات مع مزامنة حركة الشفاه، لقطات متعددة في توليد واحد، وحتى عشرة إطارات رئيسية مثبتة للتحكم في الصورة إلى فيديو.
مواصفات FLUX 3 API
| Specification | BFL official specification | CometAPI integration |
|---|---|---|
| Primary workflows | Text-to-video, image-to-video, video continuation | Text-to-video and image-to-video listed |
| Maximum duration | 5–20 s for T2V/I2V; 5–15 s for V2V | Use live quickstart values for gateway requests |
| Frame rate | 24 fps | Provider output |
| Resolution | rHD natively; FHD through the video upsampler. BFL’s current FLUX 3 Video documentation does not list 4K/UHD output. The “up to 4MP” specification applies to FLUX.2 image models, not FLUX 3 Video. | 720p and 1080p pricing listed |
| Native audio | Yes; enabled by default | Output feature follows the active integration |
| Image control | 1–10 keyframes in native I2V | Verify the current gateway reference-image mapping |
| Aspect ratios | 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16 | Quickstart uses explicit dimensions such as 1280x720 |
| Invocation | Asynchronous | Create → poll → download |
| CometAPI model ID | — | flux-3 |
ما مدى جودة FLUX 3 Video؟
تبلغ BFL عن درجة Elo للنص إلى فيديو قدرها 1135 في تقييم التفضيل البشري الشامل. وفي المقارنة المنشورة نفسها، تعادل FLUX 3 مع Seedance 2.0 في تفضيل الصورة إلى فيديو وتقدم على النماذج الأخرى المختبرة.
تُعد هذه النتائج دليلاً مفيدًا على التموضع، لكنها تقييمات تفضيل بشري يديرها المورّد، وليست معيارًا إنتاجيًا مستقلًا. إنها لا تقيس زمن استجابة البوابة، موثوقية الطابور، اتساق التكلفة، أو استقرار التوليد المتكرر، لذا ينبغي لفرق الإنتاج تقييم مجموعة مطالباتها الخاصة.
أداء معيار FLUX 3
| Metric | Published result | Interpretation |
|---|---|---|
| Text-to-video all-vs-all Elo | 1135 | BFL تقرّ بأن FLUX 3 يتصدر المقارنة الداخلية الخاصة بها |
| Image-to-video preference | Tie with Seedance 2.0 | نتيجة اتجاهية من المورّد، ليست لوحة صدارة من طرف ثالث |
| Evaluation type | Human preference | يقيس الجودة المدركة للمخرجات، لا بنية API التحتية |
المصدر: Black Forest Labs — FLUX 3 Video, Part 1: Generation.
ما الذي تحتاجه قبل استخدام FLUX 3 API
- حساب CometAPI ومفتاح API مخزّن في متغير بيئة على الخادم.
- مطالبة تحدد الموضوع، والحركة، واتجاه الكاميرا، والأجواء، وأي صوت أو حوار مطلوب.
- مسار تعامل مع المهام متين لأن توليد الفيديو غير متزامن.
- رصيد كافٍ للاختبار التكراري؛ يعتمد الفوترة على المدة والدقة المتولدتين.
أنشئ المفتاح في لوحة CometAPI API. لا تضعه في JavaScript الواجهة الأمامية، أو حِزم الهاتف المحمول، أو المستودعات العامة، أو لقطات الشاشة.
معرّف نموذج FLUX 3 ونقاط النهاية
| Operation | Method and endpoint | Purpose |
|---|---|---|
| Create video | POST https://api.cometapi.com/v1/videos | Submit a generation task |
| Check task | GET https://api.cometapi.com/v1/videos/{task\_id} | Read status and progress |
| Download output | GET https://api.cometapi.com/v1/videos/{task\_id}/content | Download the completed MP4 |
كيفية استخدام FLUX 3 API مع CometAPI
الخطوة 1: ضبط مفتاح API
على macOS أو Linux:
export COMETAPI_KEY="your_api_key"
على Windows PowerShell:
$env:COMETAPI_KEY="your_api_key"
الخطوة 2: إنشاء فيديو FLUX 3
يستخدم البدء السريع الحالي لـ FLUX 3 طلب multipart يتضمن model وprompt وseconds وsize. يطلب هذا المثال مقطعًا مدته خمس ثوانٍ بدقة 720p:
curl https://api.cometapi.com/v1/videos \
-H "Authorization: Bearer $COMETAPI_KEY" \
-F "model=flux-3" \
-F "prompt=A paper boat glides across a still pond in soft morning light" \
-F "seconds=5" \
-F "size=1280x720"
يبدأ هذا الطلب مهمة. لا تصمم التطبيق على تلقي ملف MP4 مكتمل في نفس استجابة HTTP.
الخطوة 3: حفظ معرّف المهمة
احتفظ بالمُعرّف مباشرة بعد نجاح طلب الإنشاء:
{
"id": "video_task_id",
"status": "queued"
}
خزّن معرّف المهمة بجانب سجل المستخدم أو المهمة قبل بدء الاستطلاع. لا ينبغي لإعادة تشغيل العملية أن تفقد توليدًا تمّت فوترة تكلفته بالفعل.
الخطوة 4: الاستطلاع عن حالة الفيديو
curl https://api.cometapi.com/v1/videos/{task_id} \
-H "Authorization: Bearer $COMETAPI_KEY"
ابدأ بفاصل زمني معتدل مثل عشر ثوانٍ. اعتبر الحالات completed أو succeeded أو success حالات نجاح نهائية؛ واعتبر failed أو failure أو cancelled أو canceled حالات فشل نهائية.
الخطوة 5: تنزيل ملف MP4
curl https://api.cometapi.com/v1/videos/{task_id}/content \
-H "Authorization: Bearer $COMETAPI_KEY" \
--output flux3_output.mp4
بعد الاكتمال، انسخ الملف إلى تخزين الكائنات أو خط أنابيب الوسائط الخاص بك بدلًا من الاحتفاظ بعنوان URL مؤقت من المزوّد كأصل دائم.
سير عمل Python كامل لتوليد فيديو FLUX 3
ينشئ المثال التالي مهمة، ويحفظ مُعرّفها، ويستطلع حتى الاكتمال، ويتحقق من حالات الفشل، ويتحقق من توقيع MP4، ويكتب الناتج إلى القرص.
import os
import time
from pathlib import Path
import requests
api_key = os.environ["COMETAPI_KEY"]
base_url = "https://api.cometapi.com"
headers = {"Authorization": f"Bearer {api_key}"}
response = requests.post(
f"{base_url}/v1/videos",
headers=headers,
files={
"model": (None, "flux-3"),
"prompt": (
None,
"A product bottle rotates slowly on wet black stone, "
"soft rim lighting, macro lens, realistic reflections.",
),
"seconds": (None, "5"),
"size": (None, "1280x720"),
},
timeout=120,
)
response.raise_for_status()
task = response.json()
data = task.get("data") or {}
task_id = (
task.get("id")
or task.get("task_id")
or data.get("id")
or data.get("task_id")
)
if not task_id:
raise RuntimeError(f"Create response has no task ID: {task}")
while True:
response = requests.get(
f"{base_url}/v1/videos/{task_id}",
headers=headers,
timeout=60,
)
response.raise_for_status()
task = response.json()
data = task.get("data") or {}
status = str(task.get("status") or data.get("status") or "").lower()
progress = task.get("progress") or data.get("progress") or "unknown"
print(f"Status: {status or 'unknown'}; progress: {progress}")
if status in {"failed", "failure", "cancelled", "canceled"}:
raise RuntimeError(f"Video generation failed: {task}")
if status in {"completed", "succeeded", "success"} or progress == "100%":
break
time.sleep(10)
response = requests.get(
f"{base_url}/v1/videos/{task_id}/content",
headers=headers,
timeout=300,
)
response.raise_for_status()
video = response.content
if len(video) < 12 or video[4:8] != b"ftyp":
raise RuntimeError("Content response is not a non-empty MP4 file")
output_dir = Path("output")
output_dir.mkdir(parents=True, exist_ok=True)
output_path = output_dir / f"{task_id}.mp4"
output_path.write_bytes(video)
print(f"Saved: {output_path} ({len(video)} bytes)")
كيفية استخدام الصورة إلى فيديو والإطارات الرئيسية
تسرد صفحة FLUX 3 على CometAPI ميزة الصورة إلى فيديو كقدرة مدعومة. يعرض نموذجها العام الحالي النص إلى فيديو، لذا تحقّق من توثيق البوابة المباشر قبل افتراض أن حقل صورة مرجعية من نموذج آخر سيعمل دون تغيير.
واجهة BFL الأصلية صريحة: يستخدم نمط الصورة إلى فيديو الوضع i2v والحقل keyframes. تثبّت صورة واحدة إطار البداية، ويمكن لصورتين تثبيت البداية والنهاية، وحتى عشر صور مُوقّتة يمكنها رسم مخطط لقطة مستمرة.
مثال إطارات رئيسية أصلي من BFL
curl -X POST https://api.bfl.ai/v1/flux-3-video \
-H "x-key: $BFL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mode": "i2v",
"prompt": "They sprint through the lantern-lit alley as the camera tracks behind them.",
"keyframes": [
[0, "data:image/png;base64,<first-frame>"],
[8, "data:image/png;base64,<last-frame>"]
],
"duration": 8
}'
احتفظ بمعاملات المزوّد الأصلية ومعاملات البوابة في مواءمات منفصلة. تستخدم BFL حقولًا مثل mode وkeyframes وstart_video وresolution وdraft؛ بينما يستخدم نموذج CometAPI المُتحقق model وprompt وseconds وsize.
شرح معاملات FLUX 3 API
| Parameter | API | What it controls | Practical guidance |
|---|---|---|---|
| model | CometAPI | اختيار النموذج | استخدم flux-3 |
| prompt | Both | المشهد، الحركة، الكاميرا، الصوت | صف التغيّر المرئي عبر الزمن |
| seconds | CometAPI sample | طول المقطع المطلوب | ابدأ بـ 5–8 ثوانٍ أثناء الضبط |
| size | CometAPI sample | أبعاد الإخراج | ابدأ بـ 1280x720 لاختبار اقتصادي |
| mode | BFL native | t2v / i2v / v2v / draft_enhance | لا ترسل إلا إذا كانت البوابة تُطابقه |
| duration | BFL native | 5–20 s لـ T2V/I2V؛ 5–15 s لـ V2V | يدعم auto في الواجهة الأصلية |
| resolution | BFL native | hd أو fhd؛ لا يتم حاليًا إدراج 4K/UHD لـ FLUX 3 Video | تُستكمل FHD عبر مُكبّر الفيديو |
| generate_audio | BFL native | تشغيل/إيقاف الصوت المتزامن | القيمة الافتراضية true |
| draft | BFL native | وضع المعاينة السريعة | استخدمه للتكرار الإبداعي الأقل كلفة |
كيفية كتابة مطالبات أفضل لـ FLUX 3
يوصي دليل كتابة مطالبات الفيديو من BFL بتوجيه واضح للموضوع والفعل، الكاميرا، المشهد والأجواء، جودة الحركة، والاستمرارية. للمشاهد المعتمدة على الصوت، حدد الحوار، الصوت، المؤثرات الصوتية، والأجواء.
بنية مطالبة عملية
موضوع + بيئة + فعل + كاميرا + إضاءة
+ حوار/صوت + مؤثرات صوتية + أجواء + قيود
مطالبة سينمائية
A lone cyclist rides through a rain-soaked neon street at midnight.
The camera begins low beside the rear wheel, then rises into a smooth tracking shot.
Reflections stretch across wet asphalt under moving cyan and magenta light.
Audio: steady rainfall, chain noise, distant traffic, no music, no dialogue.
Keep the same rider, bicycle, jacket, and weather throughout the shot.
مطالبة فيديو منتج
A premium stainless-steel espresso machine stands on a dark stone counter.
Begin with a macro close-up of water droplets on the metal housing.
Orbit clockwise as the machine brews; steam catches warm side light.
Finish on a clean three-quarter hero angle with the cup in the foreground.
Audio: pump vibration, steam hiss, ceramic contact, quiet cafe ambience.
Do not change the product shape, logo placement, material, or color.
مطالبة حوار وصوت أصلي
A young chef works alone in a compact Tokyo ramen shop at night.
Start close on boiling broth, then pull back as the chef sets down a bowl.
Warm tungsten lighting, natural reflections, documentary handheld motion.
The chef quietly says in Japanese: 「お待たせしました。」
Audio: bubbling broth, soft rain outside, distant street traffic.
No subtitles and no background music.
تترك مطالبة مثل "make a cinematic ramen shop video" الحركة، التأطير، الصوت، والاستمرارية دون تحديد. يقدّم التوجيه الصريح موجزًا إنتاجيًا أكثر قابلية للاختبار.
تسعير FLUX 3 API
تسعير BFL خاص بسير العمل: تكلف عمليات توليد النص إلى فيديو والصورة إلى فيديو الكاملة $0.17/s في HD أو $0.29/s في FHD، مع وضع المسودة HD بسعر $0.06/s. يكلف استكمال الفيديو $0.43/s في HD أو $0.54/s في FHD، مع مسودات HD بسعر $0.12/s. تسرد CometAPI حاليًا flux-3 بسعر $0.136/s لدقة 720p و$0.232/s لدقة 1080p. تحقّق من الأسعار المباشرة قبل تنفيذ دفعات كبيرة.
| Provider / workflow | HD / 720p full | FHD / 1080p full | Draft | 5 s full render | 10 s full render |
|---|---|---|---|---|---|
| BFL T2V | $0.17/s | $0.29/s | $0.06/s (HD) | $0.85 / $1.45 | $1.70 / $2.90 |
| BFL I2V | $0.17/s | $0.29/s | $0.06/s (HD) | $0.85 / $1.45 | $1.70 / $2.90 |
| BFL V2V continuation | $0.43/s | $0.54/s | $0.12/s (HD) | $2.15 / $2.70 | $4.30 / $5.40 |
| CometAPI flux-3 | $0.136/s | $0.232/s | Not listed | $0.68 / $1.16 | $1.36 / $2.32 |
قراءة العمودين الأخيرين: تُعرض القيم لـ HD/720p أولًا ثم FHD/1080p ثانيًا.
كيفية خفض تكاليف التكرار
- نمذج على 720p قبل نقل مطالبة مختارة إلى 1080p.
- استخدم لقطات من خمس ثوانٍ للتحقق من التكوين، والحركة، وتفسير المطالبة.
- غيّر متغير مطالبة رئيسيًا واحدًا في كل مرة.
- عند استخدام واجهة BFL الأصلية، اختبر وضع المسودة قبل التصيير الكامل الجودة.
- خزّن المطالبات الناجحة وقرارات المرجع في بيانات وصفية للتطبيق.
FLUX 3 مقابل Wan 3.0 مقابل Seedance 2.5
قارن بين FLUX 3 وWan 3.0 وSeedance 2.5 حسب سير العمل عوضًا عن البحث عن فائز شامل واحد. تبقى روابط المواصفات المعتمدة في رأس الجدول أدناه.
| Dimension | FLUX 3 Official specs | Wan 3.0 Official specs | Seedance 2.5 Official specs |
|---|---|---|---|
| Maximum clip length | Up to 20 s T2V/I2V | Up to 30 s | Up to 30 s |
| Synchronized audio | Yes | Yes | Yes |
| Text-to-video | Yes | Yes | Yes |
| Image-to-video | Yes | Yes | Yes |
| Reference strategy | Up to 10 native keyframes | Broad multimodal and Omni-Reference workflow | Large multimodal reference capacity |
| Continuation/editing | Native BFL v2v continuation | Long-form and editing workflows | Extension and editing workflows |
| Distinctive strength | Motion logic, multi-shot scenes, synchronized audiovisual output | Input breadth and 30-second generation | Long storytelling and reference-heavy control |
| CometAPI starting price | $0.136/s | $0.04/s | $0.0824/s |
| Best fit | Cinematic or realistic audiovisual shots | All-in-one multimodal production pipelines | Longer, identity-controlled storytelling |
ملاحظة التسعير: لا تُعد الأسعار الابتدائية مقارنة متكافئة للجودة أو الدقة. استخدم جدول الدقة الخاص بكل صفحة نموذج مباشرةً للتخطيط المالي.
أي Video API يجب أن تختار؟
- اختر FLUX 3 للّقطات السمعية البصرية الواقعية الحركة، والصوت المتزامن، ومنطق اللقطات المتعددة، والإطارات الرئيسية الأصلية، أو الاستكمال.
- اختر Wan 3.0 عندما يبدأ سير العمل بأنواع إدخال عديدة وتهم نافذة توليد 30 ثانية.
- اختر Seedance 2.5 للسرد الأطول المعتمد بكثافة على المراجع مع تحكم قوي في الهوية، والمنتج، والأسلوب.
أفضل ممارسات الإنتاج لـ FLUX 3 API
تخزين المهام غير المتزامنة كحالة متينة
احفظ معرّف المهمة مباشرة بعد الإرسال. لا ينبغي لإعادة تشغيل الخادم أو إعادة محاولة العامل أن تجبر المستخدم على الدفع لتوليد آخر لأن التطبيق فقد المهمة الأصلية.
تجنّب الاستطلاع المكثّف
ابدأ بالقرب من فاصل عشر ثوانٍ ما لم يوصِ التوثيق المباشر بغير ذلك. الاستطلاع كل ثانية يزيد ضغط الطلبات دون تحسين مادي للتجربة.
تحقّق من التنزيل
تحقق من طول المحتوى وتوقيع MP4 قبل وضع علامة اكتمال للأصل. لا تُثبت الاستجابة الناجحة لـ HTTP دائمًا أن الجسم ملف فيديو صالح.
افصل بين المخططات الأصلية ومخططات البوابة
حافظ على مواءمات منفصلة لطلبات BFL الأصلية وCometAPI. يمنع ذلك الحقول الأصلية مثل mode وkeyframes وstart_video من التسرب إلى استدعاء بوابة يتوقع model وprompt وseconds وsize.
خزّن سياق الفشل الكامل
سجّل حالة HTTP، وجسم الاستجابة، ومُعرّف المهمة، ومُعرّف النموذج، وإصدار المطالبة، والحجم، والمدة، ومُعرّف المهمة الداخلي. أخفِ مفتاح API.
استخدم مجموعة تقييم صغيرة قبل الإطلاق
ابنِ 10–30 مطالبة تمثيلية تغطي حركة الكاميرا، الأشخاص، المنتجات، الطباعة، الحوار، المشاهد عالية الحركة، ونِسَب الأبعاد المطلوبة. شغّل المجموعة نفسها عند تغيّر إصدار النموذج أو التكامل، وكرر المطالبات المهمة لأن توليد الفيديو احتمالي.
الأسئلة الشائعة
ما هو معرّف نموذج FLUX 3 على CometAPI؟
أي نقطة نهاية تستخدمها FLUX 3 على CometAPI؟
سير عمل Video API المُتحقق يستخدم POST /v1/videos، يليه GET /v1/videos/{task_id} وGET /v1/videos/{task_id}/content.
هل FLUX 3 متزامن؟
لا. تعامل معه كـ مهمة غير متزامنة: أرسل، احفظ معرّف المهمة، استطلع، ثم نزّل.
ما هي مدة التوليد الممكنة في FLUX 3؟
توثّق BFL مدة 5–20 s لـ T2V/I2V و5–15 s للاستكمال.
هل تُولّد FLUX 3 صوتًا؟
نعم. توثّق BFL صوتًا متزامنًا مفعّلًا افتراضيًا في واجهتها الأصلية.
هل تدعم FLUX 3 الصورة إلى فيديو؟
نعم. تسرد CometAPI دعم الصورة إلى فيديو، بينما تنفّذه واجهة BFL الأصلية عبر وضع i2v وkeyframes.
هل يمكنني استخدام إطارات BFL الرئيسية عبر CometAPI دون تغيير؟
لا تفترض ذلك. تختلف مخططات الطلب؛ تحقّق من البدء السريع الحالي لـ CometAPI قبل إطلاق سير عمل صورة مرجعية عبر البوابة.
كم تبلغ كلفة فيديو FLUX 3 لمدة خمس ثوانٍ على CometAPI؟
بالأسعار المدرجة حاليًا على CometAPI، تكلف خمس ثوانٍ $0.68 عند 720p أو $1.16 عند 1080p. راجع جدول التسعير الموحّد أعلاه للرابط المرجعي المباشر.
هل FLUX 3 أفضل من Wan 3.0 أو Seedance 2.5؟
يعتمد ذلك على سير العمل. FLUX 3 جذاب للّقطات السمعية البصرية المنسجمة الحركة وللتحكم الأصلي بالإطارات الرئيسية أو الاستكمال؛ بينما يركز Wan 3.0 على اتساع المدخلات؛ ويركّز Seedance 2.5 على سرد أطول مع تحكم مرجعي مكثف.
الخلاصة
FLUX 3 يمتلك الآن مسار Video API غير متزامن عامل على CometAPI، بينما يكشف توثيق BFL الأصلي عناصر تحكم أعمق للإطارات الرئيسية، والاستكمال، والصوت، ووضع المسودة.
مسار تكامل آمن مباشر: ابدأ بطلب نص إلى فيديو قصير بدقة 720p، احفظ معرّف المهمة، استطلع بتحفّظ، نزّل وتحقق من ملف MP4، ثم أضف قوالب المطالبات، والتخزين، ومنطق إعادة المحاولة، ومجموعة تقييم قابلة للتكرار. افصل بين المخططات الأصلية ومخططات البوابة، وتحقق من صفحة النموذج المباشرة قبل ترميز الحقول أو الأسعار بشكل ثابت.