Zhipu AI: CogVideoX 3
CogVideoX 3 ishlab chiqaruvchi hujjatlashtirgan jarayonda matn, tasvir yoki birinchi va oxirgi kadr juftligidan video yaratadi. U besh yoki o‘n soniyali ketma-ketliklar, 4K gacha bir nechta chiqish o‘lchami, 30 yoki 60 fps va ixtiyoriy yaratiladigan ovoz effektlarini qo‘llab-quvvatlaydi.
Model haqida
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
CogVideoX 3 — Zhipu AI’ning matndan video, tasvirdan video va birinchi hamda oxirgi kadr asosida yaratish imkoniyatlari hujjatlashtirilgan video modeli. Ishlab chiqaruvchi kadr barqarorligi, ko‘rsatmalarga amal qilish va realistik yoki uch o‘lchamli vizual uslublarga urg‘u beradi. Sahna yozma topshiriqdan boshlansa matnni, vizual asos allaqachon mavjud bo‘lsa bitta tasvirni, ketma-ketlikka aniq boshlanish va yakuniy ko‘rinish kerak bo‘lsa ikkita chegara kadr tasvirini tanlang.
Matnli topshiriqda obyekt va bitta tushunarli harakatni tavsiflang. Sahnani aniq niyatga nisbatan baholash mumkin bo‘lishi uchun muhit, kuzatish nuqtasi va muhim jismoniy munosabatlarni ko‘rsating. Obyektni ko‘tarayotgan personaj bilan obyektni ochib ko‘rsatadigan kamera turli ketma-ketliklarni talab qiladi. Ikkalasini faqat o‘zaro munosabati kadr uchun muhim bo‘lsa tavsiflang.
Tasvir asosidagi ketma-ketlik uchun namunani obyektning ajralib turadigan xususiyatlari ko‘rinadigan qilib tayyorlang. Ishlab chiqaruvchi URL yoki kodlangan tasvir ma’lumoti orqali beriladigan, 5 MB dan katta bo‘lmagan PNG, JPEG va JPG tasvirlarini qabul qiladi. Ko‘rinish va kadrlashni esda qolgan variant bilan emas, manbaning o‘zi bilan solishtirish uchun haqiqiy namunani yaratilgan natija bilan saqlang.
Ishlab chiqaruvchining chegara kadrlar rejimi ikkita tasvirni tartib bilan qabul qiladi: birinchisi boshlang‘ich, ikkinchisi yakuniy kadrni belgilaydi. Ularni bitta kadrning mo‘ljallangan ikki holati sifatida tayyorlang. Ularni bog‘laydigan o‘tish yoki harakatni tavsiflang, keyin chegaraviy holatlar orasida obyekt izchil qolishini tekshiring. Ikkita yaxshi harakatsiz tasvir o‘z-o‘zidan oradagi harakat kerakli voqeaga mosligini ko‘rsatmaydi.
Prompt 512 tagacha belgi bo‘lishi mumkin. Mavjud matn joyini harakat, uning yo‘nalishi va muvaffaqiyatli natijani ajratib turadigan vizual detallarga sarflang. Topshiriqni ekranda nima bo‘lishi kerakligiga qarating. Kirish tasvirlari obyekt ko‘rinishini allaqachon belgilagan bo‘lsa, shu tasvirlardan yoki ular orasida rivojlanishi kerak bo‘lgan harakat va vaqt taqsimotini tavsiflang.
Ishlab chiqaruvchi besh yoki o‘n soniyali chiqishni, standart holatda besh soniyani va soniyasiga 30 yoki 60 kadrni hujjatlashtiradi. Qo‘llab-quvvatlanadigan o‘lchamlar: 1280×720, 720×1280, 1024×1024, 1920×1080, 1080×1920, 2048×1080 va 3840×2160. Maqsadli foydalanishga mos o‘lcham va davomiylikni tanlang, so‘ng tayyor klipda kadrlash va haqiqiy harakat sur’atini tekshiring.
Sifat va tezlik rejimlari ixtiyoriy AI ovoz effekti sozlamasidan alohida hujjatlashtirilgan. Bu tanlovlarni prompt, tasvirlar va natija bilan saqlang. Ishlab chiqaruvchining vizual va kirish imkoniyatlari modelni tavsiflaydi; muayyan yaratish metodining mavjud boshqaruvlari o‘sha metod shartnomasida beriladi. Nomzod kadrlarni solishtirishda haqiqatan ishlatilgan sozlamalarni saqlang.
Video tayyor bo‘lguncha asl vazifa identifikatorini saqlang va qaytarilgan videoni montaj uchun asrang. Butun ketma-ketlikni, jumladan katta harakat paytidagi obyekt ko‘rinishi, sahna buyumlari bilan o‘zaro ta’siri va yakuniy kompozitsiyani tekshiring. Chegara kadrlar bilan ishlaganda ikkala chekka holat va ular orasidagi o‘tishni ko‘rib chiqing. Muvaffaqiyatli namunalar va kadr rejasini saqlagan holda aniq vizual nomuvofiqlikni tuzating, faqat oldindan ko‘rish tasvirlarini emas, tayyor videolarni solishtiring.
Ailoot Ultra · Video yaratish POST /v1/videos cogvideox-3
cogvideox-3Boshlash
CogVideoX 3 ishlab chiqaruvchi hujjatlashtirgan jarayonda matn, tasvir yoki birinchi va oxirgi kadr juftligidan video yaratadi. U besh yoki o‘n soniyali ketma-ketliklar, 4K gacha bir nechta chiqish o‘lchami, 30 yoki 60 fps va ixtiyoriy yaratiladigan ovoz effektlarini qo‘llab-quvvatlaydi.
- Qabul qilinadigan kirish ma’lumotlari
- Matn
- Natijalar
- Video
Ailoot da mavjud · kirish ma’lumotlari va usullar
Ailoot Ultra · Video yaratish POST /v1/videos
- Kirish
text- Chiqish
video
| Maydon | Tur | Talab | Qiymatlar va cheklovlar | Standart |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar cogvideox-3 Shartlar: Ailoot ning aniq model tanlagichidan foydalaning. | Standart— |
Maydonprompt | Turstring | TalabMajburiy | Qiymatlar va cheklovlar Shartlar: Sahna va harakatni tasvirlang. | Standart— |
Maydonquality | Turboolean | TalabIxtiyoriy | Qiymatlar va cheklovlar Shartlar: Ixtiyoriy sifat bayrog‘i; tanlangan bu sxemada mos enum yoki standart qiymat berilmagan. | Standart— |
Maydonwith_audio | Turboolean | TalabIxtiyoriy | Qiymatlar va cheklovlar Shartlar: Yoqilganda AI ovoz effektlarini yarating. | Standartfalse |
Maydonsize | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Shartlar: Aniq o‘lchamlarni tanlaganda hujjatdagi o‘lcham satrini bering. | Standart— |
Maydonfps | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar 30, 60 Shartlar: Tanlangan ushbu asl usulda kadrlar tezligi satr ko‘rinishida beriladi. | Standart30 |
Maydonduration | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar 5, 10 Shartlar: Tanlangan ushbu asl usulda soniyalardagi davomiylik satr ko‘rinishida beriladi. | Standart5 |
Usul parametrlari va hayot sikli
| Parametr | Parametr talablari |
|---|---|
Parametrcontent_type | Parametr talablariapplication/json |
Parametrrequired | Parametr talablarimodel, prompt |
Parametroptional | Parametr talablariquality, with_audio, size, fps, duration |
Parametrmaterial_types | Parametr talablaritext |
Parametrconditions | Parametr talablariAiloot ning aniq model tanlagichidan foydalaning., Sahna va harakatni tasvirlang., Ixtiyoriy sifat bayrog‘i; tanlangan bu sxemada mos enum yoki standart qiymat berilmagan., Yoqilganda AI ovoz effektlarini yarating., Aniq o‘lchamlarni tanlaganda hujjatdagi o‘lcham satrini bering., Tanlangan ushbu asl usulda kadrlar tezligi satr ko‘rinishida beriladi., Tanlangan ushbu asl usulda soniyalardagi davomiylik satr ko‘rinishida beriladi. |
Usul taxalluslari: /v1/videos/generations
Hayot sikli: 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}
Tariflar
Yakuniy to‘lov qanday hisoblanadi
Ko‘rsatilgan tariflar xarajatni generatsiyadan oldin taxminiy hisoblash uchun xizmat qiladi. Yakuniy to‘lov dastlabki generatsiya uchun qayd etilgan xarajat asosida hisoblanadi. Natijaning o‘lchangan davomiyligi va oldindan taxmin qilingan miqdorlar haq undiriladigan yakuniy miqdor hisoblanmaydi.
Tarif ma’lumotlari so‘rov imkoniyatlarini qo‘shmaydi. Qo‘llab-quvvatlanadigan parametrlar tanlangan usulda ko‘rsatilgan.
- Tezkor rejim
- Ko‘rsatilmagan Tezkor rejim tanlanganda
- Flex rejimi
- Ko‘rsatilmagan flex rejimi tanlanganda
- Maksimal fikrlash darajasi
- Ko‘rsatilmagan Maksimal fikrlash darajasi uchun standart (default) tuzatish qo‘llanganda
Taqqoslash uchun taxminiy tariflar
Sozlamalar bo‘yicha narxlar
Har bir to‘lovni ko‘rsatilgan shartlarga moslang. Har bir muqobil sozlamalar to‘plami uchun bitta tarifdan foydalaning.
| Sozlama | Tariflar jadvali | Prognoz miqdori | Hisoblanadigan miqdor | To‘lov |
|---|---|---|---|---|
| SozlamaTokenlar uchun bazaviy tariflar | Tariflar jadvaliAsosiy tarif | Prognoz miqdori— | Hisoblanadigan miqdor— | To‘lov Kirish · Kirish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Chiqish · Chiqish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshdan o‘qish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish, 1 soat · Faqat taqqoslash uchun taxmin — / 1K token |
| SozlamaHar bir so‘rov uchun | Tariflar jadvali— | Prognoz miqdori— | Hisoblanadigan miqdorbitta so‘rov | To‘lov Kirish · Faqat taqqoslash uchun taxmin $0.3 har bir so‘rov uchun |
| SozlamaYaratishning taxminiy qiymati | Tariflar jadvali— | Prognoz miqdoribir generatsiya uchun taxmin | Hisoblanadigan miqdor— | To‘lov Chiqish · Yaratishning taxminiy narxi · Faqat taqqoslash uchun taxmin $0.3 yaratishdan oldingi taxmin Bu taxmin qo‘shimcha to‘lov ham, tugallangan generatsiya uchun qat’iy tarif ham emas. |
Ailoot so‘rovdan oldin taxminiy summani band qiladi. Natijadan keyin o‘lchangan sarf asosidagi yakuniy to‘lovni yechadi. Oqimli javob bo‘yicha yakuniy hisob-kitob yakuniy sarf yozuviga asoslanadi. Summani band qilish va to‘lovni hisoblash tartibi →
So‘rov namunalari
Ailoot Ultra · Video yaratish
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
Natijalarni olish va saqlash
Ailoot Ultra · Video yaratish
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}
Barcha tayyor natijalarni saqlash
Har bir tayyor video yoki qaytarilgan faylni saqlang; har bir haqiqatan qaytarilgan material URL dan kontentni oling.
To‘liq javob va sarlavhalarni, dastlabki identifikatorlarni, har bir haqiqiy chiqishni va barcha foydalanish/hisob-kitob maydonlarini saqlang. Egalik qilinadigan har bir noyob aktivni saqlang va unga ishora qiluvchi har bir vazifani saqlab qoling.
Asl javobni tekshirish kerak bo‘lsa
Qaytarilgan ochiq vazifa yoki operatsiya id sini va barcha sarlavhalarni saqlang. Faqat dastlabki vazifani o‘qing; unknown yoki result_pending_check boshqa yaratish so‘roviga ruxsat bermaydi.
Javob maydonlari
| Maydon | Tur |
|---|---|
Maydonid | Turstring |
Maydonpolling_url | Turstring |
Maydonprovider_task_id | Turstring |
Maydonid | Turstring |
Maydontask_status | Turstring |
Maydonvideo_result[].url | Turstring |
Taxalluslar
Model taxalluslari
Ailoot Ultra cogvideox-3
Usul yo‘llari taxalluslari
/v1/videos/generations
Chaqirish uchun tegishli ID lar
FAQ · Zhipu AI: CogVideoX 3
- Qanday kirish ma’lumotlari va natijalar mavjud?
POST /v1/videos·cogvideox-3:text→video- So‘rov qaysi maydonlardan foydalanadi?
POST /v1/videos·cogvideox-3:model,prompt,quality,with_audio,size,fps,duration