Google: Veo 3.1 Lite
Veo 3.1 Lite мәтін сипаттамасынан немесе бастапқы суреттен бейнемен бірге тікелей жасалатын дыбысы бар бейне жасайды. Құжатталған Lite ағыны көлденең не тік кадрлаумен, 4, 6 немесе 8 секунд ұзақтығымен бір ролик береді; оның нақты шектері Veo 3.1 мен Fast нұсқаларынан өзгеше.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Veo 3.1 Lite — Google Veo 3 бейне генерациясы желісінің Lite мүшесі. Ол табиғи тілдегі сипаттамадан немесе кіріс суреттен дыбысы бар бейне синтездейді. Нәтиже — бар жазбаның мәтіндік талдауы емес, жасалған ролик. Өндірушінің Lite модель карточкасы негізгі архитектура, оқыту материалы және белгілі шектеулер үшін Veo 3-ке сілтейді, ал Lite-ке тән құжаттама өз генерация мүмкіндіктері мен шектерін анықтайды.
Сілтелген архитектура уақыттық дыбыс көріністері мен кеңістіктік-уақыттық бейне көріністеріне латентті диффузия қолданады. Базалық модель әртүрлі егжей-тегжейлі сипаттамалармен берілген дыбыс, бейне және суреттерде, сүзілген және қайталануы жойылған материалмен оқытылған. Бұл біріктірілген көрнекі-дыбыс генерациясы мақсатын түсіндіреді. Ол Lite-ке тән параметр санын ашпайды және әр жасалған қозғалыс физикалық шындыққа бағынады деп дәлелдемейді. Практикалық көріністе көрінетін әрекет пен тиісті дыбысты бірге шешіңіз.
Нақты Lite құжаттамасы мәтін кірісіне 1,024 токен шегін және бір шығыс бейнені береді. Генерация нұсқаулығының Lite бағаны 4, 6 және 8 секунд ұзақтықтарды, әдепкі 720p-ді, 1080p үшін 8 секундтық ролик қажет екенін көрсетеді. Әдепкі арақатынас — көлденең 16:9, тік 9:16 да бар; нәтиже секундына 24 кадр деп құжатталған. Осы ағынды қолданғанда бейнемен бірге дыбыс жасау әрдайым қосулы. Бұл мәндер қатысы жоқ Veo нұсқасына не бөлек өлшенген қолданба жауабына емес, өндірушінің аталған Lite ағынына тиесілі.
Lite 4K нәтижені және бейне жалғастыруды қолдамайды. Параметр кестесінде Lite бағаны бірнеше референсті referenceImages мүмкіндігін және жалғастыруға арналған бейне кірісін де қолжетімсіз деп белгілейді. Бастапқы сурет алғашқы кадрды бекітеді; кестеде ауысу үшін сол суретпен бірге lastFrame суреті көрсетілген. Осы кадр басқаруын бірнеше стиль не нысан референсін араластырудан ажыратыңыз. Өндірушінің адам генерациясы параметрлері режимге тән: Lite кестесі мәтіннен бейнеге allow_all, суреттен бейне мен интерполяцияға allow_adult береді, ал аймақтық ережелер сол құжатталған профильді қосымша шектеуі мүмкін. Бастапқы суретті нақты қажетті алғашқы көрініске сәйкестендіріп, қозғалыс сұрамас бұрын нысанды, кадрлауды және көрінетін бөлшектерді дайындаңыз.
Мәтіннен бейне үшін нысанды, әрекетін, ортаны және қажетті стильді сипаттаңыз. Маңызды болса камера орны мен қозғалысын, кадрлауды, фокусты және жарықты қосыңыз. Авторлық өнім көрінісі затты ортада ұстап, камераны бір материал бөлшегіне жақындатып, айнала жарықты жұмсақ өзгерте алады. Қысқа ролик бір үйлесімді идеяны аяқтауы үшін алғашқы күйді, негізгі әрекетті және соңғы сәтті атаңыз. Қатысы жоқ әрекеттердің ұзақ жиыны бір шоғырланған планнан бөлек міндет.
Суреттен бейне үшін анық алғашқы кадр беріп, не қозғалуы және не тұрақты қалуы керегін түсіндіріңіз. Нысан қозғалысын және камера қозғалысын бөлек көрсетіңіз. Соңғы кадр шектеуін қолдансаңыз, үйлесетін соңғы композиция дайындап, олардың арасындағы ауысуды сипаттаңыз. Сұралған тұлға, орын не пішін бүкіл ролик бойымен бірдей қалады деп ойламай, нәтижені тексеріңіз. Сілтелген модель карточкасы күрделі көріністердегі толық тұрақтылық пен күрделі қозғалысты әлі шешілетін қиындық деп атайды.
Промпт нұсқаулығы диалогқа, дыбыс әсерлеріне және орта үніне анық ишараларды қолдайды. Нақты сөйлеуді тырнақшаға алып, сөйлеушіні атаңыз және дыбысты көрінетін әрекетке қатысты сипаттаңыз. Дыбыс әсері мен фон атмосферасын айтылатын сөйлеммен шатастырмаңыз. Промпт үшін ағылшын тілі толық қолдау табады деп құжатталған, басқа тілдер сол нұсқаулықта бағаланбаған. Дыбысты промпттың міндетті түрде дәл транскрипті деп қарамай, естілетін сөздерді, уақытты және дыбыс сапасын бейнемен бір артефакт ретінде тексеріңіз.
Өндіруші ағыны асинхронды: генерация сұрауы операцияны қайтарады, аяқталған нәтиже күйі аяқталуды хабарлағаннан кейін алынады. Операция тұлғасын сақтап, қайтарылған роликті тексеріңіз. Нұсқаулық өндіруші жағында екі күн сақтауды және SynthID белгілеуін сипаттайды, сондықтан сақталатын артефакт жүктелген нәтижені, промптты, бастапқы суреттерді және таңдалған параметрлерді қамтуы тиіс. Seed қайталанғыштықты жақсартуы мүмкін, бірақ детерминизмге кепіл бермейді. Монтажға қолданар алдында нысан сабақтастығын, әрекетті, кадрлауды, дыбысты және қажетті соңғы күйді тексеріңіз; өңдеудің аяқталуы шығармашылық талаптар орындалғанын өздігінен дәлелдемейді.
Ailoot Ultra · Бейне POST /v1/videos google/veo-3.1-lite
google/veo-3.1-liteБастау
Көрініс сипаттамасын 720p ажыратымдылығындағы 4, 6 немесе 8 секундтық бейнероликке айналдырыңыз.
- Өнімді қозғалыста көрсетіңіз
- Оқиға орнын таныстыратын көрініс жасаңыз
- Камераның қысқа қозғалысын сынап көріңіз
- Қабылданатын кіріс деректері
- Мәтін · Суреттер
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Бейне POST /v1/videos
- Кіріс
text,image- Шығыс
video- Шығыс пішімі
- mp4
- Нәтижелер саны
- Ең көбі 4 шығысs
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер google/veo-3.1-lite | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Ең аз ұзындық: 1 Байттардың ең көп саны: 10 000 Бірлік: UTF8 байттары | Әдепкі— |
Өрісduration | Түріinteger | ТалапМіндетті | Мәндер мен шектеулер 4, 6, 8 Бірлік: секунд | Әдепкі— |
Өрісresolution | Түріstring | ТалапМіндетті | Мәндер мен шектеулер 720p | Әдепкі— |
Өрісaspect_ratio | Түріstring | ТалапМіндетті | Мәндер мен шектеулер 16:9, 9:16 | Әдепкі— |
Өрісgenerate_audio | Түріboolean | ТалапМіндетті | Мәндер мен шектеулер false | Әдепкі— |
Өрісframe_images | Түріarray | ТалапМіндетті емес | Мәндер мен шектеулер Шарттар: text_to_video үшін бұл өрісті қоспаңыз. Берілген жағдайда: дәл бір элемент {"type":"image_url","image_url":{"url":"<нақты HTTPS URL>"},"frame_type":"first_frame"}; элементте тек type,image_url,frame_type өрістері, ал image_url ішінде тек url болуы керек. Артық немесе қайталанатын кілттерге жол берілмейді. Тек duration=4,resolution="720p",aspect_ratio="16:9",generate_audio=false комбинациясына рұқсат етіледі. URL талданғанда схема https, хост атауы бос емес болуы, userinfo және тікелей # таңбасы болмауы керек; қолтаңбасы бар сұрау бөлігі мен кодталған жол сақталады. Бастапқы іске асыру кірістің MIME түрін, файл көлемін немесе пиксельдік өлшемдерін тексермейді. | Әдепкі— |
Кіріс материалдарының үйлесімдері
Мәтіннен бейне жасау · Міндетті: prompt
Суреттен бейне жасау · Міндетті: prompt, frame_images
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, prompt, duration, resolution, aspect_ratio, generate_audio |
Параметрother_options | Параметр талаптарыfalse |
Параметрresolution | Параметр талаптары720p |
Параметрprompt_max_bytes | Параметр талаптары10000 |
Параметрduration | Параметр талаптары4, 6, 8 |
Параметрaspect_ratio | Параметр талаптары16:9, 9:16 |
Параметрgenerate_audio | Параметр талаптарыfalse |
Параметрmaterial_types | Параметр талаптарыtext, image |
Параметрparameters | Параметр талаптары{"name":"model","type":"string","required":true,"default_known":false,"default":null,"enum_known":true,"enum":["google/veo-3.1-lite"],"availability":"source_interface"}, {"name":"prompt","type":"string","required":true,"default_known":false,"default":null,"enum_known":false,"enum":null,"availability":"source_interface","min_length":1,"maximum_bytes":10000,"maximum_length":null,"unit":"UTF8 байттары"}, {"name":"duration","type":"integer","required":true,"default_known":false,"default":null,"enum_known":true,"enum":[4,6,8],"availability":"source_interface","unit":"секунд"}, {"name":"resolution","type":"string","required":true,"default_known":false,"default":null,"enum_known":true,"enum":["720p"],"availability":"source_interface"}, {"name":"aspect_ratio","type":"string","required":true,"default_known":false,"default":null,"enum_known":true,"enum":["16:9","9:16"],"availability":"source_interface"}, {"name":"generate_audio","type":"boolean","required":true,"default_known":false,"default":null,"enum_known":true,"enum":[false],"availability":"source_interface"}, {"name":"frame_images","type":"array","required":false,"default_known":false,"default":null,"enum_known":false,"enum":null,"availability":"source_interface","conditions":"text_to_video үшін бұл өрісті қоспаңыз. Берілген жағдайда: дәл бір элемент {\"type\":\"image_url\",\"image_url\":{\"url\":\"<нақты HTTPS URL>\"},\"frame_type\":\"first_frame\"}; элементте тек type,image_url,frame_type өрістері, ал image_url ішінде тек url болуы керек. Артық немесе қайталанатын кілттерге жол берілмейді. Тек duration=4,resolution=\"720p\",aspect_ratio=\"16:9\",generate_audio=false комбинациясына рұқсат етіледі. URL талданғанда схема https, хост атауы бос емес болуы, userinfo және тікелей # таңбасы болмауы керек; қолтаңбасы бар сұрау бөлігі мен кодталған жол сақталады. Бастапқы іске асыру кірістің MIME түрін, файл көлемін немесе пиксельдік өлшемдерін тексермейді."} |
Әдістің балама атаулары: /v1/videos/generations, /videos, /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/videos/generations/{request_id}/content
Бір рет жасап, қайтарылған ID мәнін сақтаңыз.
Бастапқы күйді мезгіл-мезгіл сұраңыз; әрбір аяқталған ресурсты және оның ұзақтығын сақтаңыз.
Тарифтер
Қорытынды төлем қалай есептеледі
Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.
Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.
- Жылдам режим
- Көрсетілмеген Жылдам режим таңдалғанда
- Икемді режим
- Көрсетілмеген flex режимі таңдалғанда
- Ой қорытудың ең жоғары деңгейі
- Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда
Салыстыруға арналған болжамды мөлшерлемелер
Баптаулар бойынша бағалар
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Мөлшерлемелер кестесі | Болжамды мөлшер | Аудио жасау | Ажыратымдылық | Есептеу бірлігі | Төлемді есептеу шарттары | Төлем |
|---|---|---|---|---|---|---|---|
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Болжамды мөлшер— | Аудио жасау— | Ажыратымдылық— | Есептеу бірлігі— | Төлемді есептеу шарттары— | Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Аудио жасау— | Ажыратымдылық— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыаудио: with_audio | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $0.16 бейне секунды үшін |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Аудио жасау— | Ажыратымдылық— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыаудио: with_audio; ажыратымдылық: 720p | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $0.1 бейне секунды үшін |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Аудио жасау— | Ажыратымдылық— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыаудио: without_audio | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $0.1 бейне секунды үшін |
| БаптауUltra | Мөлшерлемелер кестесі— | Болжамды мөлшерСұралған баптаулар; тек болжам. | Аудио жасауАудиосыз | Ажыратымдылық720p | Есептеу бірлігішығыс бейненің секунды үшін | Төлемді есептеу шарттары— | Төлем Шығыс · Шығыс видеоның болжамды секундтары · Тек салыстыруға арналған бағалау $0.06 шығыс бейненің секунды үшін Көрсетілген тариф генерацияға дейінгі құнды болжайды. Түпкілікті төлем бастапқы генерация үшін тіркелген құннан есептеледі. Бейненің физикалық ұзақтығы төлем есептелетін мөлшер емес. |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Аудио жасау— | Ажыратымдылық— | Есептеу бірлігі— | Төлемді есептеу шарттары— | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.24 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Анықтамалық тариф мәліметтері
Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі.
Бейне конфигурацияларының баға сілтемелері
Баптаулар бойынша бағалар
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| БаптауБейне бағасы | Төлемді есептеу шарттарыаудио: with_audio | Төлем Шығыс · Видео бағасы $0.16 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыаудио: without_audio | Төлем Шығыс · Видео бағасы $0.1 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыаудио: with_audio; ажыратымдылық: 720p | Төлем Шығыс · Видео бағасы $0.1 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыаудио: without_audio; ажыратымдылық: 720p | Төлем Шығыс · Видео бағасы $0.06 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
Сұрау мысалдары
Ailoot Ultra · Бейне
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/veo-3.1-lite", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 4, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": false}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
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
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_IMAGE_URL:?Set the actual HTTPS URL of your first-frame image}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os,re
from pathlib import Path
from urllib.parse import urlsplit
image=os.environ["AILOOT_IMAGE_URL"]
try:
parsed=urlsplit(image)
valid=(image.startswith("https://") and parsed.scheme=="https" and bool(parsed.hostname)
and parsed.username is None and parsed.password is None and "#" not in image
and not any(ord(c)<32 or ord(c)==127 for c in image)
and re.search(r"%(?![0-9A-Fa-f]{2})",image) is None)
except ValueError:
valid=False
if not valid:
raise SystemExit("Use your actual HTTPS image URL with a hostname, no userinfo and no fragment")
p={"model":"google/veo-3.1-lite","prompt":"The subject makes a slow, natural movement. Keep the opening composition.","duration":4,"resolution":"720p","aspect_ratio":"16:9","generate_audio":False,"frame_images":[{"type":"image_url","image_url":{"url":image},"frame_type":"first_frame"}]}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False),encoding="utf-8")
PY_REQUEST
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
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print("Keep the complete JSON, headers and original returned id. Use the existing GET status tab for that original operation, then save every completed owned output. Never resubmit an unknown generation.")
PY_RESULT
Нәтижелерді алу және сақтау
Ailoot Ultra · Бейне
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Тапсырма күйін тексеру
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o status.json
python3 - <<'PY_STATUS'
import json
from pathlib import Path
r=json.loads(Path("status.json").read_text())
print(json.dumps(r))
if r.get("status")=="completed":
for x in r.get("data",[]):print(x)
PY_STATUS
Барлық дайын материалды сақтау
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
Басқа мазмұнды оқу
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4
Барлық дайын нәтижені сақтау
Әр дайын бейнені немесе қайтарылған файлды сақтаңыз; нақты қайтарылған әр материал URL арқылы мазмұнды алыңыз.
Аяқталған data[] ішінде иелігіңіздегі мазмұнның қолтаңбасы бар барлық URL мекенжайы болады. Қайтарылған әрбір URL бойынша файлды алыңыз немесе index өрісіне нақты шығыс индексін қойып, мазмұн эндпоинтын пайдаланыңыз. Сәтсіз аяқталған бастапқы тапсырма charge_pending_check мәнін қайтаруы мүмкін; оны қайта жасаудың орнына сол бастапқы тапсырманы тексеріңіз. generate_audio=false болса да, жарамды AAC аудиожолы болуы мүмкін; сол аудионы қоса алғанда, бастапқы MP4 файлын толық сақтаңыз.
Бастапқы жауапты тексеру қажет болса
Бар бастапқы тапсырманы оқыңыз; жіберу нәтижесі белгісіз сұрауды ешқашан қайталап жібермеңіз.
Нәтижелердің ең көп саны: 4.
Жауап өрістері
| Өріс | Түрі | Мағынасы |
|---|---|---|
Өрісid | Түріstring | Мағынасы— |
Өрісobject | Түріstring | Мағынасы— |
Өрісmodel | Түріstring | Мағынасы— |
Өрісstatus | Түріstring | Мағынасы— |
Өрісdata[] | Түріsigned content URL | Мағынасы— |
Өрісcharge_pending_check | Түріboolean | Мағынасы— |
Өрісerror.code | Түріstring | Мағынасы— |
Өрісerror.message | Түріstring | Мағынасы— |
Өрісoperation_id | Түріstring | МағынасыБастапқы күй немесе мазмұнға арналған HTTP503 result_pending_check жауабы: id ретінде сол бастапқы ашық бейне ID мәні беріледі. |
Өрісerror.type | Түріstring | МағынасыHTTP503 result_pending_check кезінде server_error. |
Қателер және келесі қадамдар
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап400 · invalid_request_error | ШартМіндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате | Келесі қадамЖаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз. |
Жауап409 · video_not_ready | ШартБастапқы нәтиженің мазмұны әзірге қолжетімді емес | Келесі қадамБастапқы қайтарылған ID бойынша күйді мезгіл-мезгіл сұрап, Retry-After талабын сақтаңыз. |
Жауапserver_error | ШартҚайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілген | Келесі қадамБастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз. |
Жауап503 · result_pending_check | ШартБастапқы күйді немесе мазмұнды GET арқылы алу: тапсырма жарияланбаған, бастапқы тапсырма failed/cancelled/expired күйінде емес және жергілікті күй unknown немесе бастапқы тапсырманың күйі completed. | Келесі қадамБастапқы id және operation_id мәндерін (сол бір ашық бейне ID мәні), жауапты және тақырыптарды сақтаңыз; тек бастапқы күйді немесе мазмұнды оқыңыз. Жаңа генерация сұрауын ешқашан жібермеңіз. |
Жауап422 · price_unavailable | ШартБерілген frame_images объектісін немесе оның шартқа байланысты профилін талдау сәтсіз аяқталады не толық талданған профиль үшін дайын нақты баға картасы жоқ. | Келесі қадамmodel, prompt, duration, resolution, aspect_ratio және generate_audio өрістерін сақтаңыз. Көрсетілген объект пішіміндегі дәл бір first_frame элементі бар frame_images қосыңыз. duration=4, resolution="720p", aspect_ratio="16:9" және generate_audio=false орнатыңыз. Бұл тексеру сұрау жіберілгенге дейін орындалады. |
Балама атаулар
Модельдердің балама атаулары
Ailoot Ultra google/veo-3.1-lite
Әдіс жолдарының балама атаулары
/v1/videos/generations, /videos, /videos/generations
Шақыруға арналған байланысты ID
FAQ · Google: Veo 3.1 Lite
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos·google/veo-3.1-lite:text,image→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos·google/veo-3.1-lite:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images