Zhipu AI: CogVideoX 2
CogVideoX 2 matnli tavsif yoki berilgan tasvirdan video yaratadi. Ishlab chiqaruvchi qisqa vizual sahnani shakllantirish uchun tanlanadigan kadr o‘lchamlari, 30 yoki 60 fps, sifat yoki tezlik rejimlari va ixtiyoriy yaratiladigan ovoz effektlarini hujjatlashtiradi.
Model haqida
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
CogVideoX 2 — Zhipu AI’ning yozma sahna tavsifi yoki berilgan tasvirdan video yaratadigan modeli. Matn obyekt, muhit va harakatni belgilaydi; tasvir yaratiladigan ketma-ketlikka vizual asos bera oladi. Kadr uchun mavjud materialni eng yaxshi ifodalaydigan kirishni tanlang, so‘ng tayyor videoda bo‘lishi kerak bo‘lgan ko‘rinadigan harakatni tavsiflang.
Matn asosida yaratishda bitta izchil hodisani belgilang. Ustaxona eshigini ochayotgan odam, bandargoh ko‘prigi yonidan o‘tayotgan kichik qayiq yoki barqaror yorug‘likda aylanayotgan obyekt kadrga tushunarli maqsad beradi. Muhim obyekt xususiyatlari, kuzatish nuqtasi va harakat yo‘nalishini ayting. Sahnaning yakuniy kompozitsiyasini noma’lum qoldirish o‘rniga mo‘ljallangan montajda ishlatish mumkin bo‘lgan yakunni tanlang.
Tasvir asosida yaratishda obyektning aniq ko‘rinishini tayyorlang va undan boshlab sahna qanday harakatlanishini tavsiflang. Ishlab chiqaruvchi tasvir URL manzili yoki kodlangan tasvir ma’lumoti orqali beriladigan 5 MB gacha PNG, JPEG va JPG namunalarni qabul qiladi. Namunada muhim chetlar, yuz xususiyatlari va obyekt detallari ko‘rinib tursin, kompozitsiyada so‘ralgan harakat uchun joy qoldiring.
Ishlab chiqaruvchi yozma promptni 512 belgi bilan cheklaydi. Bu joyni hal qiluvchi detallarga ajrating: obyekt, harakat, muhit va kuzatish nuqtasi. Qaysi obyekt harakatlanishi va nima o‘zgarmay qolishini tushuntiradigan qisqa tavsifni umumiy uslub sifatlari ro‘yxatidan ko‘ra baholash osonroq. Natija maqsadga mos kelmasa, kuzatilgan harakat yoki kadrlash muammosiga tegishli ko‘rsatmani tahrirlang.
E’lon qilingan chiqish o‘lchamlariga kvadrat, gorizontal va vertikal formatlar kiradi; tanlovlar 720×480 dan 3840×2160 pikselgacha. Ishlab chiqaruvchi soniyasiga 30 yoki 60 kadrni ham hujjatlashtiradi. Yaratishdan oldin maqsadli foydalanishga mos shakl va kadr tezligini tanlang, keyin obyekt va muhim detallari shu kadrlashda o‘qiladigan qolganini haqiqiy klipda tekshiring.
Ishlab chiqaruvchi jarayonida sifat va tezlik alohida nomlangan chiqish rejimlaridir. Ixtiyoriy AI yaratadigan ovoz effektlari vizual topshiriqdan alohida boshqariladi. Turli nomzod kliplarni haqiqiy yaratish sozlamalari bo‘yicha solishtirish uchun tanlangan rejim va ovoz effekti sozlamasini prompt hamda ishlatilgan namuna tasviri bilan saqlang.
Yaratish asinxron: tayyor video mavjud bo‘lishidan oldin vazifa identifikatori qaytariladi. Natijani tekshirish davomida shu identifikatorni saqlang va operatsiyaga tegishli barcha tayyor video fayllarni asrang. Vaqtinchalik natija manzili yoki oldindan ko‘rish kadriga tayanish o‘rniga montaj uchun klipning o‘zini, ishlatilgan bo‘lsa manba tasviri bilan birga saqlang.
Butun ketma-ketlikni uzluksizlik, vaqt taqsimoti va so‘ralgan harakat bo‘yicha tekshiring. Mahsulot kadri harakat davomida shakl va material detallarining barqarorligini, personaj kadri esa izchil ko‘rinish va imo-ishoralarni talab qiladi. Yakuniy kompozitsiya va yaratilgan har qanday tovushni kadr maqsadiga nisbatan tekshiring. Aniq nomuvofiqlikni tuzatishda sahnaning muvaffaqiyatli elementlarini saqlang va asl hamda tahrirlangan videolarni bir xil ko‘rish sharoitida solishtiring.
Ailoot Ultra · Video yaratish POST /v1/videos cogvideox-2
cogvideox-2Boshlash
CogVideoX 2 matnli tavsif yoki berilgan tasvirdan video yaratadi. Ishlab chiqaruvchi qisqa vizual sahnani shakllantirish uchun tanlanadigan kadr o‘lchamlari, 30 yoki 60 fps, sifat yoki tezlik rejimlari va ixtiyoriy yaratiladigan ovoz effektlarini hujjatlashtiradi.
- 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-2 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.2 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.2 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-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
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-2
Usul yo‘llari taxalluslari
/v1/videos/generations
Chaqirish uchun tegishli ID lar
FAQ · Zhipu AI: CogVideoX 2
- Qanday kirish ma’lumotlari va natijalar mavjud?
POST /v1/videos·cogvideox-2:text→video- So‘rov qaysi maydonlardan foydalanadi?
POST /v1/videos·cogvideox-2:model,prompt,quality,with_audio,size,fps,duration