AI SETUPAPI
Платформа
API-документация

Veo

Veo 3.1

Создание и редактирование видео

POSThttps://api.aisetup.ru/v1/video/generations
Header:Authorization: Bearer YOUR_KEY

Параметры

ПараметрТипОписание
modelstring"veo-3-1-lite" | "veo-3-1-fast" | "veo-3-1-quality"
webhook_url*stringURL для webhook (необязателен). Поллинг: GET /v1/requests/{id}.
inputobjectПараметры запроса.
↳ promptstringТекстовое описание видео.
↳ aspect_ratio*stringСоотношение сторон: "16:9" | "9:16" | "auto". По умолчанию "16:9".
↳ resolution*stringРазрешение: "720" | "1080" | "4k". По умолчанию "720".
↳ image_url*stringURL первого кадра — img2video (только Fast / Quality).
↳ image_tail_url*stringURL последнего кадра (только Fast / Quality).
↳ images*string[]Референсные изображения — до 3 URL (только Fast, reference-режим).
* — опциональные поля.

Пример запроса

# text-to-video (Lite)
curl -s "https://api.aisetup.ru/v1/video/generations" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"veo-3-1-lite","input":{"prompt":"A serene mountain lake at sunrise, timelapse","aspect_ratio":"16:9","resolution":"1080"}}'

# img2video (Fast, первый + последний кадр)
curl -s "https://api.aisetup.ru/v1/video/generations" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"veo-3-1-fast","webhook_url":"https://your.site/hook","input":{"prompt":"Camera slowly pans right","image_url":"https://example.com/first.jpg","image_tail_url":"https://example.com/last.jpg"}}'

Ответы API

Структура ответа

ПолеТипОписание
idstringID запроса для polling / webhook.
statusstringrunning — генерация запущена.

Пример тела ответа (JSON)

{
  "id": "REQUEST_ID",
  "status": "running"
}

Получение результата

Webhook или polling, подробнее в карточке «Проверка статуса видео-запроса»

При успехе result.type = "video_generation", массив result.videos:

{
  "id": "REQUEST_ID",
  "status": "success",
  "result": {
    "type": "video_generation",
    "videos": [
      "https://cdn.aisetup.ru/.../result.mp4"
    ]
  }
}

Veo Omni Flash

Создание и редактирование видео

POSThttps://api.aisetup.ru/v1/video/generations
Header:Authorization: Bearer YOUR_KEY

Параметры

ПараметрТипОписание
modelstring"veo-omni-flash"
webhook_url*stringURL для webhook (необязателен). Поллинг: GET /v1/requests/{id}.
inputobjectПараметры запроса.
↳ promptstringТекстовое описание видео.
↳ duration*numberДлительность в секундах: 4 | 6 | 8 | 10. По умолчанию 4.
↳ aspect_ratio*stringСоотношение сторон: "16:9" | "9:16". По умолчанию "16:9".
↳ resolution*stringРазрешение: "720" | "1080" | "4k". По умолчанию "720".
↳ images*string[]Референсные изображения — до 7 URL.
↳ audio_ids*string[]Голоса для озвучки (до 3): achernar, achird, algenib, algieba, alnilam, aoede, autonoe, callirrhoe, charon, despina, enceladus, erinome, fenrir, gacrux, iapetus, kore, laomedeia, leda, orus, puck, rasalgethi, sadachbia, sadaltager, schedar, sulafat, umbriel, vindemiatrix, zephyr, zubenelgenubi.
* — опциональные поля.

Пример запроса

curl -s "https://api.aisetup.ru/v1/video/generations" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"veo-omni-flash","input":{"prompt":"Futuristic city at night with neon lights","duration":8,"aspect_ratio":"16:9","resolution":"1080","audio_ids":["charon"]}}'

Ответы API

Структура ответа

ПолеТипОписание
idstringID запроса для polling / webhook.
statusstringrunning — генерация запущена.

Пример тела ответа (JSON)

{
  "id": "REQUEST_ID",
  "status": "running"
}

Получение результата

Webhook или polling, подробнее в карточке «Проверка статуса видео-запроса»

При успехе result.type = "video_generation", массив result.videos:

{
  "id": "REQUEST_ID",
  "status": "success",
  "result": {
    "type": "video_generation",
    "videos": [
      "https://cdn.aisetup.ru/.../result.mp4"
    ]
  }
}