Перейти к основному содержанию
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": "wan2.5-preview",
    "prompt": "Sunset coastal highway, cinematic shot",
    "size": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

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

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": "wan2.5-preview",
    "prompt": "Sunset coastal highway, cinematic shot",
    "size": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

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

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

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

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

​
model
string
обязательно
Имя модели генерации видео, фиксированное значение wan2.5-preview
​
prompt
string
Описание содержания видеоОбязательный для text-to-video (без image_urls), опциональный, но рекомендуется для image-to-videoПодробно опишите сцены, действия и стили для лучших результатовПример: "Sunset coastal highway, cinematic shot"
​
image_urls
array<string>
Массив URL опорных изображений (поддерживается только 1 изображение)Обязателен в режиме image-to-video, поддерживает публично доступные URL изображений или Base64-кодирование (data:image/png;base64,...)Пример: ["https://example.com/image.jpg"]
Система автоматически выбирает режим text-to-video или image-to-video в зависимости от наличия image_urls. Не передавайте image_urls для режима text-to-video.
​
negative_prompt
string
Негативный промпт, описывающий нежелательное содержаниеМаксимум 500 символовПример: "blurry, low quality, distorted"
​
resolution
string
по умолчанию:"720p"
Разрешение видеоВарианты:
  • 480p — SD, поддерживает size: 16:9, 9:16, 1:1
  • 720p — HD (по умолчанию), поддерживает size: 16:9, 9:16, 1:1, 4:3, 3:4
  • 1080p — FHD, поддерживает size: 16:9, 9:16, 1:1, 4:3, 3:4
По умолчанию: 720p
Разрешение напрямую влияет на стоимость: 1080p > 720p > 480p.
480p поддерживает только соотношения 16:9, 9:16, 1:1. Передача 4:3 или 3:4 приведёт к ошибке.
​
duration
integer
по умолчанию:"5"
Длительность видео (секунды)Поддерживает только: 5 или 10 секундПо умолчанию: 5
​
size
string
по умолчанию:"16:9"
Соотношение сторон, действует только для text-to-video (без image_urls)Варианты зависят от resolution:480p:
  • 16:9 — пейзаж (по умолчанию)
  • 9:16 — портрет
  • 1:1 — квадрат
720p / 1080p:
  • 16:9 — пейзаж (по умолчанию)
  • 9:16 — портрет
  • 1:1 — квадрат
  • 4:3 — пейзаж
  • 3:4 — портрет
По умолчанию: 16:9
Для image-to-video соотношение сторон определяется входным изображением. Не передавайте size, иначе будет возвращена ошибка.
​
seed
integer
Случайное зерно (≥ 0), указание одного и того же зерна позволяет воспроизводить похожие результатыПример: 12345
​
prompt_extend
boolean
по умолчанию:"true"
Включить ли умное переписывание промптаЗначительно улучшает результаты для коротких промптов, но увеличивает время обработкиПо умолчанию: true
​
audio
boolean
по умолчанию:"true"
Автоматически добавлять ли аудиоПри включении система генерирует подходящее аудио для видеоПо умолчанию: true
Эта модель поддерживает только audio=true. Установка false для видео без звука не поддерживается.
​
audio_url
string
URL пользовательского аудио (wav/mp3, 3–30 секунд, ≤ 15 МБ)Если аудио длиннее длительности видео, оно будет автоматически обрезано; если короче — оставшаяся часть будет без звука
Требования к аудиофайлу:
  • Формат: wav, mp3
  • Длительность: 3–30 секунд
  • Размер: ≤ 15 МБ
​
watermark
boolean
по умолчанию:"false"
Добавлять ли водяной знак «AI Generated» (правый нижний угол)По умолчанию: false

​
Комбинации разрешения и соотношения сторон

Комбинации size и resolution соответствуют пиксельным размерам восходящего сервиса (действуют только для text-to-video):
Соотношение сторонОписаниеРазмер 480pРазмер 720pРазмер 1080p
16:9Пейзаж (по умолчанию)832×4801280×7201920×1080
9:16Портрет480×832720×12801080×1920
1:1Квадрат624×624960×9601440×1440
4:3Пейзаж-1088×8321632×1248
3:4Портрет-832×10881248×1632
480p поддерживает только соотношения 16:9, 9:16, 1:1. Передача 4:3 или 3:4 приведёт к ошибке. 720p и 1080p поддерживают все 5 соотношений.

​
Ответ

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

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

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

{
  "model": "wan2.5-preview",
  "prompt": "Sunset coastal highway, cinematic shot"
}

​
Сценарий 2: Текст в видео (полный набор параметров)

{
  "model": "wan2.5-preview",
  "prompt": "City night scene, neon lights and rain-soaked streets",
  "negative_prompt": "blurry, low quality, distorted",
  "size": "16:9",
  "resolution": "720p",
  "duration": 5,
  "seed": 12345,
  "prompt_extend": true,
  "audio": true,
  "watermark": false
}

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

{
  "model": "wan2.5-preview",
  "prompt": "Cat running on the grass",
  "image_urls": ["https://example.com/cat.jpg"],
  "resolution": "480p",
  "duration": 5
}

​
Сценарий 4: Изображение в видео (изображение Base64)

{
  "model": "wan2.5-preview",
  "prompt": "Make the cat stand up and walk",
  "image_urls": ["data:image/png;base64,iVBORw0KGgo..."],
  "duration": 5
}

​
Сценарий 5: Пользовательское аудио

{
  "model": "wan2.5-preview",
  "prompt": "Person dancing to the music",
  "image_urls": ["https://example.com/dancer.jpg"],
  "audio_url": "https://example.com/music.mp3",
  "resolution": "720p",
  "duration": 10
}

​
Описание режимов

​
Текст в видео (Text-to-Video)

  • Параметр prompt обязателен
  • Не передавайте image_urls
  • Используйте size для задания соотношения сторон

​
Изображение в видео (Image-to-Video)

  • Параметр image_urls обязателен (поддерживается только 1 изображение)
  • prompt опционален, используется для описания ожидаемых действий
  • Соотношение сторон определяется входным изображением, не передавайте size
Система автоматически выбирает режим в зависимости от наличия image_urls
Запрос результатов задачиГенерация видео — асинхронная задача, которая при отправке возвращает task_id. Используйте эндпоинт Получение статуса задачи для запроса прогресса и результатов генерации.