happyhorse-1.0-r2v
HappyHorse 1.0 R2V сурет референсі мен жазбаша нұсқау арқылы видео жасайды. Оның Ailoot сұрауында ұзақтық, ажыратымдылық және кадр пропорциясын таңдау бар.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
happyhorse-1.0-r2v таңдап, prompt пен image беріңіз. Сұрау 720P немесе 1080P ажыратымдылығын, 3 пен 15 секунд арасындағы ұзақтықты және 16:9, 9:16, 1:1, 4:3 не 3:4 кадр қатынастарын ұсынады. Көріністі сипаттамас бұрын кадрды орналастырылатын орынға сай таңдаңыз.
Референстің қай көрінетін нысанды немесе көркемдік тәсілді беретінін және жаңа кадрда не болуы керегін түсіндіріңіз. Өнім көрінісі үшін нысанды, ортаны, қозғалысты және соңғы кадрлауды көрсетіңіз. Кейіпкер сәтінде қажетті әрекет пен камера нұсқауын бөлек ұстаңыз. Дайын кадрды екеуімен де салыстыру үшін референс пен prompt-ты бірге сақтаңыз.
Кадрды /v1/videos арқылы бір рет жіберіңіз, қайтарылған сұрау ID-ін сақтап, /v1/videos/{request_id} арқылы сол бастапқы операцияның күйін сұраңыз. Әр дайын видео нәтижесін және толық жауапты сақтап, содан кейін әрекетті, кадрлауды және соңғы күйді тапсырмамен салыстырыңыз.
Ailoot Ultra · Video POST /v1/videos happyhorse-1.0-r2v
happyhorse-1.0-r2vБастау
HappyHorse 1.0 R2V сурет референсі мен жазбаша нұсқау арқылы видео жасайды. Оның Ailoot сұрауында ұзақтық, ажыратымдылық және кадр пропорциясын таңдау бар.
- Қабылданатын кіріс деректері
- Мәтін · Суреттер
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Video POST /v1/videos
- Кіріс
text,image- Шығыс
video
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер happyhorse-1.0-r2v Шарттар: Ailoot жүйесінің дәл осы маршруттау селекторын пайдаланыңыз. | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз. | Әдепкі— |
Өрісimage | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Шарттар: Кескініңіздің нақты қолжетімді URL мекенжайын беріңіз. Тізім параметр схемасында массив көрсетілген жағдайда ғана қабылданады. | Әдепкі— |
Өрісresolution | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 720P, 1080P Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз. | Әдепкі720P |
Өрісaspect_ratio | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 16:9, 9:16, 1:1, 4:3, 3:4 Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз. | Әдепкі— |
Өрісduration | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз. | Әдепкі5 |
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, prompt, image |
Параметрoptional | Параметр талаптарыresolution, aspect_ratio, duration |
Параметрmaterial_types | Параметр талаптарыtext, image |
Параметрconditions | Параметр талаптарыAiloot жүйесінің дәл осы маршруттау селекторын пайдаланыңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Кескініңіздің нақты қолжетімді URL мекенжайын беріңіз. Тізім параметр схемасында массив көрсетілген жағдайда ғана қабылданады., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз. |
Әдістің балама атаулары: /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 токен |
| БаптауШығыс бейне | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Шығыс ажыратымдылығы1080P | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттары1080P ажыратымдылығындағы шығыс бейнені анықтамалық бағалау. Түпкілікті есептен шығару тіркелген бастапқы шотқа сәйкес анықталады. | Төлем Шығыс · Шығыс видео · Тек салыстыруға арналған бағалау $0.552 бейне секунды үшін Тек анықтамалық бағалау; түпкілікті есептен шығару тіркелген бастапқы шотқа сәйкес анықталады. |
| БаптауШығыс бейне | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Шығыс ажыратымдылығы720P | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттары720P ажыратымдылығындағы шығыс бейнені анықтамалық бағалау. Түпкілікті есептен шығару тіркелген бастапқы шотқа сәйкес анықталады. | Төлем Шығыс · Шығыс видео · Тек салыстыруға арналған бағалау $0.312 бейне секунды үшін Тек анықтамалық бағалау; түпкілікті есептен шығару тіркелген бастапқы шотқа сәйкес анықталады. |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Шығыс ажыратымдылығы— | Есептеу бірлігі— | Төлемді есептеу шарттары— | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.312 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Сұрау мысалдары
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "happyhorse-1.0-r2v", "prompt": "A cat is walking on grass.", "image": "YOUR_ACCESSIBLE_IMAGE_URL"}')
p['image']=os.environ['AILOOT_IMAGE_URL']
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
# Submit once. Retain the complete result, original identifiers and every response 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 |
Қателер және келесі қадамдар
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап400 · invalid_request_error | ШартМіндетті өріс, модель селекторы, түр немесе кіріс деректерінің ұсынылу пішімі жарамсыз. | Келесі қадамБөлек сұрауды дайындамас бұрын қайтарылған тексеру мәліметтерін қарап шығыңыз. |
Жауап | ШартБастапқы сұрау немесе нәтиже белгісіз не тексеруді қажет етеді. | Келесі қадамБастапқы идентификаторлар мен тақырыптарды сақтаңыз; тек қолдау көрсетілетін күй немесе кітапхана жазбаларын оқыңыз. Жасау сұрауын қайта жібермеңіз. |
Балама атаулар
Модельдердің балама атаулары
Ailoot Ultra happyhorse-1.0-r2v
Әдіс жолдарының балама атаулары
/v1/videos/generations
Шақыруға арналған байланысты ID
FAQ · happyhorse-1.0-r2v
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos·happyhorse-1.0-r2v:text,image→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos·happyhorse-1.0-r2v:model,prompt,image,resolution,aspect_ratio,duration