Alibaba: HappyHorse 1.1

Alibaba HappyHorse 1.1 мәтіндік тапсырмадан, бір алғашқы кадр суретінен немесе тоғызға дейін референс суреттен дыбысы бар қысқа бейне жасайды. Өндіруші профильдері жақсарған қозғалысқа, тері бөлшегіне және роликтер арасындағы кейіпкер тұрақтылығына басымдық береді. Нәтиже — 480p, 720p не 1080p таңдауымен, 24 fps жиілікпен 3–15 секундтық MP4.

Ailoot Ultra · Бейне POST /v1/videos alibaba/happyhorse-1.1

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

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

Alibaba HappyHorse 1.1 — мәтіннен, алғашқы кадр суретінен және референстен бейне жасау профильдері бөлек аталған генерация нұсқасы. Өндіруші жақсарған көрнекі бөлшекке, қозғалысқа, роликтер арасындағы кейіпкер тұлғасына, мәтін тұрақтылығына және дыбыс-сурет үйлесіміне басымдық береді. Нәтиже — өнім планына, портрет анимациясына немесе шағын кейіпкер көрінісіне пайдалы дыбысы бар қысқа бейне. Кіріс режимін көріністі не анықтауы керегіне қарап таңдаңыз: жазбаша тұжырымдама, нақты алғашқы сурет немесе бірнеше көрнекі референс.

Мәтіннен бейне үшін нысанды, орынды, әрекетті, кадрлауды, камера қозғалысын және дыбыс мақсатын сипаттаңыз. Қысқа әрекет көрінісінде велосипедшіні өзен жағасындағы кафе қасында тоқтатып, камераны қойылған велосипедке ақырын жақындатыңыз. Әрекетті қысқа роликке сәйкестендіріп, соңғы сәтті сипаттаңыз. Өндірушінің қазіргі мәтін нұсқаулығы қытайша емес 5,000 не қытайша 2,500 таңбаға дейін рұқсат етеді, артық мәтінді қияды. Негізгі нысан мен әрекет қайталанатын сын есімдердің ішінде көмілмей, анық көрінетіндей тапсырма құрыңыз.

Алғашқы кадр суретінен бейне дәл бір суретті бастау ретінде қолданады. Сол суретте нысанды, композицияны және қажетті қиындыны дайындап, кейін не қозғалуы немесе камера қалай өзгеруі керегін сипаттаңыз. Құжатталған сурет пішімдері — JPEG/JPG, PNG және WEBP, 20 MB-қа дейін, екі өлшемі кемінде 300 пиксель және арақатынасы 1:2.5–2.5:1. Нәтиже бастапқы сурет пропорциясын сақтап, таңдалған ажыратымдылық деңгейіне жуықтайды. Демек, тік нәтиже қатысы жоқ арақатынас нұсқауынан емес, сәйкес тік композициядан басталады.

Референстен бейне бір–тоғыз сурет қабылдайды. Промпт кіріс ретіне сай оларды [Image 1], [Image 2] және кейінгі орындармен атайды. Көрініс суретін кейіпкердің келбетін беретін суретпен шатастырмау үшін әр референс рөлін айтып, тиісті затты не адамды атаңыз. Референс нұсқаулығы 20 MB-қа дейін JPEG/JPG, PNG не WEBP қабылдайды, ең қысқа жағы кемінде 400 пиксель болуын талап етеді және анық 720p не одан жоғары референстерді ұсынады. Тануға қажет бөлшегі жоғалып кеткен қатты сығылған референстен аулақ болыңыз.

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

Өндіруші 1.1 генерация режимдеріне 480p, 720p және 1080p нәтижесін, үш–он бес аралығындағы бүтін секунд ұзақтығын және 24 fps MP4-ті көрсетеді. API жауабы H.264 кодтауын сипаттайды. Мәтіндік және референс генерациясы 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 және 21:9 пішімдерін ұсынады; алғашқы кадр генерациясы кіріс суретке бағынады. Пішімді мақсатты орынға сай таңдап, кейінгі титрлерге не орналасу элементтеріне орын қалдырыңыз. Қайтарылған бейненің нақты кадрлауын жоспарланған көрсету өлшемінде тексеріңіз.

Модель тобының нәтижесінде дыбыс бар. Тапсырмада орындауға не атмосфераға анық рөл беріп, кез келген диалогты, әсерді не фон жолын суретпен бірге тексеріңіз. Ұзақ сценарийді бір қысқа планға сығудың орнына айтылатын материалды әрекет пен үзіліске сыятындай қысқа ұстаңыз. Сөйлеу бар болса, ерін қимылын, сөйлеуші тағайындауын және нақты сөздерді тексеріңіз. Промпт тілін қабылдау өздігінен кепілденген айтылымды немесе бөлек дауыс референсі кірісін анықтамайды.

Өндірушінің құжатталған ағыны асинхронды: тапсырма идентификаторы өңдеуді қадағалайды, сәтті нәтиже бейне орналасуын береді. Нәтиже сілтемесі мен тапсырма сұрауларының жарамдылық кезеңі жиырма төрт сағат деп құжатталған. Дайын роликті, референстерді және промптты түзету жазбасы ретінде сақтаңыз. Нұсқаулықтар seed пен сутаңба басқаруын да құжаттайды. Тұрақты seed салыстыруға көмектесуі мүмкін, бірақ өндіруші бірдей нәтижеге кепіл бермейтінін анық айтады; бір параметр әр кадрды бекітеді деп ойламай, қайтарылған артефактіні бағалаңыз.

HappyHorse 1.0 мен 1.1 — бөлек нұсқалар. 1.1 шығыс кестесі 1.0-дің 720p және 1080p таңдауларына 480p қосады, ал 1.1 модель беттері бөлшек, қозғалыс және тұрақтылық жаңартуларын сипаттайды. Бөлек аталған HappyHorse 1.0 бейне өңдеу профилінің өз кірістері мен шектері бар; оны 1.1-ге үнсіз тағайындайтын өңдеу режимі деп қарастыруға болмайды. Толық 1.1 ролигінде тұлғаны, қозғалысты, кадрлауды, мәтінді және дыбысты тексеріп, тапсырманың сәтті бөліктерін сақтай отырып нақты түзету енгізіңіз.

Ailoot Ultra · Бейне POST /v1/videos alibaba/happyhorse-1.1

alibaba/happyhorse-1.1

Alibaba /alibaba/happyhorse-1.1

Бастау

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

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot Ultra · Бейне POST /v1/videos

Кіріс: text
Шығыс: video
Шығыс пішімі: mp4
Нәтижелер саны: Ең көбі 4 шығысs

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер alibaba/happyhorse-1.1	Әдепкі—
Өріс`prompt`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Ең аз ұзындық: 1 Байттардың ең көп саны: 10 000 Бірлік: UTF8 байттары	Әдепкі—
Өріс`duration`	Түрі`integer`	ТалапМіндетті	Мәндер мен шектеулер Ең азы: 3 Ең көбі: 15 Бірлік: секунд	Әдепкі—
Өріс`resolution`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер 720p	Әдепкі—
Өріс`aspect_ratio`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер 16:9	Әдепкі—

Кіріс материалдарының үйлесімдері

Мәтіннен бейне жасау · Міндетті: prompt

Әдіс параметрлері мен өмірлік циклі

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыmodel, prompt, duration, resolution, aspect_ratio
Параметр`other_options`	Параметр талаптарыfalse
Параметр`resolution`	Параметр талаптары720p
Параметр`prompt_max_bytes`	Параметр талаптары10000
Параметр`duration_integer_range`	Параметр талаптары3, 15
Параметр`aspect_ratio`	Параметр талаптары16:9
Параметр`generate_audio`	Параметр талаптарыөрісті қоспау керек (false берілмейді); AAC қамтылады
Параметр`material_types`	Параметр талаптарыtext
Параметр`additional_properties`	Параметр талаптарыfalse

Әдістің балама атаулары: /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 токен
БаптауБейне бағасы	Мөлшерлемелер кестесі—	Болжамды мөлшер—	Есептеу бірлігібейне секунды үшін	Төлемді есептеу шарттарыresolution: 1080p	Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $0.2556 бейне секунды үшін
БаптауБейне бағасы	Мөлшерлемелер кестесі—	Болжамды мөлшер—	Есептеу бірлігібейне секунды үшін	Төлемді есептеу шарттарыresolution: 720p	Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $0.1976 бейне секунды үшін
БаптауГенерацияның болжамды құны	Мөлшерлемелер кестесі—	Болжамды мөлшербір генерацияға арналған болжам	Есептеу бірлігі—	Төлемді есептеу шарттары—	Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.5928 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Анықтамалық тариф мәліметтері

Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі.

Бейне конфигурацияларының баға сілтемелері

Баптаулар бойынша бағалар

Баптау	Төлемді есептеу шарттары	Төлем
БаптауБейне бағасы	Төлемді есептеу шарттарыresolution: 720p	Төлем Шығыс · Видео бағасы $0.1976 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады.
БаптауБейне бағасы	Төлемді есептеу шарттарыresolution: 1080p	Төлем Шығыс · Видео бағасы $0.2556 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады.

Сұрау мысалдары

Ailoot Ultra · Бейне

curl · сақталған құру сұрауының дәл нұсқасы

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "alibaba/happyhorse-1.1", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 3, "resolution": "720p", "aspect_ratio": "16:9"}')

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

Нәтижелерді алу және сақтау

Ailoot Ultra · Бейне

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Тапсырма күйін тексеру

GET бастапқы операцияның күйі

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

Басқа мазмұнды оқу

Өзіңізге тиесілі әр дайын нәтижені сақтау

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())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS

Барлық дайын нәтижені сақтау

Әр дайын бейнені немесе қайтарылған файлды сақтаңыз; нақты қайтарылған әр материал URL арқылы мазмұнды алыңыз.

Аяқталған data[] ішінде иелігіңіздегі мазмұнның қолтаңбасы бар барлық URL мекенжайы болады. Қайтарылған әрбір URL бойынша файлды алыңыз немесе index өрісіне нақты шығыс индексін қойып, мазмұн эндпоинтын пайдаланыңыз. Сәтсіз аяқталған бастапқы тапсырма charge_pending_check мәнін қайтаруы мүмкін; оны қайта жасаудың орнына сол бастапқы тапсырманы тексеріңіз.

Бастапқы жауапты тексеру қажет болса

Бар бастапқы тапсырманы оқыңыз; жіберу нәтижесі белгісіз сұрауды ешқашан қайталап жібермеңіз.

Нәтижелердің ең көп саны: 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`	ШартБейне профилін талдауға дейін сұраудың өңделмеген денесін оқу сәтсіз аяқталады	Келесі қадамҚайтарылған жауапты сақтап, оқылмайтын сұрау денесін түзетіңіз.
Жауап422 · `price_unavailable`	ШартДәл бейне профилін талдау сәтсіз аяқталады немесе толық талданған профиль үшін дайын нақты баға картасы жоқ	Келесі қадамЖауапты сақтаңыз; пайдалануға рұқсат етілген толық әрі дәл профильді және оның жарияланған баға картасын қолданыңыз. Бұл тармақ жеткізушіге жіберуден бұрын орындалады.
Жауап409 · `video_not_ready`	ШартБастапқы нәтиженің мазмұны әзірге қолжетімді емес	Келесі қадамБастапқы қайтарылған ID бойынша күйді мезгіл-мезгіл сұрап, Retry-After талабын сақтаңыз.
Жауап`server_error`	ШартҚайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілген	Келесі қадамБастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз.
Жауап503 · `result_pending_check`	ШартБастапқы күйді немесе мазмұнды GET арқылы алу: тапсырма жарияланбаған, бастапқы тапсырма failed/cancelled/expired күйінде емес және жергілікті күй unknown немесе бастапқы тапсырманың күйі completed.	Келесі қадамБастапқы id және operation_id мәндерін (сол бір ашық бейне ID мәні), жауапты және тақырыптарды сақтаңыз; тек бастапқы күйді немесе мазмұнды оқыңыз. Жаңа генерация сұрауын ешқашан жібермеңіз.

Балама атаулар

Модельдердің балама атаулары

Ailoot Ultra alibaba/happyhorse-1.1

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

/v1/videos/generations, /videos, /videos/generations

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

alibaba/happyhorse-1.1

FAQ · Alibaba: HappyHorse 1.1

Қандай кіріс деректері мен нәтижелер қолжетімді?: POST /v1/videos · alibaba/happyhorse-1.1: text → video
Сұрау қандай өрістерді пайдаланады?: POST /v1/videos · alibaba/happyhorse-1.1: model, prompt, duration, resolution, aspect_ratio
Қандай шектеулер қолданылады?: POST /v1/videos · alibaba/happyhorse-1.1: duration.minimum: 3; duration.maximum: 15

Alibaba: HappyHorse 1.1