מודלים

Zhipu AI: CogVideoX 2

Markdown · JSON

Zhipu AI: CogVideoX 2

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

על המודל

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

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

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

ליצירה המבוססת על תמונה, הכינו מבט ברור על הנושא ותארו כיצד הסצנה צריכה לנוע ממנו. היצרן מקבל תמונות ייחוס בפורמטי PNG, JPEG ו-JPG עד 5 MB, המסופקות באמצעות כתובת URL לתמונה או נתוני תמונה מקודדים. השאירו קצוות חשובים, תווי פנים ופרטי אובייקטים גלויים בתמונת הייחוס, והשאירו מקום בקומפוזיציה לפעולה המבוקשת.

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

גדלי הפלט שפורסמו כוללים פורמטים ריבועיים, אופקיים ואנכיים, עם אפשרויות הנעות מ-720×480 ועד 3840×2160 פיקסלים. היצרן מתעד גם 30 או 60 פריימים לשנייה. בחרו את הצורה ואת קצב הפריימים ליעד השימוש לפני היצירה, ולאחר מכן בדקו את הקליפ בפועל כדי לראות אם הנושא והפרטים החשובים שלו נשארים ברורים במסגור הזה.

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

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

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

Ailoot Ultra · וידאו POST /v1/videos cogvideox-2

cogvideox-2

Zhipu AI /cogvideox-2

התחלה

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

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

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

Ailoot Ultra · וידאו POST /v1/videos
סוגי קלט
text
סוגי פלט
video
שדהסוגדרישהערכים ומגבלותברירת מחדל
שדהmodelסוגstringדרישהחובהערכים ומגבלות
cogvideox-2
תנאים: יש להשתמש בבורר המודלים המדויק של 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.2 לכל בקשה
תצורהעלות יצירה משוערתטבלת תעריפים—כמות חזויהאומדן ליצירה אחתכמות החיוב—חיוב
פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.2 אומדן לפני היצירה

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

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

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

Ailoot Ultra · וידאו

curl · צרו פעם אחת ושמרו את אישור הפעולהקראו את המשימה המקוריתשמרו כל נכס שהושלם ונמצא בבעלותכם
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "cogvideox-2",
  "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}/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
שדהidסוגstring
שדהtask_statusסוגstring
שדהvideo_result[].urlסוגstring

כינויים

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

Ailoot Ultra cogvideox-2

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

/v1/videos/generations

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

cogvideox-2

FAQ · Zhipu AI: CogVideoX 2
אילו קלטים ותוצאות זמינים?

POST /v1/videos · cogvideox-2: text → video

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

POST /v1/videos · cogvideox-2: model, prompt, quality, with_audio, size, fps, duration

פרטים נוספים

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

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

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

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

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

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

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

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

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

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

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