Black Forest Labs: FLUX.3 Video
FLUX 3 Video יוצר קטעים עם דיאלוג, אפקטים ואווירה מסונכרנים מטקסט, מתמונות נעוצות או מקטע להמשך. פריימי מפתח, קומפוזיציה מרובת שוטים ושיפור טיוטה מסייעים לפתח רצף מבוקר ולשמר את הביצוע שנבחר.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
FLUX 3 Video הוא המודל הרב־מודאלי של Black Forest Labs ליצירת וידאו עם שמע מסונכרן. הוא יוצר סצנות מבריף טקסטואלי, בונה תנועה סביב תמונות נעוצות או ממשיך קטע קיים. דיבור, אפקטים ואווירה יכולים להיווצר יחד עם הפריימים, ולתמוך בסצנה קצרה שתנועת המצלמה, הפעולה והצליל שלה מתוכננים כרצף אחד.
בטקסט־לווידאו, תארו את הנושא, הסביבה, הפעולה הנראית, התנהגות המצלמה והצליל. סצנת מוצר שימושית יכולה להתחיל במבט רחב, להתקרב לפרט חומר ולהסתיים במוצר בשימוש. בריפים מרובי שוטים יכולים לנקוב בכל שוט ובמעבר בין זוויות מצלמה, תוך שימור עקביות הנושא והסגנון החזותי לאורך הרצף. טיפוגרפיה יכולה להופיע בתוך הסצנה, ולכן ספקו את המילים המדויקות ואת מיקומן כאשר שלט או כותרת חשובים. המודל מכסה צילום חי, אנימציה, גרפיקה בתנועה ומראות מסוגננים.
תמונה־לווידאו משתמש באחת עד עשר תמונות פריימי מפתח. תמונה יחידה קובעת את פריים הפתיחה; צמד מקבע את ההתחלה והסיום, ואילו תמונות מסודרות עם חותמות זמן מנחות רגעים מסוימים בקטע. תמונות אלו נעשות פריימים בסרטון ולא משמשות רק כדוגמאות סגנון כלליות. עם שלוש תמונות או יותר ללא חותמות זמן, היצרן דורש משך מפורש: הראשונה והאחרונה מקבעות את נקודות הקצה, והאחרות ממוקמות במרווחים שווים ביניהן. פריימים מתוזמנים חייבים להיות בסדר זמן; משך אוטומטי מגיע עד חותמת הזמן האחרונה המעוגלת כלפי מעלה, בתוך מקסימום 20 השניות. הכינו פריימי מפתח בעלי נושאים, מסגור ופרטים חזותיים תואמים, ואז תארו את התנועה ביניהם. בחשיפת מוצר, הפריים הראשון יכול להציג חפץ סגור והאחרון את הסידור הפתוח, עם הגדרת הפעולה שביניהם בהנחיה.
המשך וידאו מתחיל מהפריימים האחרונים של הקטע שסופק. תהליך ההשקה משתמש בעד ארבע שניות של וידאו ושמע קיימים כהקשר לפעולה הבאה, ומעביר התנהגות מצלמה, תנועה וצליל מעבר לתפר. בחרו סיום מקור הקובע בבירור לאן הנושא והמצלמה נעים, ותארו מה קורה בהמשך. המשך שונה משכתוב שוט קיים: FLUX Video Edit הוא מודל עריכה נפרד, ואינו נעשה חלק ממודל היצירה רק משום ששניהם מקבלים וידאו.
יצירה המותנית בטקסט ובתמונה תומכת בקטעים של 5 עד 20 שניות. הסקירה לפי מצב מעניקה להמשך וידאו טווח פלט של 5–15 שניות. משך ויחס ממדים יכולים להיבחר אוטומטית, או שהבריף יכול לציין צורה אופקית, ריבועית או אנכית נתמכת, לרבות 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16 ו־9:21. הפלט הוא 24 פריימים לשנייה. בחרו את משך הקטע לפי מספר קטן של פעולות נראות במקום לנסות לדחוס סיפור שלם ליצירה קצרה אחת.
פלט HD מגיע ישירות מהיצירה; FHD, QHD ו־UHD משלימים את אותה סצנה באמצעות מגדיל וידאו. ביחס 16:9, הממדים שנמסרים הם 1280 × 704, 1920 × 1088, 2560 × 1440 ו־3840 × 2176 בהתאמה. הממדים מיושרים לכפולות של 32, ולכן מחלקת רזולוציה נקובה עשויה להיות שונה מגודל מסירה מקובל. חתכו את הפריים המוגמר כאשר נחוץ משטח תקני מדויק, תוך שימור התוכן החשוב בשוליו. הרזולוציה הגבוהה יותר היא שלב גימור ולא פרשנות אחרת לשוט.
שמע מקורי מופעל כברירת מחדל וניתן לכיבוי לקבלת קטע אילם. בדיאלוג, צטטו את השורה, זהו את הדובר ותארו את הגשתה; דיבור רב־לשוני, מבטאים וסנכרון שפתיים הם חלק מיכולות השמע־וידאו של המודל. קשרו דיאלוג ורמזי צליל לאירוע הנראה, כגון סגירת מכסה או צעדים המתרחקים. בדקו את הקול, התזמון והמילים המדוברות יחד עם התמונה, במקום להתייחס לצליל כשכבה לא קשורה המתווספת לאחר היצירה.
מצב Draft מפיק תצוגת HD מקדימה וחבילת טיוטה. שפרו את החבילה שנבחרה כדי לרנדר את היצירה ההיא באיכות מלאה; שליחת אותה הנחיה כבקשת רינדור מלא חדשה היא פרשנות חדשה ויכולה להפיק ביצוע אחר. טיוטות משתמשות ב־HD בלבד, ואילו שיפור יכול לבחור בין ארבע מחלקות הרזולוציה ומוגדר כברירת מחדל ל־FHD. כך מתקבל רצף מעשי של חקירת הפעולה והקומפוזיציה תחילה, ואז השלמת הביצוע שנבחר בגודל המסירה המיועד.
תהליך היצרן מחזיר מזהה משימה לפני שה־MP4 מוכן, ואז מספק את הקטע שהושלם עם סיום העיבוד. מיקומי התוצאה החתומים פגים אחרי כשעתיים, ולכן שמרו את הנכס עצמו לאחר בחירת השוט. בדקו את מעברי פריימי המפתח, החיתוכים, הטיפוגרפיה, פרטי הנושא ותפר השמע מול הבריף. לרצף ארוך יותר, שמרו את דוגמאות השוט המוצלח ואת הקשר הסיום שלו כקלט לקטע הבא, במקום להניח שבקשה קצרה אחת מכילה את ההפקה כולה.
Ailoot Ultra · וידאו POST /v1/videos black-forest-labs/flux-3-video
black-forest-labs/flux-3-video
black-forest-labs/flux-3-videoהתחלה
FLUX 3 Video יוצר קטעים עם דיאלוג, אפקטים ואווירה מסונכרנים מטקסט, מתמונות נעוצות או מקטע להמשך. פריימי מפתח, קומפוזיציה מרובת שוטים ושיפור טיוטה מסייעים לפתח רצף מבוקר ולשמר את הביצוע שנבחר.
- סוגי קלט נתמכים
- טקסט · תמונות
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · וידאו POST /v1/videos
- סוגי קלט
text,image- סוגי פלט
video- פורמט פלט
- הבתים המקוריים של MP4; ללא נרמול או המרת קידוד
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות black-forest-labs/flux-3-video | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות | ברירת מחדל— |
שדהduration | סוגinteger | דרישהחובה | ערכים ומגבלות 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 מינימום: 1 מקסימום: 600 | ברירת מחדל— |
שדהresolution | סוגstring | דרישהרשות | ערכים ומגבלות 720p, 1080p | ברירת מחדל— |
שדהaspect_ratio | סוגstring | דרישהרשות | ערכים ומגבלות 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | ברירת מחדל— |
שדהgenerate_audio | סוגboolean | דרישהרשות | ערכים ומגבלות false, true | ברירת מחדל— |
שדהframe_images | סוגarray | דרישהרשות | ערכים ומגבלות מספר פריטים מזערי: 1 מספר פריטים מרבי: 2 תוכן הקלט: מערך אובייקטים של פריימים. כל אובייקט כולל type=image_url, שדה image_url המכיל url, ו־frame_type. יש להשתמש בכתובת URL של תמונה ב־HTTPS ולהגדיר frame_type לערך first_frame או last_frame. כל תפקיד של פריים מופיע פעם אחת לכל היותר. מפתחות מדויקים: type, image_url, frame_type תנאים: המפתחות האלה מתארים כל אובייקט פריים; image_url מכיל רק url. יש להשמיט frame_images בבקשה המבוססת על טקסט בלבד. | ברירת מחדל— |
שדהinput_references | סוגarray | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שדהprevious_job_id | סוגstring | דרישהרשות | ערכים ומגבלות תבנית: ^video_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ | ברירת מחדל— |
שדהcallback_url | סוגstring | דרישהרשות | ערכים ומגבלות תבנית: ^https:// | ברירת מחדל— |
שדהsession_id | סוגstring | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שדהtrace | סוגobject | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שדהuser | סוגstring | דרישהרשות | ערכים ומגבלות | ברירת מחדל— |
שילובים של חומרי קלט
מטקסט לווידאו · הנחיה כתובה. · נדרש: model, prompt, duration
יש לספק prompt כטקסט ו־duration בשניות שלמות. יש לבחור רזולוציה נתמכת ובמידת הצורך גם יחס גובה־רוחב.
model: סוג: string · black-forest-labs/flux-3-video
prompt: סוג: string · מספר בייטים מרבי ב-UTF-8: 10,000 · נדרשים תווים שאינם רווחים: כן
מתמונה לווידאו · הנחיה כתובה ותמונה של הפריים הראשון. · נדרש: model, prompt, duration, frame_images
frame_images הוא מערך. כל אובייקט פריים כולל type, image_url ו־frame_type; השדה image_url מכיל url. יש להגדיר type לערך image_url. יש להשתמש ב־first_frame, עם last_frame אופציונלי. כל תפקיד של פריים מופיע פעם אחת לכל היותר. יש לספק כתובת URL ציבורית של תמונה ב־HTTPS לכל פריים. יש לבחור רזולוציה נתמכת ובמידת הצורך גם יחס גובה־רוחב.
המפתחות המדויקים: type, image_url, frame_type
model: סוג: string · black-forest-labs/flux-3-video
prompt: סוג: string · מספר בייטים מרבי ב-UTF-8: 10,000 · נדרשים תווים שאינם רווחים: כן
Continue a video · הנחיה כתובה והווידאו המקורי שלכם שהושלם. · נדרש: model, prompt, duration, previous_job_id
הגדירו previous_job_id למזהה הווידאו הציבורי של המקור שלכם שהושלם. יש להשתמש באותו מודל, חשבון ומפתח API. יש לשמור את זהות המשימה הקיימת שלו; הבקשה הזו יוצרת משימת המשך נפרדת. יש לבחור רזולוציה נתמכת ובמידת הצורך גם יחס גובה־רוחב.
model: סוג: string · black-forest-labs/flux-3-video
prompt: סוג: string · מספר בייטים מרבי ב-UTF-8: 10,000 · נדרשים תווים שאינם רווחים: כן
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, prompt, duration |
פרמטרmaterial_types | מפרטtext, image |
פרמטרadditional_properties | מפרטfalse |
פרמטרoptional_controls | מפרטresolution, aspect_ratio, generate_audio, frame_images, input_references, previous_job_id, callback_url, session_id, trace, user |
מחזור חיים: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
תעריפים
אופן חישוב החיוב הסופי
התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.
מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.
- מצב מהיר
- לא צוין כאשר נבחר מצב מהיר
- מצב Flex
- לא צוין כאשר נבחר מצב flex
- מאמץ חשיבה מרבי
- לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)
תעריפים משוערים להשוואה
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | טבלת תעריפים | כמות חזויה | רכיב חיוב | מצב ייחוס | יחידת חיוב | תנאי חיוב | חיוב |
|---|---|---|---|---|---|---|---|
| תצורהתעריפי בסיס לטוקנים | טבלת תעריפיםתעריף בסיס | כמות חזויה— | רכיב חיוב— | מצב ייחוס— | יחידת חיוב— | תנאי חיוב— | חיוב קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים |
| תצורהוידאו מטקסט · וידאו מתמונה (תמונות פריימים) · תעריף ייחוס | טבלת תעריפים— | כמות חזויה— | רכיב חיובreference_output_rate | מצב ייחוסמטקסט לווידאו · מתמונות לווידאו (תמונות פריימים) | יחידת חיובלכל שניית פלט | תנאי חיוב— | חיוב פלט · תעריף ייחוס לשניית וידאו בפלט · אומדן להשוואה בלבד $0.34 לכל שניית פלט |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | רכיב חיוב— | מצב ייחוס— | יחידת חיובלכל שניית וידאו | תנאי חיובresolution: 1080p | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.58 לכל שניית וידאו |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | רכיב חיוב— | מצב ייחוס— | יחידת חיובלכל שניית וידאו | תנאי חיובresolution: 720p | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.34 לכל שניית וידאו |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | רכיב חיוב— | מצב ייחוס— | יחידת חיובלכל שניית וידאו | תנאי חיובקלט: video_continuation; רזולוציה: 1080p | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $1.06 לכל שניית וידאו |
| תצורהמחיר וידאו | טבלת תעריפים— | כמות חזויה— | רכיב חיוב— | מצב ייחוס— | יחידת חיובלכל שניית וידאו | תנאי חיובקלט: video_continuation; רזולוציה: 720p | חיוב פלט · מחיר וידאו · אומדן להשוואה בלבד $0.82 לכל שניית וידאו |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | רכיב חיוב— | מצב ייחוס— | יחידת חיוב— | תנאי חיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $1.7 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
פרטי תעריף הייחוס
טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה.
הפניות למחירי תצורות וידאו
מחירים לפי תצורה
התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.
| תצורה | תנאי חיוב | חיוב |
|---|---|---|
| תצורהמחיר וידאו | תנאי חיובלא הוגדר תנאי נוסף במפתח תמחור זה. | חיוב פלט · מחיר וידאו $0.34 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובresolution: 720p | חיוב פלט · מחיר וידאו $0.34 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובresolution: 1080p | חיוב פלט · מחיר וידאו $0.58 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובקלט: video_continuation; רזולוציה: 720p | חיוב פלט · מחיר וידאו $0.82 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
| תצורהמחיר וידאו | תנאי חיובקלט: video_continuation; רזולוציה: 1080p | חיוב פלט · מחיר וידאו $1.06 לכל שניית וידאו מחיר הייחוס שפורסם עבור התצורה המוצגת. החיובים הסופיים נקבעים לפי התצורה שחויבה בפועל. |
דוגמאות לבקשות
Ailoot Ultra · וידאו
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"black-forest-labs/flux-3-video","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
קבלה ושמירה של תוצאות
Ailoot Ultra · וידאו
כתובות חתומות לתוכן שבבעלותכם
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
בדיקת מצב המשימה
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
קריאות תוכן נוספות
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
שמירת כל התוצאות שהושלמו
שמרו כל וידאו שהושלם או קובץ שהוחזר; אחזרו כל נכס מכל URL שהוחזר בפועל.
יש לשמור כל פלט ממשי שבבעלותכם ואת המטא־נתונים המדודים שהוחזרו איתו.
כשצריך לבדוק את התגובה המקורית
503 result_pending_check + originalid + X-Should-Retry:false; אין לשלוח שוב את הבקשה המקורית
שדות התגובה
| שדה | סוג | משמעות |
|---|---|---|
שדהindex | סוגinteger | משמעותמיקום הווידאו הזה ברשימת הפלטים, בספירה המתחילה מאפס. |
שדהcontent_url | סוגstring | משמעותכתובת URL חתומה להורדת הווידאו שהושלם ב־HTTPS. |
שדהsha256 | סוגstring | null | משמעותתקציר SHA-256 של בתי הווידאו המקורי; null אם אינו זמין. |
שדהsize_bytes | סוגinteger | null | משמעותגודל קובץ הווידאו המקורי בבתים; null אם אינו זמין. |
שדהduration_ms | סוגinteger | null | משמעותמשך הווידאו המדוד באלפיות שנייה; null אם אינו זמין. |
שדהwidth | סוגinteger | null | משמעותרוחב הווידאו בפיקסלים; null אם אינו זמין. |
שדהheight | סוגinteger | null | משמעותגובה הווידאו בפיקסלים; null אם אינו זמין. |
שדהvideo_codec | סוגstring | null | משמעותמזהה מקודד הווידאו; null אם לא נרשם. |
שדהhas_audio | סוגboolean | null | משמעותהאם הווידאו מכיל רצועת אודיו; null אם לא נמדד. |
שדהaudio_codec | סוגstring | null | משמעותמזהה מקודד האודיו; null כאשר לא נרשם מזהה. |
שגיאות והשלבים הבאים
| תגובה | תנאי | השלב הבא |
|---|---|---|
תגובה404 · not_found_error | תנאיהגישה לווידאו אינה זמינה, או שמזהה הווידאו הזה לא נמצא. | השלב הבאיש לבדוק את הגישה לווידאו. עבור וידאו קיים, יש להשתמש במזהה הציבורי המקורי שלו ובאותו מפתח API. |
תגובה401 · authentication_error | תנאימפתח ה־API אינו תואם לחשבון המאומת. | השלב הבאיש לבדוק את מפתח ה־API ואת הגישה לחשבון לפני השליחה. |
תגובה400 · invalid_request_error | תנאילא ניתן היה לקרוא את הבקשה, או שאינדקס ההורדה אינו תקף. | השלב הבאיש לתקן את גוף הבקשה. להורדה, יש לבחור אינדקס פלט שהוחזר על ידי המשימה המקורית. |
תגובה422 · price_unavailable | תנאילא ניתן לתמחר את תצורת הווידאו שנבחרה. | השלב הבאיש לבחור תצורת וידאו נתמכת ולהשלים את האפשרויות הנדרשות בה לפני שליחת בקשה מתוקנת. |
תגובה422 · invalid_request_error | תנאיקלט וידאו או משימת המשך מקורית אינם תקפים. | השלב הבאיש להשתמש בקלטי HTTPS תקפים. להמשך, יש להשתמש במזהה הציבורי של הווידאו המקורי שלכם שהושלם, עם אותו מפתח API. |
תגובה402 · billing_error | תנאיהיתרה הזמינה או המגבלות אינן מאפשרות לשריין סכום. | השלב הבאיש לבדוק את היתרה הזמינה ואת המגבלות לפני שליחת בקשה חדשה. |
תגובה503 · server_error | תנאיאימות הווידאו, האחסון או הגישה לשירות אינם זמינים זמנית. | השלב הבאיש להמתין לזמינות השירות. אם כבר יש לכם מזהה וידאו, יש לבדוק את המשימה המקורית הזו במקום ליצור וידאו נוסף. |
תגובה503 · result_pending_check | תנאייש לבדוק את תוצאת הווידאו המקורית ואת החיוב. | השלב הבאיש לשמור את מזהה הווידאו שהוחזר ולבדוק את המשימה הזו. אין לשלוח בקשת יצירה חלופית בזמן הבדיקה. |
תגובה503 · owned_result_unavailable | תנאיהורדת הווידאו הקיים אינה זמינה זמנית. | השלב הבאיש לבדוק את אותה משימת וידאו בהמשך ולהוריד את הפלט הקיים שלה. יצירה חדשה יוצרת פעולה נפרדת. |
תגובה409 · video_not_ready | תנאיתוכן הווידאו לא פורסם. | השלב הבאיש לבדוק את הסטטוס של המשימה המקורית. יש להוריד לאחר שהיא מדווחת completed; אם היא מדווחת failed, יש לפעול לפי ההודעה שלה על בדיקת החיוב. |
כינויים
כינויים למודל
Ailoot Ultra black-forest-labs/flux-3-video
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · Black Forest Labs: FLUX.3 Video
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·black-forest-labs/flux-3-video:text,image→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·black-forest-labs/flux-3-video:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,previous_job_id,callback_url,session_id,trace,user- אילו מגבלות חלות?
POST /v1/videos·black-forest-labs/flux-3-video:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1