Перейти к основному содержанию
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": "grok-imagine-1.0-video-apimart",
    "prompt": "A dog running on the beach, sunny weather, slow motion",
    "size": "16:9",
    "duration": 6,
    "quality": "720p"
  }'

{
  "code": 200,
  "data": {
    "id": "task_01JNXXXXXXXXXXXXXXXXXX",
    "status": "submitted",
    "progress": 0,
    "created": 1710000000,
    "type": "video"
  }
}

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": "grok-imagine-1.0-video-apimart",
    "prompt": "A dog running on the beach, sunny weather, slow motion",
    "size": "16:9",
    "duration": 6,
    "quality": "720p"
  }'

{
  "code": 200,
  "data": {
    "id": "task_01JNXXXXXXXXXXXXXXXXXX",
    "status": "submitted",
    "progress": 0,
    "created": 1710000000,
    "type": "video"
  }
}

​
Авторизация

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

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

​
model
string
по умолчанию:"grok-imagine-1.0-video-apimart"
обязательно
Название модели генерации видеоПоддерживаемые модели:
  • grok-imagine-1.0-video-apimart — Grok-генерация видео
Пример: "grok-imagine-1.0-video-apimart"
​
prompt
string
обязательно
Описание содержимого видео, поддерживает несколько языков
​
size
string
по умолчанию:"16:9"
Размер видеоВарианты:
  • 16:9 — горизонтальное (по умолчанию)
  • 9:16 — вертикальное
  • 1:1 — квадратное
  • 3:2 — горизонтальное
  • 2:3 — вертикальное
​
duration
integer
по умолчанию:6
Длительность видео (секунды)Диапазон: 6–30 (минимум 6 секунд, максимум 30 секунд)⚠️ Примечание: должно быть обычным числом (например, 6), без кавычек, иначе произойдёт ошибка
​
quality
string
по умолчанию:"480p"
Качество видеоВарианты:
  • 480p — стандартное разрешение (по умолчанию)
  • 720p — высокое разрешение
​
image_urls
string[]
Список URL референсных изображенийОграничения:
  • Не более 7 изображений
  • Должны быть публично доступными URL
  • Формат Base64 не поддерживается
После загрузки референсного изображения соотношение сторон будет автоматически соответствовать соотношению сторон референсного изображения.

​
Ответ

​
code
integer
Код состояния ответа
​
data
object
Объект данных ответа
Получение результата задачиГенерация видео — это асинхронная задача. После отправки возвращается id (то есть task_id). Используйте эндпоинт Получить статус задачи, чтобы узнать прогресс и результаты генерации.

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

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

{
  "model": "grok-imagine-1.0-video-apimart",
  "prompt": "A dog running on the beach, sunny weather, slow motion",
  "size": "16:9",
  "duration": 6
}

​
Сценарий 2: Изображение в видео

{
  "model": "grok-imagine-1.0-video-apimart",
  "prompt": "Bring the scene to life with natural dynamic effects",
  "image_urls": ["https://example.com/start.png"],
  "size": "16:9",
  "duration": 10,
  "quality": "720p"
}