Zhipu AI: CogVideoX 3
ينشئ CogVideoX 3 فيديو من نص أو صورة أو زوج إطاري بداية ونهاية ضمن مسار العمل الموثق لدى الشركة المصنّعة. ويدعم تسلسلات من خمس أو عشر ثوانٍ وعدة أحجام إخراج تصل إلى 4K و30 أو 60 fps ومؤثرات صوتية مولدة اختيارية.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
CogVideoX 3 هو نموذج الفيديو لدى Zhipu AI، مع مسارات موثقة لتوليد فيديو من نص أو صورة أو إطاري بداية ونهاية. وتبرز الشركة المصنّعة ثبات الإطارات واتباع التعليمات والأساليب المرئية الواقعية أو ثلاثية الأبعاد. اختر النص عندما يبدأ المشهد بوصف مكتوب، وصورة واحدة عندما يكون أساسه المرئي موجودًا، أو صورتين طرفيتين عندما يحتاج التسلسل إلى منظر افتتاحي وآخر ختامي محددين.
لوصف نصي، صف الموضوع وفعلًا واحدًا واضحًا. اذكر المكان وزاوية الرؤية والعلاقات المكانية المهمة حتى يمكن تقييم المشهد وفق قصد واضح. فشخصية تلتقط جسمًا تحتاج إلى تسلسل مختلف عن كاميرا تكشف ذلك الجسم. ولا تصف الاثنين معًا إلا حين تكون علاقتهما مهمة للّقطة.
لتسلسل قائم على صورة، جهّز المرجع بحيث تظهر السمات المميزة للموضوع. تقبل الشركة المصنّعة صور PNG وJPEG وJPG لا يتجاوز حجمها 5 MB، مقدمة عبر رابط أو بيانات صورة مرمّزة. احتفظ بالمرجع الفعلي مع النتيجة المولدة حتى يمكن مقارنة المظهر والتأطير بالمصدر، وليس بنسخة تتذكرها منه.
يقبل وضع الإطارات الطرفية لدى الشركة المصنّعة صورتين بالترتيب: تحدد الأولى إطار الافتتاح، وتحدد الثانية إطار النهاية. جهّزهما كحالتي البداية والنهاية المقصودتين للّقطة نفسها. صف الانتقال أو الفعل الذي يربطهما، ثم راجع ما إذا كان الموضوع يظل متسقًا بين الطرفين. فصورتان ثابتتان جيدتان لا تثبتان وحدهما أن الحركة بينهما تناسب القصة المطلوبة.
يمكن أن يتضمن الموجّه ما يصل إلى 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 | المتطلباختياري | القيم والحدود الشروط: خيار جودة اختياري؛ ولا يحدد هذا المخطط المختار تعداداً متوافقاً أو قيمة افتراضية. | القيمة الافتراضية— |
الحقل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.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