Перейти к основному содержанию
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": "kling-3.0-turbo",
    "prompt": "Корги бежит по берегу моря, кинематографичность, свет заката",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": 5
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kling-3.0-turbo",
    "prompt": "Корги бежит по берегу моря, кинематографичность, свет заката",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": 5
  }'

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

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

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

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

​
model
string
обязательно
Название модели генерации видеоПоддерживаемые модели:
  • kling-3.0-turbo - Kling 3.0 Turbo
​
prompt
string
обязательно
Текстовый промптОграничение вышестоящего сервиса — не более 3072 символов, рекомендуется не более 2500 символов.Пример: "Корги бежит по берегу моря, кинематографичность, свет заката"
​
first_frame_image
string
Поддерживается URL изображения или Base64.
Ограничения вышестоящего сервиса для изображения первого кадра:
  • Формат: .jpg / .jpeg / .png
  • Размер: ≤ 50MB
  • Ширина и высота: ≥ 300px
  • Соотношение сторон: 1:2.5 ~ 2.5:1
​
aspect_ratio
string
по умолчанию:"16:9"
Соотношение сторон видеоДопустимые значения:
  • 16:9 - горизонтальное
  • 9:16 - вертикальное
  • 1:1 - квадратное
Значение по умолчанию: 16:9
Действует только для генерации из текста. При генерации из изображения это поле не действует, соотношение сторон видео определяется первым кадром.
​
resolution
string
по умолчанию:"720p"
Четкость видеоДопустимые значения:
  • 720p
  • 1080p
Значение по умолчанию: 720p
​
duration
integer
по умолчанию:"5"
Длительность видео (секунды)Диапазон значений: 3-15 (минимум 3 секунды, максимум 15 секунд)Значение по умолчанию: 5⚠️ Внимание: необходимо вводить только число (например, 6), без кавычек, иначе возникнет ошибка
​
watermark
boolean
Добавлять ли водяной знакПередается вышестоящему сервису только при явной передаче; если не передавать, водяной знак не добавляется.

​
Генерация из текста vs генерация из изображения

Система автоматически определяет режим генерации в зависимости от того, передан ли first_frame_image: при наличии изображения первого кадра выполняется генерация из изображения, без него — генерация из текста; пользователю не нужно явно это указывать.
ПараметрГенерация из текстаГенерация из изображения
prompt✅ обязателен✅ необязателен (если оставить пустым, генерация исключительно по первому кадру)
first_frame_image❌ не передается✅ обязателен
aspect_ratio✅ необязателен❌ не действует (соотношение определяется первым кадром)
resolution✅ необязателен✅ необязателен
duration✅ необязателен (3-15)✅ необязателен (3-15)
watermark✅ необязателен✅ необязателен

​
Ответ

​
code
integer
Код статуса ответа, при успехе равен 200
​
data
array
Массив возвращаемых данных

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

​
Сценарий 1: генерация из текста (1080P)

{
  "model": "kling-3.0-turbo",
  "prompt": "Корги бежит по берегу моря, кинематографичность, свет заката",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}

​
Сценарий 2: генерация из текста (вертикальное 720P)

{
  "model": "kling-3.0-turbo",
  "prompt": "Перекресток Сибуя в Токио, дождливая ночь, неоновые огни отражаются на мокром асфальте, прохожие идут под зонтами",
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "duration": 10
}

​
Сценарий 3: генерация из изображения (изображение первого кадра)

{
  "model": "kling-3.0-turbo",
  "prompt": "Камера медленно приближается, человек улыбается",
  "first_frame_image": "https://cdn.example.com/first.jpg",
  "resolution": "720p",
  "duration": 5
}

​
Сценарий 4: генерация видео только по первому кадру (без промпта)

{
  "model": "kling-3.0-turbo",
  "first_frame_image": "https://cdn.example.com/first.jpg",
  "resolution": "1080p",
  "duration": 5
}

​
Сценарий 5: раскадровка с несколькими планами (генерация из текста)

{
  "model": "kling-3.0-turbo",
  "prompt": "План 1,2,корги бежит по берегу моря；План 2,3,камера приближается, человек улыбается；",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}
Запрос результата задачиГенерация видео является асинхронной задачей; после отправки возвращается task_id. Используйте интерфейс Получение статуса задачи, чтобы запросить прогресс и результат генерации.