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

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

# Vaizdo įrašai ir muzika

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

Vaizdo įrašų ir muzikos generavimas: užklausa sukuria užduotį, o rezultatas gaunamas pagal jos identifikatorių.

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

Vaizdo įrašai ir muzika

```bash
# Išsaugokite Request ID: pagal jį pagalbos komanda suras jūsų užklausą.
# Užduotį sukurkite vieną kartą; toliau pateiktas ciklas tik tikrina jos būseną.
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":"ramus ežeras","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=""
# Šis ciklas tik tikrina pradinę užduotį. Jis niekada pakartotinai nesiunčia užklausos jai sukurti.
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 (status lieka in_progress): rezultatas tikrinamas. Sustokite; niekada nekurkite užduoties iš naujo.
  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 arba bet kuri kita būsena: parodykite ją ir sustokite. Niekada nekurkite užduoties iš naujo.
    *) 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
# Jei kuriant užduotį baigėsi laukimo laikas, prieš dar kartą paleisdami šį scenarijų naudojimo istorijoje patikrinkite 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": "Rami fortepijono ir violončelės muzika, be vokalo"}' 
```

Atsakymas · sutrumpinta

```json
// Užduoties identifikatorius yra lauke id arba request_id
{ "id": "…", … }

// Formatas priklauso nuo modelio: identifikatorių paimkite
// iš atsakymo į sukūrimo užklausą jo nekeisdami.
```

## Autorizacija

| Parametras | Tipas | Privalomas | Aprašymas |
| --- | --- | --- | --- |
| `Authorization` | header | privalomas | Raktas formatu `Bearer sk-…`. Taip pat tinka antraštės `x-api-key` arba `x-goog-api-key`. |

## Vaizdo įrašai: užklausos turinys

| Parametras | Tipas | Privalomas | Aprašymas |
| --- | --- | --- | --- |
| `model` | string | privalomas | Vaizdo įrašų modelis: `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 | privalomas | Vaizdo įrašo aprašymas. |
| `duration / seconds` | integer / string | neprivalomas | Priklauso nuo šeimos: Grok — 1–15 sekundžių, MiniMax — 6/10 su 768P arba 6 su 1080P, HappyHorse — 3–15; Google Omni — 4/6/8/10. Neperkelkite vienos šeimos lauko į kitą. |
| `resolution / size` | string | neprivalomas | Grok: 480p/720p/1080p (1080p — video-1.5), arba size 1280x720/720x1280/1920x1080/1080x1920. MiniMax: 768P/1080P. HappyHorse: 480P/720P/1080P. Google Omni: 360p/720p. |
| `image / first_frame_image / image_urls` | string / array | neprivalomas | Pradinių vaizdų laukai priklauso nuo šeimos ir režimo. MiniMax Fast reikalauja first\_frame\_image. HappyHorse t2v — be images, i2v — tiksliai vienas vaizdas be ratio, r2v — 1–9 vaizdai. |

Atsakyme pateikiamas užduoties identifikatorius (laukas `id` arba `request_id`). Naudokite jį nepakeistą, neanalizuodami: formatas priklauso nuo modelio. Būsena ir paruoštas failas:

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

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

Tie patys adresai veikia ir su prefiksu `/v1/videos/generations/{id}`. Baigtos užduoties būsena ir atsakymo laukų rinkinys priklauso nuo modelio — remkitės būsenos lauku ir gaukite failą per `/content`.

## Sukūrimas → būsena → atsisiuntimas

Išsaugokite sukūrimo atsakymą ir jo Request ID. MiniMax/HappyHorse atveju parengtį reiškia `status: completed`, atsakyme yra `content_url`, `data[]` ir usage. Grok atveju — `status: done` su `video.url`. Google Omni grąžina 202 queued, tada in\_progress su Retry-After, completed arba partial/content\_revoked. Nelaikykite kiekvieno 200 paruoštu vaizdo įrašu. Jei būsenos atsakyme yra `result_pending_check: true` (`status` tuo metu yra `in_progress`), rezultatas tikslinamas. Nekurkite užduoties iš naujo — patikrinkite ją vėliau per GET /v1/videos/{id} arba parašykite pagalbos tarnybai, nurodydami Request ID.

`/content` gali grąžinti MP4 tiesiogiai arba peradresuoti į pasirašytą failą. Jei atsakyme yra keli rezultatai lauke `data[]`, išsaugokite kiekvieną: apmokestinami visi pristatyti rezultatai. Atšaukti ar ištrinti vaizdo užduoties per API negalima. Ištrynus paruoštą failą nebegalima jo pasiekti, tačiau generavimas neatšaukiamas.

Mokama už paruošto vaizdo įrašo sekundes pasirinkta raiška arba už įrašą, kaip nurodyta kataloge. Visa kaina rezervuojama kuriant užduotį.

## Muzika

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

| Parametras | Tipas | Privalomas | Aprašymas |
| --- | --- | --- | --- |
| `model` | string | privalomas | `google/lyria`, `google/lyria-3-clip-preview`. |
| `prompt` | string | privalomas | Kūrinio aprašymas: žanras, instrumentai, nuotaika. |

Atsakyme `data[]` — nuorodos į paruoštus klipus. Viena užklausa modelis gali grąžinti kelis klipus; apmokestinamas kiekvienas pristatytas klipas.

Nesiųskite vaizdo įrašo ar muzikos užklausos pakartotinai, jei nutrūko ryšys: užduotis jau galėjo prasidėti. Pirmiausia patikrinkite būseną pagal identifikatorių arba parašykite pagalbos tarnybai, nurodydami Request ID.

Liko klausimų? Atsiųskite Request ID ir aprašymą — padėsime išsiaiškinti.[Rašyti pagalbos tarnybai](mailto:support@ailoot.ai)

## Ailoot · Įmonė ir jos projektų portfelis





Ailoot remiasi sukaupta veiklos patirtimi, plačia klientų baze, stabiliomis paslaugomis ir nuolatine KPI kontrole.





Įmonė ir jos projektų portfelis: milijonai klientų; mėnesio pardavimai siekia milijardus.





Ailoot šią veiklos patirtį pritaiko teikdama API prieigą prie DI funkcijų klientų produktuose, agentuose, programose ir automatizavimo sprendimuose.