Zhipu AI: CogVideoX 2
يولّد CogVideoX 2 فيديو من وصف نصي أو صورة مقدمة. وتوثق الشركة المصنّعة أحجام إطارات قابلة للاختيار و30 أو 60 fps ووضعَي الجودة أو السرعة ومؤثرات صوتية مولدة اختيارية لتشكيل مشهد مرئي قصير.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
CogVideoX 2 هو نموذج توليد فيديو من Zhipu AI لوصف مشهد مكتوب أو صورة مقدمة. يحدد النص الموضوع والمكان والفعل؛ ويمكن لصورة أن توفر الأساس المرئي للتسلسل المولد. استخدم الإدخال الذي يمثل بأفضل صورة المادة المتاحة أصلًا للّقطة، ثم صف الحركة المرئية التي ينبغي أن يتضمنها الفيديو المكتمل.
للإنشاء الموجّه بالنص، حدد حدثًا واحدًا متسقًا. فشخص يفتح باب ورشة، أو قارب صغير يمر بجوار رصيف، أو جسم يدور تحت إضاءة ثابتة، يمنح كل منها اللقطة غرضًا واضحًا. اذكر سمات الموضوع المهمة وزاوية الرؤية واتجاه الحركة. واختر نهاية تصلح للمونتاج المقصود بدلًا من ترك التكوين النهائي للمشهد دون تحديد.
للإنشاء القائم على صورة، جهّز منظرًا واضحًا للموضوع وصف كيف ينبغي أن يتحرك المشهد انطلاقًا منه. تقبل الشركة المصنّعة مراجع PNG وJPEG وJPG بحجم يصل إلى 5 MB، مقدمة عبر رابط صورة أو بيانات صورة مرمّزة. وأبقِ الحواف المهمة وملامح الوجه وتفاصيل الأجسام ظاهرة في المرجع، واترك داخل التكوين مساحة للفعل المطلوب.
تحدد الشركة المصنّعة طول الموجّه المكتوب بـ 512 محرفًا. استخدم هذه المساحة للتفاصيل الحاسمة: الموضوع والفعل والمكان وزاوية الرؤية. ويسهل تقييم وصف قصير يوضح الجسم المتحرك وما يبقى ثابتًا أكثر من قائمة صفات أسلوبية عامة. وإذا لم تحقق النتيجة الهدف، فعدّل التعليمات المرتبطة بمشكلة الحركة أو التأطير الملحوظة.
تشمل أحجام الإخراج المنشورة صيغًا مربعة وأفقية وعمودية، مع خيارات تتدرج من 720×480 إلى 3840×2160 بكسل. وتوثق الشركة المصنّعة أيضًا 30 أو 60 إطارًا في الثانية. اختر الشكل ومعدل الإطارات وفق وجهة الاستخدام قبل التوليد، ثم افحص المقطع الفعلي لمعرفة ما إذا كان الموضوع وتفاصيله المهمة يظلان واضحين في ذلك التأطير.
الجودة (Quality) والسرعة (speed) وضعا إخراج مسمّيان في مسار العمل لدى الشركة المصنّعة. وتُضبط المؤثرات الصوتية الاختيارية المولدة بالذكاء الاصطناعي بصورة مستقلة عن الوصف المرئي. احتفظ بالوضع المختار وإعداد المؤثرات الصوتية مع الموجّه وأي صورة مرجعية حتى يمكن مقارنة المقاطع المرشحة المختلفة باستخدام إعدادات توليدها الفعلية.
التوليد غير متزامن: يُعاد معرّف مهمة قبل توفر الفيديو المكتمل. احتفظ بهذا المعرّف خلال التحقق من النتيجة، واحفظ جميع ملفات الفيديو المكتملة المرتبطة بالعملية. واحفظ المقطع نفسه للتحرير، مع الصورة المصدرية عند استخدامها، بدلًا من الاعتماد على موقع نتيجة مؤقت أو إطار معاينة.
راجع التسلسل كله للتحقق من الاستمرارية والتوقيت والفعل المطلوب. تحتاج لقطة منتج إلى ثبات الشكل وتفاصيل المادة أثناء الحركة؛ وتحتاج لقطة شخصية إلى مظهر وإيماءات متسقة. تحقق من التكوين النهائي وأي صوت مولد وفق غرض اللقطة. احتفظ بعناصر المشهد الناجحة عند تعديل فرق ملموس، واستخدم شروط المشاهدة نفسها لمقارنة الفيديو الأصلي بالفيديو المنقح.
Ailoot Ultra · فيديو POST /v1/videos cogvideox-2
cogvideox-2البداية
يولّد CogVideoX 2 فيديو من وصف نصي أو صورة مقدمة. وتوثق الشركة المصنّعة أحجام إطارات قابلة للاختيار و30 أو 60 fps ووضعَي الجودة أو السرعة ومؤثرات صوتية مولدة اختيارية لتشكيل مشهد مرئي قصير.
- المدخلات المقبولة
- النص
- النتائج
- فيديو
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · فيديو POST /v1/videos
- الإدخال
text- الإخراج
video
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود cogvideox-2 الشروط: استخدم محدِّد نموذج Ailoot الدقيق. | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود الشروط: صِف المشهد والحركة. | القيمة الافتراضية— |
الحقلquality | النوعboolean | المتطلباختياري | القيم والحدود الشروط: خيار جودة اختياري؛ ولا يحدد هذا المخطط المختار تعداداً متوافقاً أو قيمة افتراضية. | القيمة الافتراضية— |
الحقل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 الدقيق., صِف المشهد والحركة., خيار جودة اختياري؛ ولا يحدد هذا المخطط المختار تعداداً متوافقاً أو قيمة افتراضية., ولّد مؤثرات صوتية بالذكاء الاصطناعي عند تفعيل هذا الخيار., قدّم سلسلة المقاس الموثّقة عند اختيار أبعاد صريحة., يُمثَّل معدل الإطارات كسلسلة نصية في هذه الطريقة الأصلية المختارة., تُمثَّل المدة بالثواني كسلسلة نصية في هذه الطريقة الأصلية المختارة. |
الأسماء البديلة للطريقة: /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
- أقصى جهد للاستدلال
- غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال
تعرفات تقديرية للمقارنة
الأسعار حسب الإعدادات
طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.
| الإعدادات | جدول التعرفة | الكمية المتوقعة | كمية الفوترة | الرسوم |
|---|---|---|---|---|
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الكمية المتوقعة— | كمية الفوترة— | الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز |
| الإعداداتلكل طلب | جدول التعرفة— | الكمية المتوقعة— | كمية الفوترةطلب واحد | الرسوم الإدخال · تقدير للمقارنة فقط $0.2 لكل طلب |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | كمية الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.2 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · فيديو
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}/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-2
الأسماء البديلة لمسارات الطرائق
/v1/videos/generations
معرّفات النماذج ذات الصلة IDs
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