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

# 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 мәнін тексеріңіз.

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

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

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

Авторизация

• Authorizationheaderміндетті

  Кілт мына пішімде Bearer sk-…. Сондай-ақ мына тақырыптар жарайды: x-api-key немесе x-goog-api-key.

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

• modelstringміндетті

  Бейне моделі: 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.

• promptstringміндетті

  Бейненің сипаттамасы.

• duration / secondsinteger / stringміндетті емес

  Модельдер тобына байланысты: Grok 1–15 секунд, MiniMax 768P үшін 6/10 немесе 1080P үшін 6, HappyHorse 3–15; Google Omni 4/6/8/10. Бір топтың өрісін басқасына көшірмеңіз.

• resolution / sizestringміндетті емес

  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_urlsstring / arrayміндетті емес

  Бастапқы сурет өрістері модельдер тобы мен режимге байланысты. MiniMax Fast үшін first_frame_image қажет. HappyHorse t2v — images жоқ, i2v — ratio көрсетілмеген дәл бір сурет, r2v — 1–9 сурет.

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

Осы мекенжайлар мына префикспен де жұмыс істейді: /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 арқылы бейне тапсырмасын болдырмау немесе жою мүмкін емес. Дайын файлды жою оған қол жеткізуді жабады, бірақ генерацияны болдырмайды.

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

Музыка

• modelstringміндетті

  google/lyria, google/lyria-3-clip-preview.

• promptstringміндетті

  Тректің сипаттамасы: жанры, аспаптары, көңіл күйі.

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