PixVerse v5
PixVerse v5 יוצר סרטונים קצרים מטקסט או מתמונות. השתמשו בבריף פעולה מוחשי, בתמונת ייחוס מוכנה לפי הצורך ובבקרי המסגור והרזולוציה המתועדים כדי לפתח סצנה עם סיום שימושי.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
PixVerse v5 הוא מודל וידאו ליצירת וידאו מטקסט ומתמונה. בריף כתוב מגדיר את האירוע, ואילו תמונת ייחוס אופציונלית מספקת את המראה והקומפוזיציה הראשוניים. השתמשו בכל שוט שנוצר למטרה מוגדרת, כגון הצגת נושא, המחשת מחווה או חשיפת פרט חזותי.
תארו את הפעולה במונחים שניתן לראות. יד הפותחת קופסה, דמות החוצה חצר או אובייקט הנע אל האור מעניקים לרצף שינוי שניתן לזהות. ציינו איזה נושא נע, מה נמצא סביבו וכיצד האירוע צריך להסתיים. שמרו על הפרטים שהופכים את הסצנה למזוהה.
ביצירה המבוססת על תמונה, בחרו תמונת ייחוס שכבר מתאימה לקומפוזיציה הרצויה. שמרו על נראות המאפיינים הייחודיים והקצו מקום לתנועה המבוקשת. הסבירו כיצד הסצנה מתפתחת מהתמונה הזו. שמרו את המקור עם הסרטון המוגמר, כדי שאפשר יהיה להעריך רציפות באמצעות השוואה ישירה.
קטלוג המודלים המתועד כולל כמה צורות פריים ואפשרויות רזולוציה, עם אפשרויות משך של חמש ושמונה שניות. בחרו את השילוב המוצע לתהליך ותעדו את הערכים ששימשו בפועל. תכננו את הפעולה ואת הסיום בהתאם לאורך השוט ולפריים היעד שנבחרו.
השתמשו בהנחיות מצלמה כדי לכוון את תשומת הלב. נקודת מבט קבועה יכולה להדגיש את פעולת הנושא, ואילו נקודת מבט נעה יכולה לחשוף סביבה או פרט. הסבירו את היחס של המצלמה לנושא, כדי שהתנועה תשרת את הסצנה. בחנו את הסיום כדי לראות אם הוא משאיר את המידע הרצוי גלוי.
בסדרה של שוטים קשורים, שמרו בבריפים הרלוונטיים על עקביות בתיאורי הנושא והסביבה החוזרים. שמרו כל תמונת ייחוס ואת המודל שנבחר יחד עם התוצאה שלהם. חברו את הקליפים המוגמרים בסדר המתוכנן ובחנו שינויים במראה, בתאורה וביחסים המרחביים לאורך העריכה.
בחנו כל סרטון במלואו מבחינת הפעולה המבוקשת, הרציפות והתזמון. עקבו אחר ידיים, פנים, קווי מתאר של אובייקטים ופרטי חומר כאשר הם חשובים לסצנה. בדקו רגעים שבהם נושאים חופפים או נעים לזווית אחרת. שוט שימושי נשאר ברור גם מעבר לפריים הסטילס המוצלח ביותר שלו.
שמרו את הסרטון המוגמר עם ההנחיה, תמונת המקור וההגדרות. כאשר גרסה דורשת תיקון, הגדירו את אי-ההתאמה המדויקת ושנו את ההוראה הקשורה אליה. שמרו על בחירות הקומפוזיציה והמראה שעבדו היטב, כדי שאפשר יהיה להשוות את התוצאה הבאה מול אותו יעד חזותי.
Ailoot Ultra · Video POST /v1/videos pixverse-v5
pixverse-v5התחלה
PixVerse v5 יוצר סרטונים קצרים מטקסט או מתמונות. השתמשו בבריף פעולה מוחשי, בתמונת ייחוס מוכנה לפי הצורך ובבקרי המסגור והרזולוציה המתועדים כדי לפתח סצנה עם סיום שימושי.
- סוגי קלט נתמכים
- טקסט · תמונות
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · Video POST /v1/videos
- סוגי קלט
text,image- סוגי פלט
video
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות pixverse-v5 תנאים: השתמשו בבורר הניתוב הזה של Ailoot בדיוק כפי שהוא. | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות תנאים: תארו את הסצנה ואת התנועה בה. | ברירת מחדל— |
שדהaspect_ratio | סוגstring | דרישהרשות | ערכים ומגבלות 16:9, 4:3, 1:1, 3:4, 9:16 תנאים: השתמשו באחד מיחסי הרוחב-גובה הרשומים עבור המודל שנבחר. | ברירת מחדל— |
שדהquality | סוגstring | דרישהרשות | ערכים ומגבלות 360p, 540p, 720p, 1080p תנאים: השתמשו בערך האיכות הרשום עבור המודל שנבחר. | ברירת מחדל— |
שדהmotion_mode | סוגstring | דרישהרשות | ערכים ומגבלות normal, fast תנאים: השתמשו במצב התנועה הרשום עבור המודל שנבחר. | ברירת מחדל— |
שדהduration | סוגinteger | דרישהרשות | ערכים ומגבלות 5, 8 תנאים: השתמשו במשך זמן רשום; אין להניח ברירת מחדל שלא צוינה. | ברירת מחדל— |
שדהend_image | סוגstring | דרישהרשות | ערכים ומגבלות תנאים: ציון פריים סיום אופציונלי מוביל לבחירת מצב תמונה נתמך. | ברירת מחדל— |
שדהlip_sync_tts_content | סוגstring | דרישהרשות | ערכים ומגבלות תנאים: תוכן דיבור אופציונלי למודל שנבחר. | ברירת מחדל— |
שדהlip_sync_tts_speaker_id | סוגstring | דרישהרשות | ערכים ומגבלות תנאים: השתמשו במזהה קול אמיתי שהספק תומך בו; אין להמציא מזהה קול. | ברירת מחדל— |
שדהimage | סוגstring or array<string> | דרישהרשות | ערכים ומגבלות תנאים: השתמשו בכתובת URL אמיתית ונגישה לציבור לתמונה שלכם או בתמונה בקידוד base64; המודל שנבחר תומך בקלט תמונה. | ברירת מחדל— |
שדהnegative_prompt | סוגstring | דרישהרשות | ערכים ומגבלות תנאים: תארו תוכן שיש להימנע ממנו. | ברירת מחדל— |
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, prompt |
פרמטרoptional | מפרטaspect_ratio, quality, motion_mode, duration, end_image, lip_sync_tts_content, lip_sync_tts_speaker_id, image, negative_prompt |
פרמטרmaterial_types | מפרטtext, image |
פרמטרconditions | מפרטהשתמשו בבורר הניתוב הזה של Ailoot בדיוק כפי שהוא., תארו את הסצנה ואת התנועה בה., השתמשו באחד מיחסי הרוחב-גובה הרשומים עבור המודל שנבחר., השתמשו בערך האיכות הרשום עבור המודל שנבחר., השתמשו במצב התנועה הרשום עבור המודל שנבחר., השתמשו במשך זמן רשום; אין להניח ברירת מחדל שלא צוינה., ציון פריים סיום אופציונלי מוביל לבחירת מצב תמונה נתמך., תוכן דיבור אופציונלי למודל שנבחר., השתמשו במזהה קול אמיתי שהספק תומך בו; אין להמציא מזהה קול., השתמשו בכתובת URL אמיתית ונגישה לציבור לתמונה שלכם או בתמונה בקידוד base64; המודל שנבחר תומך בקלט תמונה., תארו תוכן שיש להימנע ממנו. |
כינויים לשיטה: /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.2 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "pixverse-v5",
"prompt": "A cat is walking on grass."
}
JSON
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
# Create once; retain id, polling_url, original task identifiers and every 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}/contentGET /v1/media/assetsGET /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 |
כינויים
כינויים למודל
Ailoot Ultra pixverse-v5
כינויים לנתיבי שיטות
/v1/videos/generations
מזהי מודלים קשורים IDs
FAQ · PixVerse v5
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·pixverse-v5:text,image→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·pixverse-v5:model,prompt,aspect_ratio,quality,motion_mode,duration,end_image,lip_sync_tts_content,lip_sync_tts_speaker_id,image,negative_prompt