PixVerse v4
Мәтін/суреттен видео: 5/8 секунд, бес кадр қатынасы және 360p–1080p сапа таңдауы.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
pixverse-v4 видео жасауға мәтін мен қосымша үлгі сурет қабылдайды. aspect_ratio: 16:9, 4:3, 1:1, 3:4 және 9:16; quality: 360p, 540p, 720p не 1080p. Ұзақтық 5 не 8 секунд. Үлгі суреттен әлеуметтік желідегі қысқа монтажға тік өнім кадрын дайындауға болады.
/v1/videos әдісінде normal не fast motion_mode, negative_prompt және қосымша end_image бар. Lip-sync өрістері бөлек аталған басқарулар, оларды болжанған жалпы audio-upload жолымен емес, әдіс анықтамасымен қолданыңыз. Таңдалған сұрау қолдайтын үйлесімді таңдаңыз. Бастапқы job пен әр нақты шығысты алыңыз; fast — қозғалыс режимі, өлшенген генерация уақыты кепілдігі емес.
Ailoot Ultra · Video POST /v1/videos pixverse-v4
pixverse-v4Бастау
Мәтін/суреттен видео: 5/8 секунд, бес кадр қатынасы және 360p–1080p сапа таңдауы.
- Қабылданатын кіріс деректері
- Мәтін · Суреттер
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Video POST /v1/videos
- Кіріс
text,image- Шығыс
video
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер pixverse-v4 Шарттар: Ailoot жүйесінің дәл осы маршруттау селекторын пайдаланыңыз. | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Шарттар: Көріністі және ондағы қозғалысты сипаттаңыз. | Әдепкі— |
Өрісaspect_ratio | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 16:9, 4:3, 1:1, 3:4, 9:16 Шарттар: Таңдалған модель үшін тізімде көрсетілген ен мен биіктік арақатынастарының бірін пайдаланыңыз. | Әдепкі— |
Өрісquality | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 360p, 540p, 720p, 1080p Шарттар: Таңдалған модель үшін тізімде көрсетілген сапа мәнін пайдаланыңыз. | Әдепкі— |
Өрісmotion_mode | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер normal, fast Шарттар: Таңдалған модель үшін тізімде көрсетілген қозғалыс режимін пайдаланыңыз. | Әдепкі— |
Өрісduration | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер 5, 8 Шарттар: Тізімде көрсетілген ұзақтықты пайдаланыңыз; көрсетілмеген әдепкі мәнді қолданбаңыз. | Әдепкі— |
Өрісend_image | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Шарттар: Міндетті емес соңғы кадр берілсе, кескіндермен жұмыс істеудің қолдау көрсетілетін режимі таңдалады. | Әдепкі— |
Өрісlip_sync_tts_content | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Шарттар: Таңдалған модельге арналған сөйлеу мазмұны. Міндетті емес. | Әдепкі— |
Өрісlip_sync_tts_speaker_id | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Шарттар: Жеткізуші қолдайтын нақты дауыс идентификаторын пайдаланыңыз; дауыс идентификаторын ойдан шығармаңыз. | Әдепкі— |
Өрісimage | Түріstring or array<string> | ТалапМіндетті емес | Мәндер мен шектеулер Шарттар: Кескініңіздің нақты, жалпыға қолжетімді URL мекенжайын немесе base64 пішіміндегі кескінді пайдаланыңыз; таңдалған модель кескінді кіріс ретінде қолдайды. | Әдепкі— |
Өрісnegative_prompt | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Шарттар: Болмауы тиіс мазмұнды сипаттаңыз. | Әдепкі— |
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, prompt |
Параметрoptional | Параметр талаптарыaspect_ratio, quality, motion_mode, duration, end_image, lip_sync_tts_content, lip_sync_tts_speaker_id, image, negative_prompt |
Параметрmaterial_types | Параметр талаптарыtext, image |
Параметрconditions | Параметр талаптарыAiloot жүйесінің дәл осы маршруттау селекторын пайдаланыңыз., Көріністі және ондағы қозғалысты сипаттаңыз., Таңдалған модель үшін тізімде көрсетілген ен мен биіктік арақатынастарының бірін пайдаланыңыз., Таңдалған модель үшін тізімде көрсетілген сапа мәнін пайдаланыңыз., Таңдалған модель үшін тізімде көрсетілген қозғалыс режимін пайдаланыңыз., Тізімде көрсетілген ұзақтықты пайдаланыңыз; көрсетілмеген әдепкі мәнді қолданбаңыз., Міндетті емес соңғы кадр берілсе, кескіндермен жұмыс істеудің қолдау көрсетілетін режимі таңдалады., Таңдалған модельге арналған сөйлеу мазмұны. Міндетті емес., Жеткізуші қолдайтын нақты дауыс идентификаторын пайдаланыңыз; дауыс идентификаторын ойдан шығармаңыз., Кескініңіздің нақты, жалпыға қолжетімді URL мекенжайын немесе base64 пішіміндегі кескінді пайдаланыңыз; таңдалған модель кескінді кіріс ретінде қолдайды., Болмауы тиіс мазмұнды сипаттаңыз. |
Әдістің балама атаулары: /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 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Сұрау мысалдары
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "pixverse-v4",
"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 · Video
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 |
Өрісtask_id | Түріstring |
Өрісstatus | Түріstring |
Өрісvideo_url | Түріstring |
Балама атаулар
Модельдердің балама атаулары
Ailoot Ultra pixverse-v4
Әдіс жолдарының балама атаулары
/v1/videos/generations
Шақыруға арналған байланысты ID
FAQ · PixVerse v4
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos·pixverse-v4:text,image→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos·pixverse-v4:model,prompt,aspect_ratio,quality,motion_mode,duration,end_image,lip_sync_tts_content,lip_sync_tts_speaker_id,image,negative_prompt