Zhipu AI: CogVideoX 2
CogVideoX 2 мәтіндік сипаттамадан немесе берілген суреттен видео жасайды. Өндіруші қысқа көрнекі көріністі құруға арналған таңдалатын кадр өлшемдерін, секундына 30 немесе 60 кадрды, сапа не жылдамдық режимдерін және қосымша жасалатын дыбыстық әсерлерді құжаттайды.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
CogVideoX 2 — Zhipu AI компаниясының жазбаша көрініс сипаттамасынан немесе берілген суреттен видео жасайтын моделі. Мәтін нысанды, ортаны және әрекетті белгілейді; сурет жасалатын тізбектің көрнекі негізін бере алады. Кадр үшін қолда бар материалды ең дұрыс көрсететін кірісті таңдап, кейін дайын видеода болуы тиіс көрінетін қозғалысты сипаттаңыз.
Мәтін арқылы жасау үшін біртұтас оқиғаны анықтаңыз. Адамның шеберхана есігін ашуы, шағын қайықтың айлақ жанынан өтуі немесе заттың тұрақты жарықта бұрылуы кадрға түсінікті мақсат береді. Нысанның маңызды белгілерін, қарау нүктесін және қозғалыс бағытын атаңыз. Көріністің соңғы композициясын белгісіз қалдырмай, көзделген монтажда пайдалануға болатын аяқталуды таңдаңыз.
Сурет арқылы жасау үшін нысан анық көрінетін референс дайындап, көріністің одан қалай қозғалуын сипаттаңыз. Өндіруші сурет URL мекенжайымен немесе кодталған сурет деректерімен берілетін, 5 MB-қа дейінгі PNG, JPEG және JPG референстерін қабылдайды. Референсте маңызды жиектерді, бет белгілерін және зат бөлшектерін көрінетін күйде сақтап, композицияда сұралған әрекетке орын қалдырыңыз.
Өндіруші жазбаша нұсқауды 512 таңбамен шектейді. Бұл орынды шешуші бөлшектерге — нысанға, әрекетке, ортаға және қарау нүктесіне — пайдаланыңыз. Қай зат қозғалатынын және ненің өзгермей қалатынын түсіндіретін қысқа сипаттаманы жалпы стильдік сын есімдер тізімінен оңайырақ бағалауға болады. Нәтиже мақсатқа сай келмесе, байқалған қозғалыс немесе кадрлау мәселесіне қатысты нұсқауды түзетіңіз.
Жарияланған шығыс өлшемдері шаршы, көлденең және тік пішімдерді қамтиды; таңдаулар 720×480 пиксельден 3840×2160 пиксельге дейін барады. Өндіруші секундына 30 немесе 60 кадрды да құжаттайды. Жасаудан бұрын пішім мен кадр жиілігін қолданылатын орынға сай таңдап, кейін сол кадрлауда нысан мен маңызды бөлшектердің анық көрінетінін нақты клиптен тексеріңіз.
Сапа мен жылдамдық — өндіруші процесіндегі аталған шығыс режимдері. Қосымша ЖИ жасаған дыбыстық әсерлер көрнекі тапсырмадан бөлек басқарылады. Клип нұсқаларын нақты генерация баптауларымен салыстыру үшін таңдалған режим мен дыбыстық әсер баптауын нұсқаумен және қолданылған референс суретпен бірге сақтаңыз.
Генерация асинхронды: дайын видео қолжетімді болғанға дейін тапсырма идентификаторы қайтарылады. Нәтижені тексеру кезінде оны сақтап, операцияға қатысты барлық дайын видеофайлдарды қалдырыңыз. Уақытша нәтиже орнына немесе алдын ала қарау кадрына сенбей, өңдеу үшін клиптің өзін және қолданылған бастапқы суретті сақтаңыз.
Бүкіл тізбекті сабақтастық, уақыт және сұралған әрекет бойынша тексеріңіз. Тауар кадрында қозғалыс кезінде пішін мен материал бөлшектері тұрақты болуы керек; кейіпкер кадрында сыртқы көрініс пен қимылдар бірізді болуы тиіс. Соңғы композиция мен жасалған дыбысты кадр мақсатына салыстырыңыз. Нақты сәйкессіздікті түзеткенде көріністің сәтті элементтерін сақтап, бастапқы және түзетілген видеоларды бірдей көру жағдайында салыстырыңыз.
Ailoot Ultra · Бейне POST /v1/videos cogvideox-2
cogvideox-2Бастау
CogVideoX 2 мәтіндік сипаттамадан немесе берілген суреттен видео жасайды. Өндіруші қысқа көрнекі көріністі құруға арналған таңдалатын кадр өлшемдерін, секундына 30 немесе 60 кадрды, сапа не жылдамдық режимдерін және қосымша жасалатын дыбыстық әсерлерді құжаттайды.
- Қабылданатын кіріс деректері
- Мәтін
- Нәтижелер
- Бейне
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 арқылы мазмұнды алыңыз.
Толық жауап пен тақырыптарды, бастапқы идентификаторларды, әрбір нақты шығыс нәтижесін және пайдалану мен есепке алудың барлық өрістерін сақтаңыз. Иелігіңіздегі әрбір бірегей ресурсты сақтап, оған сілтейтін барлық рөлді сақтаңыз.
Бастапқы жауапты тексеру қажет болса
Қайтарылған ашық тапсырма не операция id мәнін және барлық тақырыптарды сақтаңыз. Тек бастапқы тапсырманы оқыңыз; 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
Шақыруға арналған байланысты ID
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