Zhipu AI: CogVideoX 3
CogVideoX 3 יוצר וידאו מטקסט, מתמונה או מזוג פריימים ראשון ואחרון בתהליך העבודה המתועד של היצרן. הוא תומך ברצפים של חמש או עשר שניות, בכמה גדלי פלט עד 4K, ב-30 או 60 fps ובאפקטים קוליים שנוצרים לפי בחירה.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
CogVideoX 3 הוא מודל הווידאו של Zhipu AI, עם תיעוד ליצירה מטקסט לווידאו, מתמונה לווידאו ומפריימים ראשון ואחרון. היצרן מדגיש יציבות פריימים, ציות להוראות וסגנונות חזותיים מציאותיים או תלת-ממדיים. בחרו טקסט כשהסצנה מתחילה כתיאור כתוב, תמונה אחת כשהבסיס החזותי שלה כבר קיים, או שתי תמונות קצה כשהרצף צריך מבט פתיחה ומבט סיום מוגדרים.
בתיאור טקסט, תארו את הנושא ופעולה אחת ברורה. ציינו את הסביבה, נקודת המבט והיחסים הפיזיים החשובים, כדי שיהיה אפשר להעריך את הסצנה מול כוונה ברורה. דמות המרימה אובייקט דורשת רצף שונה ממצלמה החושפת את האובייקט הזה. תארו את שניהם רק כשהקשר ביניהם חשוב לשוט.
לרצף המבוסס על תמונה, הכינו את תמונת הייחוס כך שהמאפיינים המבדילים של הנושא יהיו גלויים. היצרן מקבל תמונות PNG, JPEG ו-JPG שאינן גדולות מ-5 MB, המסופקות באמצעות כתובת URL או נתוני תמונה מקודדים. שמרו את תמונת הייחוס עצמה לצד התוצאה שנוצרה, כדי שיהיה אפשר להשוות מראה ומסגור למקור ולא לגרסה זכורה שלו.
מצב פריימי הקצה של היצרן מקבל שתי תמונות לפי סדר: הראשונה מגדירה את פריים הפתיחה והשנייה את פריים הסיום. הכינו אותן כשני המצבים המיועדים של שוט אחד. תארו את המעבר או הפעולה המחברים ביניהן, ולאחר מכן בדקו אם הנושא נשאר עקבי בין הקצוות. זוג תמונות סטילס טובות אינו מראה כשלעצמו שהתנועה ביניהן מתאימה לסיפור הרצוי.
הפרומפט יכול להכיל עד 512 תווים. השתמשו בטקסט הזמין לפעולה, לכיוון שלה ולפרטים החזותיים שמבדילים תוצאה מוצלחת. השאירו את התיאור ממוקד במה שצריך להתרחש על המסך. כשהתמונות בקלט כבר מגדירות את מראה הנושא, תארו את התנועה ואת התזמון שצריכים להתפתח בין התמונות האלה או מהן.
היצרן מתעד פלט של חמש או עשר שניות, עם חמש שניות כברירת מחדל, ו-30 או 60 פריימים לשנייה. הגדלים הנתמכים כוללים 1280×720, 720×1280, 1024×1024, 1920×1080, 1080×1920, 2048×1080 ו-3840×2160. בחרו את הגודל והתזמון ליעד השימוש, ולאחר מכן בדקו את הקליפ המוגמר מבחינת מסגור וקצב הפעולה בפועל.
מצבי איכות (Quality) ומהירות (speed) מתועדים בנפרד מהגדרת האפקטים הקוליים האופציונליים של הבינה המלאכותית. שמרו את הבחירות האלה לצד הפרומפט, התמונות והתוצאה. יכולות הראייה והקלט של היצרן מתארות את המודל; הבקרות הזמינות בשיטת יצירה מסוימת נקבעות בחוזה של אותה שיטה. שמרו את ההגדרות ששימשו בפועל כשמשווים שוטים מועמדים.
שמרו את מזהה המשימה המקורי עד להשלמת הווידאו ושמרו את החומר המצולם שהוחזר לעריכה. בדקו את הרצף כולו, לרבות מראה הנושא בתנועה רחבה, אינטראקציות עם אובייקטים בסצנה והקומפוזיציה הסופית. בעבודה עם פריימי קצה, בדקו את שני הקצוות ואת המעבר ביניהם. תקנו את אי-ההתאמה החזותית המסוימת תוך שמירת תמונות הייחוס ותוכנית השוט המוצלחות, והשוו בין סרטוני הווידאו המוגמרים ולא רק בין תמונות התצוגה המקדימה שלהם.
Ailoot Ultra · וידאו POST /v1/videos cogvideox-3
cogvideox-3התחלה
CogVideoX 3 יוצר וידאו מטקסט, מתמונה או מזוג פריימים ראשון ואחרון בתהליך העבודה המתועד של היצרן. הוא תומך ברצפים של חמש או עשר שניות, בכמה גדלי פלט עד 4K, ב-30 או 60 fps ובאפקטים קוליים שנוצרים לפי בחירה.
- סוגי קלט נתמכים
- טקסט
- תוצאות
- וידאו
זמין ב-Ailoot · קלט ושיטות
Ailoot Ultra · וידאו POST /v1/videos
- סוגי קלט
text- סוגי פלט
video
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות cogvideox-3 תנאים: יש להשתמש בבורר המודלים המדויק של Ailoot. | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות תנאים: תארו את הסצנה ואת התנועה. | ברירת מחדל— |
שדהquality | סוגboolean | דרישהרשות | ערכים ומגבלות תנאים: דגל איכות אופציונלי; הסכמה שנבחרה אינה מספקת enum תואם או ברירת מחדל. | ברירת מחדל— |
שדהwith_audio | סוגboolean | דרישהרשות | ערכים ומגבלות תנאים: יצירת אפקטים קוליים באמצעות בינה מלאכותית כשהאפשרות מופעלת. | ברירת מחדלfalse |
שדהsize | סוגstring | דרישהרשות | ערכים ומגבלות תנאים: יש לספק את מחרוזת הגודל המתועדת בבחירת ממדים מפורשים. | ברירת מחדל— |
שדהfps | סוגstring | דרישהרשות | ערכים ומגבלות 30, 60 תנאים: בשיטה המקורית שנבחרה, קצב הפריימים מיוצג כמחרוזת. | ברירת מחדל30 |
שדהduration | סוגstring | דרישהרשות | ערכים ומגבלות 5, 10 תנאים: בשיטה המקורית שנבחרה, המשך בשניות מיוצג כמחרוזת. | ברירת מחדל5 |
פרמטרים ומחזור חיים של השיטה
| פרמטר | מפרט |
|---|---|
פרמטרcontent_type | מפרטapplication/json |
פרמטרrequired | מפרטmodel, prompt |
פרמטרoptional | מפרטquality, with_audio, size, fps, duration |
פרמטרmaterial_types | מפרטtext |
פרמטרconditions | מפרטיש להשתמש בבורר המודלים המדויק של Ailoot., תארו את הסצנה ואת התנועה., דגל איכות אופציונלי; הסכמה שנבחרה אינה מספקת enum תואם או ברירת מחדל., יצירת אפקטים קוליים באמצעות בינה מלאכותית כשהאפשרות מופעלת., יש לספק את מחרוזת הגודל המתועדת בבחירת ממדים מפורשים., בשיטה המקורית שנבחרה, קצב הפריימים מיוצג כמחרוזת., בשיטה המקורית שנבחרה, המשך בשניות מיוצג כמחרוזת. |
כינויים לשיטה: /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.3 לכל בקשה |
| תצורהעלות יצירה משוערת | טבלת תעריפים— | כמות חזויהאומדן ליצירה אחת | כמות החיוב— | חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.3 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה. |
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
דוגמאות לבקשות
Ailoot Ultra · וידאו
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "cogvideox-3",
"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 · וידאו
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 |
שדהid | סוגstring |
שדהtask_status | סוגstring |
שדהvideo_result[].url | סוגstring |
כינויים
כינויים למודל
Ailoot Ultra cogvideox-3
כינויים לנתיבי שיטות
/v1/videos/generations
מזהי מודלים קשורים IDs
FAQ · Zhipu AI: CogVideoX 3
- אילו קלטים ותוצאות זמינים?
POST /v1/videos·cogvideox-3:text→video- באילו שדות הבקשה משתמשת?
POST /v1/videos·cogvideox-3:model,prompt,quality,with_audio,size,fps,duration