מודלים

Runway Gen 3 Turbo

Markdown · JSON

Runway Gen 3 Turbo

Runway Gen 3 Turbo יוצר וידאו עם בקרות תמונה והנחיית תנועה. בחרו שוט של חמש או עשר שניות ושמרו את בקשת Ailoot המקורית לצורך קבלת התוצאה שהושלמה.

על המודל

התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.

בחרו runway-gen3-turbo ב־/v1/videos. הבקשה מציעה image כמחרוזת או כמערך של עד עשר מחרוזות, prompt, ‏end_image ומשך של חמש או עשר שניות. הכינו את החומר המצורף ואת ההכוונה הכתובה סביב תנועה מבוקרת מתוך הקומפוזיציה המצורפת.

ציינו אילו פרטים של הנושא השוט צריך לשמר ומה צריך להשתנות לאורך הזמן. תנו למצלמה כיוון ברור ותארו את מצב הסיום המיועד. שוט מוצר יכול להשתמש בחשיפה הדרגתית; רגע של דמות יכול להשתמש במחווה ובתנוחת סיום. שמרו יחד את תמונת הקלט שנבחרה, תמונת הסיום האופציונלית ותדריך התנועה להשוואה לקטע המוגמר.

שלחו את השוט פעם אחת דרך /v1/videos, שמרו את מזהה הבקשה שהוחזר ובדקו את אותה פעולה מקורית דרך /v1/videos/{request_id}. שמרו את כל פלטי הווידאו שהושלמו ואת התשובה המלאה לפני בדיקת הפעולה, המסגור ומצב הסיום מול התדריך.

Ailoot Ultra · Video POST /v1/videos runway-gen3-turbo

runway-gen3-turbo

אחר /runway-gen3-turbo

התחלה

Runway Gen 3 Turbo יוצר וידאו עם בקרות תמונה והנחיית תנועה. בחרו שוט של חמש או עשר שניות ושמרו את בקשת Ailoot המקורית לצורך קבלת התוצאה שהושלמה.

סוגי קלט נתמכים
טקסט · תמונות
תוצאות
וידאו

זמין ב-Ailoot · קלט ושיטות

Ailoot Ultra · Video POST /v1/videos
סוגי קלט
text, image
סוגי פלט
video
שדהסוגדרישהערכים ומגבלותברירת מחדל
שדהmodelסוגstringדרישהחובהערכים ומגבלות
runway-gen3-turbo
תנאים: השתמשו בבורר הניתוב הזה של Ailoot בדיוק כפי שהוא.
ברירת מחדל—
שדהdurationסוגintegerדרישהרשותערכים ומגבלות
⁦5⁩, ⁦10⁩
תנאים: השתמשו בשדה המתועד עבור המודל שנבחר ובאפשרויות הרשומות; השמיטו ערך אופציונלי שלא צוין.
ברירת מחדל—
שדהend_imageסוגstringדרישהרשותערכים ומגבלות
תנאים: השתמשו בשדה המתועד עבור המודל שנבחר ובאפשרויות הרשומות; השמיטו ערך אופציונלי שלא צוין.
ברירת מחדל—
שדהimageסוגstring or array<string>דרישהרשותערכים ומגבלות
תנאים: ספקו כתובת URL אמיתית ונגישה לתמונה שלכם. רשימה מתקבלת רק כאשר סכמת הפרמטר מציינת מערך.
ברירת מחדל—
שדהnegative_promptסוגstringדרישהרשותערכים ומגבלות
תנאים: השתמשו בשדה המתועד עבור המודל שנבחר ובאפשרויות הרשומות; השמיטו ערך אופציונלי שלא צוין.
ברירת מחדל—
שדהpromptסוגstringדרישהרשותערכים ומגבלות
תנאים: השתמשו בשדה המתועד עבור המודל שנבחר ובאפשרויות הרשומות; השמיטו ערך אופציונלי שלא צוין.
ברירת מחדל—
פרמטרים ומחזור חיים של השיטה
פרמטרמפרט
פרמטרcontent_typeמפרטapplication/json
פרמטרrequiredמפרטmodel
פרמטרoptionalמפרטduration, end_image, image, negative_prompt, prompt
פרמטרmaterial_typesמפרטtext, image
פרמטרconditionsמפרטהשתמשו בבורר הניתוב הזה של Ailoot בדיוק כפי שהוא., השתמשו בשדה המתועד עבור המודל שנבחר ובאפשרויות הרשומות; השמיטו ערך אופציונלי שלא צוין., השתמשו בשדה המתועד עבור המודל שנבחר ובאפשרויות הרשומות; השמיטו ערך אופציונלי שלא צוין., ספקו כתובת URL אמיתית ונגישה לתמונה שלכם. רשימה מתקבלת רק כאשר סכמת הפרמטר מציינת מערך., השתמשו בשדה המתועד עבור המודל שנבחר ובאפשרויות הרשומות; השמיטו ערך אופציונלי שלא צוין., השתמשו בשדה המתועד עבור המודל שנבחר ובאפשרויות הרשומות; השמיטו ערך אופציונלי שלא צוין.

כינויים לשיטה: /v1/videos/generations

מחזור חיים: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

תעריפים

אופן חישוב החיוב הסופי

התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.

מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.

מצב מהיר
לא צוין כאשר נבחר מצב מהיר
מצב Flex
לא צוין כאשר נבחר מצב flex
מאמץ חשיבה מרבי
לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)

תעריפים משוערים להשוואה

מחירים לפי תצורה

התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.

תצורהטבלת תעריפיםכמות חזויהכמות החיובחיוב
תצורהתעריפי בסיס לטוקניםטבלת תעריפיםתעריף בסיסכמות חזויה—כמות החיוב—חיוב
קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים
פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים
קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים
קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים
קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים
תצורהלכל בקשהטבלת תעריפים—כמות חזויה—כמות החיובבקשה אחתחיוב
קלט · אומדן להשוואה בלבד $0.5 לכל בקשה
תצורהעלות יצירה משוערתטבלת תעריפים—כמות חזויהאומדן ליצירה אחתכמות החיוב—חיוב
פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.5 אומדן לפני היצירה

אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.

לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →

דוגמאות לבקשות

Ailoot Ultra · Video

curl · צרו פעם אחת ושמרו את התוצאה המלאהקראו את המשימה המקוריתשמרו כל נכס שהושלם ונמצא בבעלותכם
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "runway-gen3-turbo", "image": "YOUR_ACCESSIBLE_IMAGE_URL"}')
p['image']=os.environ['AILOOT_IMAGE_URL']
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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
# Submit once. Retain the complete result, original identifiers and every response header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
    raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
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())
roles={}
def visit(v,path=""):
    if isinstance(v,dict):
        for k,x in v.items(): visit(x,path+"/"+k)
    elif isinstance(v,list):
        for i,x in enumerate(v): visit(x,path+"/"+str(i))
    elif isinstance(v,str):
        u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
        if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
            roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
    target=Path(f"asset-{i}.bin")
    subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
    raw=target.read_bytes()
    if not raw: raise SystemExit("Empty asset; retain original status and metadata")
    ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
    name=f"asset-{i}.{ext}"
    if target.name!=name: target.rename(name)
    manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS

קבלה ושמירה של תוצאות

Ailoot Ultra · Video

  • GET /v1/videos/{request_id}
  • GET /v1/videos/generations/{request_id}
  • GET /v1/videos/{request_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
שמירת כל התוצאות שהושלמו

שמרו כל וידאו שהושלם או קובץ שהוחזר; אחזרו כל נכס מכל URL שהוחזר בפועל.

יש לשמור את התגובה המלאה ואת הכותרות, המזהים המקוריים, כל פלט ממשי ואת כל שדות השימוש והחיוב. יש לשמור כל נכס ייחודי שבבעלותכם ואת כל התפקידים המפנים אליו.

כשצריך לבדוק את התגובה המקורית

יש לשמור את מזהה המשימה הציבורי או מזהה הפעולה שהוחזרו ואת כל הכותרות. יש לקרוא רק את המשימה המקורית; unknown או result_pending_check אינם מתירים יצירה נוספת.

שדות התגובה
שדהסוג
שדהidסוגstring
שדהpolling_urlסוגstring
שדהprovider_task_idסוגstring
שדהtask_idסוגstring
שדהstatusסוגstring
שדהvideo_urlסוגstring
שגיאות והשלבים הבאים
תגובהתנאיהשלב הבא
תגובה⁦400⁩ · invalid_request_errorתנאישדה חובה, בורר המודל, סוג או ייצוג הקלט אינם תקינים.השלב הבאבדקו את פרטי האימות שהוחזרו לפני הכנת בקשה נפרדת.
תגובהתנאיהבקשה המקורית או התוצאה אינן ידועות או דורשות בדיקה.השלב הבאשמרו את המזהים והכותרות המקוריים; קראו רק רשומות נתמכות של מצב או ספרייה. אל תשלחו שוב בקשת יצירה.

כינויים

כינויים למודל

Ailoot Ultra runway-gen3-turbo

כינויים לנתיבי שיטות

/v1/videos/generations

מזהי מודלים קשורים IDs

runway-gen3-turbo

FAQ · Runway Gen 3 Turbo
אילו קלטים ותוצאות זמינים?

POST /v1/videos · runway-gen3-turbo: text, image → video

באילו שדות הבקשה משתמשת?

POST /v1/videos · runway-gen3-turbo: model, duration, end_image, image, negative_prompt, prompt

פרטים נוספים

חברו Ailoot ל- Claude Code, OpenCode, Hermes או ליישום שלכם.

החברה ופורטפוליו הפרויקטים שלה

החברה ופורטפוליו הפרויקטים שלה: מיליוני לקוחות; מכירות בהיקף של מיליארדים מדי חודש.

קנו אסימונים בהנחה.

הנחת מנוי לעבודה קבועה. קודי הנחה עד 50% על רכישת אסימונים.

מנוי
בחרו מסלול עם הנחה לבקשות הקבועות שלכם.
קוד הנחה עד 50%
הזינו קוד ברכישה. המחיר יחושב מחדש לפי המבצע הפעיל.
הוצאות בהיסטוריה
המודל, האסימונים והסכום נשמרים לכל בקשה.

בחירת מנוי · מחירי מודלים

חברו API למוצר שאתם מוכרים.

SaaS, יישומים ובוטים לפי ההצעה והסכם הרישוי של Ailoot. למכירה מחדש בקשו רישיון משווק.

יישום מסחרי
שלבו יצירת טקסט, תמונות, וידאו ושמע בתכונות בתשלום של השירות שלכם.
רישיון למכירה מחדש
שלחו תיאור פרויקט ואופן מתן גישה. בקשו תנאי שימוש ומכירה מחדש בכתב.
מסמכים באתר
ההצעה, הסכם הרישוי ומדיניות עיבוד הנתונים זמינים לפני החיבור.

בקשת רישיון למכירה מחדש · ההצעה והסכם הרישוי