Перейти к основному содержанию
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "Omni-Flash-Ext",
    "prompt": "a girl is dancing happily in a sunny garden",
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "9:16"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KS1H7ZYSJWH1N779S2FSHTKA"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "Omni-Flash-Ext",
    "prompt": "a girl is dancing happily in a sunny garden",
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "9:16"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KS1H7ZYSJWH1N779S2FSHTKA"
    }
  ]
}

​
Аутентификация

​
Authorization
string
обязательно
Все запросы требуют аутентификации по Bearer Token.Получение API-ключа:Перейдите на страницу управления API-ключами, чтобы получить свой API-ключ.При выполнении запросов добавляйте следующий заголовок:
Authorization: Bearer YOUR_API_KEY

​
Параметры запроса

​
model
string
обязательно
Название модели генерации видео. Должно быть Omni-Flash-Ext.
​
prompt
string
обязательно
Описание содержимого видео. Рекомендуем подробно описывать сцену, субъект, действие, окружение, движение камеры, визуальный стиль и звуковые подсказки.Пример: "a girl is dancing happily in a sunny garden"
​
duration
integer
по умолчанию:"6"
Длительность видео в секундах.Поддерживаемые значения: 4, 6, 8, 10.
Другие значения, такие как 5 или 7, вернут ошибку invalid_duration.
Не передавайте duration при загрузке референсного видео. duration и video_urls нельзя передавать одновременно.
​
resolution
string
по умолчанию:"720p"
Разрешение видео. Значения нечувствительны к регистру.Поддерживаемые значения:
  • 720p
  • 1080p
  • 4k
Другие разрешения вернут ошибку invalid_resolution.
​
aspect_ratio
string
по умолчанию:"16:9"
Соотношение сторон видео. Используется для выбора горизонтального или вертикального вывода.Распространённые значения:
  • 16:9 — горизонтальное
  • 9:16 — вертикальное
По умолчанию: 16:9
​
size
string
Поле совместимости. Имеет то же значение, что и aspect_ratio. Если переданы оба, поддерживайте их согласованность.
​
image_urls
array<url>
Массив URL референсных изображений. Можно не указывать, передать 1 изображение или 3 изображения:
  • Не указан или пустой массив: Text-to-Video
  • 1 изображение: Image-to-Video по одному изображению
  • 3 изображения: слияние референсных изображений
Поддерживаются только публично доступные URL изображений.
Режим «первый кадр + последний кадр» с 2 изображениями не поддерживается. Передача 2 изображений вернёт ошибку unsupported_image_count. 4 и более изображений полностью не проверены и не рекомендуются.
​
video_urls
array<url>
Массив URL референсных видео. Можно не указывать или передать 1 референсное видео.Поддерживаются только публично доступные HTTP/HTTPS URL видео. Можно передавать вместе с image_urls: изображения используются как референс идентичности или композиции, а видео — как референс движения.
Omni-Flash-Ext поддерживает только 0 или 1 референсное видео. Передача 2 или более видео вернёт ошибку unsupported_video_count.
Не передавайте duration при передаче video_urls. video_urls и duration нельзя передавать одновременно.

​
Ответ

​
code
integer
Код состояния ответа. Успешные запросы возвращают 200.
​
data
array
Возвращаемый массив задач.

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

Генерация видео асинхронна. После отправки API возвращает task_id. Используйте эндпоинт Получить статус задачи, чтобы узнать прогресс и результаты.
cURL
curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task_01KS1H7ZYSJWH1N779S2FSHTKA \
  --header 'Authorization: Bearer <token>'
Рекомендуем подождать 5–10 секунд после отправки перед первым запросом, а затем опрашивать каждые 5–10 секунд. Обычно одна задача выполняется примерно за 3–5 минут.

​
Пример успешного результата

{
  "code": 200,
  "data": {
    "id": "task_01KS1H7ZYSJWH1N779S2FSHTKA",
    "status": "completed",
    "progress": 100,
    "created": 1779246294,
    "completed": 1779246534,
    "actual_time": 240,
    "estimated_time": 600,
    "cost": 0.4,
    "result": {
      "videos": [
        {
          "url": ["https://cdn.example.com/videos/abc.mp4"],
          "expires_at": 1779332760
        }
      ]
    }
  }
}

​
Пример неудачного результата

{
  "code": 200,
  "data": {
    "id": "task_01KS1H7ZYSJWH1N779S2FSHTKA",
    "status": "failed",
    "progress": 100,
    "created": 1779246294,
    "completed": 1779246534,
    "actual_time": 240,
    "estimated_time": 600,
    "cost": 0,
    "error": {
      "message": "invalid duration 7, must be one of 4/6/8/10",
      "code": "task_failed"
    }
  }
}

​
Сценарии использования

​
Сценарий 1: Текст в видео

{
  "model": "Omni-Flash-Ext",
  "prompt": "a beautiful sunset over the ocean with seagulls flying",
  "duration": 6,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

​
Сценарий 2: видео по одному изображению

{
  "model": "Omni-Flash-Ext",
  "prompt": "make the character smile and slowly turn around, cinematic camera motion",
  "duration": 6,
  "resolution": "1080p",
  "aspect_ratio": "9:16",
  "image_urls": ["https://example.com/character.jpg"]
}

​
Сценарий 3: слияние 3 референсных изображений

{
  "model": "Omni-Flash-Ext",
  "prompt": "a creative scene combining these elements with smooth camera motion",
  "duration": 10,
  "resolution": "1080p",
  "aspect_ratio": "9:16",
  "image_urls": [
    "https://example.com/scene.jpg",
    "https://example.com/character.jpg",
    "https://example.com/product.jpg"
  ]
}

​
Сценарий 4: короткое видео 4K

{
  "model": "Omni-Flash-Ext",
  "prompt": "close-up of a hummingbird hovering in front of a red flower",
  "duration": 4,
  "resolution": "4k",
  "aspect_ratio": "16:9"
}

​
Сценарий 5: генерация с референсным видео

{
  "model": "Omni-Flash-Ext",
  "prompt": "the same scene but at night with neon lights",
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "video_urls": ["https://example.com/reference.mp4"]
}

​
Коды ошибок

HTTPТип ошибкиЗначениеРекомендуемое действие
400invalid_request_errormodel не Omni-Flash-Ext, prompt пустой или JSON-формат недопустимПроверьте тело запроса
400invalid_durationduration не равен 4, 6, 8 или 10Используйте поддерживаемую длительность
400invalid_resolutionresolution не равно 720p, 1080p или 4kИспользуйте поддерживаемое разрешение
400unsupported_image_countКоличество image_urls не поддерживается, чаще всего вызвано передачей 2 изображенийИспользуйте 0, 1 или 3 изображения
400unsupported_video_countКоличество video_urls не поддерживается, чаще всего вызвано передачей 2 или более видеоИспользуйте 0 или 1 референсное видео
401authentication_errorНедействительный токенПроверьте Bearer Token
402payment_requiredНедостаточно средствПополните баланс и попробуйте снова
429rate_limit_errorПревышен лимит частоты запросовУменьшите параллелизм или повторите попытку позже
При сбое задачи API статуса задачи возвращает причину сбоя в data.error. Распространённые причины включают временное исчерпание квоты у поставщика, провал модерации содержимого или таймаут со стороны поставщика.