Source: https://ailoot.ai/docs/kk/api/video-music/
Canonical: https://ailoot.ai/docs/kk/api/video-music/
Language: kk

[API](https://ailoot.ai/docs/kk/) 

# Бейне және музыка

[Markdown](https://ailoot.ai/docs/kk/api/video-music/index.md)

Бейне мен музыка генерациясы: сұрау тапсырма жасайды, нәтиже оның идентификаторы бойынша алынады.

POST`https://api.ailoot.ai/v1/videos`

Бейне және музыка

```bash
# Request ID мәнін сақтаңыз: қолдау қызметі сұрауыңызды осы мән арқылы табады.
# Тапсырманы бір рет жасаңыз; төмендегі цикл тек оның күйін оқиды.
curl --fail-with-body --max-time 120 -D video-create-headers-v1.txt \
  https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-imagine-video-1.5","prompt":"тынық көл","seconds":"8","size":"1280x720"}' \
  -o video-create-v1.json || exit 1
VIDEO_ID=$(jq -er '.id // .request_id' video-create-v1.json) || exit 1
VIDEO_STATUS=""
# Бұл цикл тек бастапқы тапсырманы оқиды. Жасау сұрауын ешқашан қайта жібермейді.
for ATTEMPT in $(seq 1 60); do
  curl --fail-with-body --max-time 30 \
    "https://api.ailoot.ai/v1/videos/$VIDEO_ID" \
    -H "Authorization: Bearer $AILOOT_API_KEY" \
    -o video-status-v1.json || exit 1
  VIDEO_STATUS=$(jq -r '.status // empty' video-status-v1.json)
  # result_pending_check: true (күйі in_progress болып қалады): нәтиже тексеріліп жатыр. Тоқтаңыз; тапсырманы ешқашан қайта жасамаңыз.
  if jq -e '.result_pending_check == true' video-status-v1.json >/dev/null; then
    cat video-status-v1.json
    echo "The result is being checked. Do not create the job again: check GET /v1/videos/$VIDEO_ID later or contact support with the Request ID." >&2
    exit 1
  fi
  case "$VIDEO_STATUS" in
    done|completed) break ;;
    queued|in_progress|pending|processing) sleep 5 ;;
    # failed немесе кез келген басқа күй: оны көрсетіп, тоқтаңыз. Тапсырманы ешқашан қайта жасамаңыз.
    *) cat video-status-v1.json; exit 1 ;;
  esac
done
case "$VIDEO_STATUS" in
  done|completed) ;;
  *) echo "The job is not finished yet (status: ${VIDEO_STATUS:-none}). Check it later: GET /v1/videos/$VIDEO_ID" >&2; exit 1 ;;
esac
curl --fail-with-body --max-time 120 -L --max-redirs 3 \
  "https://api.ailoot.ai/v1/videos/$VIDEO_ID/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o video-v1.mp4
# Жасау сұрауының күту уақыты аяқталса, бұл скриптті қайта іске қоспас бұрын пайдалану тарихындағы Request ID мәнін тексеріңіз.
```

```bash
curl https://api.ailoot.ai/v1/music/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "google/lyria", "prompt": "Тыныш фортепиано мен виолончель, вокалсыз"}' 
```

Жауап · қысқартылған

```json
// Тапсырма идентификаторы id немесе request_id өрісінде
{ "id": "…", … }

// Пішім модельге байланысты: идентификаторды
// жасау жауабынан өзгертпей алыңыз.
```

## Авторизация

| Параметр | Түрі | Міндетті | Сипаттама |
| --- | --- | --- | --- |
| `Authorization` | header | міндетті | Кілт мына пішімде `Bearer sk-…`. Сондай-ақ мына тақырыптар жарайды: `x-api-key` немесе `x-goog-api-key`. |

## Бейне: сұрау денесі

| Параметр | Түрі | Міндетті | Сипаттама |
| --- | --- | --- | --- |
| `model` | string | міндетті | Бейне моделі: `google/omni-1.1-flash`, `grok-imagine-video`, `happyhorse-1.1-t2v`, `MiniMax-Hailuo-2.3`, `grok-imagine-video-1.5`, `happyhorse-1.1-r2v`, `grok-imagine-video-1.5-preview`, `happyhorse-1.1-i2v`. |
| `prompt` | string | міндетті | Бейненің сипаттамасы. |
| `duration / seconds` | integer / string | міндетті емес | Модельдер тобына байланысты: Grok 1–15 секунд, MiniMax 768P үшін 6/10 немесе 1080P үшін 6, HappyHorse 3–15; Google Omni 4/6/8/10. Бір топтың өрісін басқасына көшірмеңіз. |
| `resolution / size` | string | міндетті емес | Grok: 480p/720p/1080p (video-1.5 үшін 1080p) немесе size 1280x720/720x1280/1920x1080/1080x1920. MiniMax: 768P/1080P. HappyHorse: 480P/720P/1080P. Google Omni: 360p/720p. |
| `image / first_frame_image / image_urls` | string / array | міндетті емес | Бастапқы сурет өрістері модельдер тобы мен режимге байланысты. MiniMax Fast үшін first\_frame\_image қажет. HappyHorse t2v — images жоқ, i2v — ratio көрсетілмеген дәл бір сурет, r2v — 1–9 сурет. |

Жауапта тапсырма идентификаторы бар (мына өріс: `id` немесе `request_id`). Оны талдамай, өзгеріссіз қолданыңыз: форматы модельге байланысты. Күйі және дайын файл:

GET`https://api.ailoot.ai/v1/videos/{id}`

GET`https://api.ailoot.ai/v1/videos/{id}/content`

Осы мекенжайлар мына префикспен де жұмыс істейді: `/v1/videos/generations/{id}`. Дайын тапсырманың күйі мен жауап өрістерінің жиыны модельге байланысты — күй өрісіне сүйеніп, файлды мына жол арқылы алыңыз: `/content`.

## Жасау → күй → жүктеу

Жасау жауабын және оның Request ID-ін сақтаңыз. MiniMax/HappyHorse үшін дайын күй — `status: completed`, жауап құрамында `content_url`, `data[]` және usage болады. Grok үшін — `status: done` мынамен бірге: `video.url`. Google Omni 202 queued қайтарады, содан кейін Retry-After бар in\_progress, completed немесе partial/content\_revoked келеді. Кез келген 200 кодын дайын бейне деп санамаңыз. Күй жауабында мына белгі болса: `result_pending_check: true` (`status` бұл кезде `in_progress`), нәтиже нақтыланып жатыр. Тапсырманы қайта жасамаңыз — кейінірек GET /v1/videos/{id} арқылы тексеріңіз немесе Request ID-мен қолдау қызметіне жазыңыз.

`/content` MP4-ті тікелей немесе қол қойылған файлға redirect қайтара алады. Жауапта мына массивте бірнеше нәтиже болса: `data[]`, әрқайсын сақтаңыз: жеткізілген барлық нәтижеге ақы алынады. API арқылы бейне тапсырмасын болдырмау немесе жою мүмкін емес. Дайын файлды жою оған қол жеткізуді жабады, бірақ генерацияны болдырмайды.

Төлем каталогта көрсетілгендей таңдалған ажыратымдылықтағы дайын бейненің секунды немесе бір бейне үшін есептеледі. Толық құны тапсырманы жасағанда резервтеледі.

## Музыка

POST`https://api.ailoot.ai/v1/music/generations`

| Параметр | Түрі | Міндетті | Сипаттама |
| --- | --- | --- | --- |
| `model` | string | міндетті | `google/lyria`, `google/lyria-3-clip-preview`. |
| `prompt` | string | міндетті | Тректің сипаттамасы: жанры, аспаптары, көңіл күйі. |

Жауапта `data[]` — дайын клиптерге сілтемелер. Бір сұрауда модель бірнеше клип қайтара алады; жеткізілген әр клипке ақы алынады.

Қосылым үзілсе, бейне немесе музыка сұрауын қайта жібермеңіз: тапсырма басталып кеткен болуы мүмкін. Алдымен идентификаторы бойынша күйін тексеріңіз немесе Request ID-мен қолдау қызметіне жазыңыз.

Сұрақтарыңыз қалды ма? Request ID мен сипаттаманы жіберіңіз — мәселені анықтауға көмектесеміз.[Қолдау қызметіне жазу](mailto:support@ailoot.ai)

## Ailoot · Компания және оның жобалар портфелі





Ailoot жинақталған жұмыс тәжірибесіне, кең клиенттік базаға, тұрақты қызметке және KPI көрсеткіштерін үздіксіз бақылауға сүйенеді.





Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі.





Ailoot осы тәжірибені клиенттердің өнімдерінде, агенттерінде, қолданбаларында және автоматтандыруларында жасанды интеллект мүмкіндіктеріне API арқылы қол жеткізуді қамтамасыз етуге пайдаланады.