Zhipu AI: CogVideoX 3

CogVideoX 3 өндірушінің құжатталған процесінде мәтіннен, суреттен немесе алғашқы және соңғы кадр жұбынан видео жасайды. Ол бес не он секундтық тізбектерді, 4K-ға дейінгі бірнеше шығыс өлшемін, секундына 30 не 60 кадрды және қосымша жасалатын дыбыстық әсерлерді қолдайды.

Ailoot Ultra · Бейне POST /v1/videos cogvideox-3

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

CogVideoX 3 — Zhipu AI компаниясының мәтіннен видео, суреттен видео және алғашқы әрі соңғы кадрдан жасауы құжатталған видеомоделі. Өндіруші кадр тұрақтылығын, нұсқауды орындауды және шынайы не үшөлшемді көрнекі стильдерді ерекшелейді. Көрініс жазбаша тапсырмадан басталса мәтінді, көрнекі негізі бар болса бір суретті, ал тізбекке анық басталу және аяқталу көрінісі қажет болса екі шеткі суретті таңдаңыз.

Мәтіндік тапсырмада нысанды және бір түсінікті әрекетті сипаттаңыз. Көріністі анық ниетке салыстырып бағалау үшін ортаны, қарау нүктесін және маңызды физикалық байланыстарды атаңыз. Затты көтеретін кейіпкерге сол затты ашып көрсететін камерадан басқа тізбек қажет. Екеуін де тек олардың байланысы кадрға маңызды болса сипаттаңыз.

Суретке негізделген тізбек үшін референсті нысанның ерекше белгілері көрінетіндей дайындаңыз. Өндіруші URL немесе кодталған сурет деректері арқылы берілетін, 5 MB-тан аспайтын PNG, JPEG және JPG суреттерін қабылдайды. Сыртқы көрініс пен кадрлауды есте қалған нұсқамен емес, дереккөзбен салыстыру үшін нақты референсті жасалған нәтижемен бірге сақтаңыз.

Өндірушінің шеткі кадр режимі екі суретті ретімен қабылдайды: біріншісі бастапқы кадрды, екіншісі соңғы кадрды белгілейді. Оларды бір кадрдың көзделген екі күйі ретінде дайындаңыз. Екеуін байланыстыратын ауысуды немесе әрекетті сипаттап, нысанның шеткі күйлер арасында бірізді қалуын тексеріңіз. Жақсы екі статикалық сурет арадағы қозғалыстың қажетті оқиғаға сай екенін өздігінен көрсетпейді.

Нұсқау 512 таңбаға дейін қамти алады. Қолжетімді мәтінді әрекетке, оның бағытына және сәтті нәтижені айқындайтын көрнекі бөлшектерге пайдаланыңыз. Тапсырманы экранда болуы тиіс оқиғаға бағыттаңыз. Кіріс суреттер нысанның сыртқы көрінісін белгілесе, сол суреттер арасында немесе олардан дамуы тиіс қозғалыс пен уақытты сипаттаңыз.

Өндіруші бес немесе он секундтық шығысты, әдепкі бес секундты және секундына 30 немесе 60 кадрды құжаттайды. Қолдау көрсетілетін өлшемдер: 1280×720, 720×1280, 1024×1024, 1920×1080, 1080×1920, 2048×1080 және 3840×2160. Өлшем мен уақытты қолданылатын орынға сай таңдап, дайын клиптің кадрлауын және нақты әрекет қарқынын тексеріңіз.

Сапа және жылдамдық режимдері қосымша ЖИ дыбыстық әсер баптауынан бөлек құжатталған. Бұл таңдауларды нұсқаумен, суреттермен және нәтижемен бірге сақтаңыз. Өндірушінің көрнекі және кіріс мүмкіндіктері модельді сипаттайды; нақты генерация әдісінің қолжетімді басқару параметрлері сол әдістің спецификациясында беріледі. Кадр нұсқаларын салыстырғанда нақты пайдаланылған баптауларды сақтаңыз.

Видео дайын болғанға дейін бастапқы тапсырма идентификаторын сақтап, қайтарылған видеоны монтаж үшін қалдырыңыз. Бүкіл тізбекті, соның ішінде үлкен қозғалыс кезіндегі нысан көрінісін, көрініс заттарымен әрекеттесуін және соңғы композицияны тексеріңіз. Шеткі кадр жұмысында екі шеткі күйді де, олардың арасындағы ауысуды да қараңыз. Сәтті референстер мен кадр жоспарын сақтай отырып нақты көрнекі сәйкессіздікті түзетіп, тек алдын ала қарау суреттерін емес, дайын видеоларды салыстырыңыз.

Ailoot Ultra · Бейне POST /v1/videos cogvideox-3

cogvideox-3

Zhipu AI /cogvideox-3

Бастау

Қабылданатын кіріс деректері: Мәтін
Нәтижелер: Бейне

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 · Бейне

curl · бір рет құрып, қабылдау жазбасын сақтаңызБастапқы тапсырманы оқыңызӨзіңізге тиесілі толық дайын болған әрбір ресурсты сақтаңыз

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}/content
GET /v1/media/assets
GET /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-3

Әдіс жолдарының балама атаулары

/v1/videos/generations

Шақыруға арналған байланысты ID

cogvideox-3

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

Zhipu AI: CogVideoX 3