Перейти к основному содержанию
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.6",
    "prompt": "A cute cat running on the grass",
    "aspect_ratio": "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.6",
    "prompt": "A cute cat running on the grass",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

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

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

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

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

​
model
string
обязательно
Имя модели генерации видео, фиксированное значение wan2.6
​
prompt
string
обязательно
Описание содержания видеоОбязательный в режиме text-to-video. Подробно опишите сцены, действия и стили для лучших результатовПример: "A cute cat stretching in the sunlight"
​
image_urls
array<url>
Массив URL опорных изображений (поддерживается только 1 изображение)Обязателен в режиме image-to-video. Поддерживает публично доступные URL изображенийПример: ["https://example.com/image.jpg"]
Система автоматически выбирает режим text-to-video или image-to-video в зависимости от наличия image_urls
​
negative_prompt
string
Негативный промпт, описывающий нежелательное содержаниеПример: "blurry, low quality, distorted"
​
aspect_ratio
string
по умолчанию:"16:9"
Соотношение сторон видеоВарианты:
  • 16:9 — пейзаж (по умолчанию)
  • 9:16 — портрет
  • 1:1 — квадрат
  • 4:3 — пейзаж
  • 3:4 — портрет
По умолчанию: 16:9
Не поддерживается в режиме image-to-video
​
resolution
string
по умолчанию:"720p"
Разрешение видеоВарианты:
  • 720p — стандартное (по умолчанию)
  • 1080p — высокая чёткость
По умолчанию: 720p
Разрешение 480p не поддерживается
Тарификация посекундная. Цена зависит от разрешения. Конкретные цены см. в каталоге моделей
​
duration
integer
по умолчанию:"5"
Длительность видео (секунды)Поддерживаемые значения: только 5, 10, 15 секундПо умолчанию: 5
​
seed
integer
Случайное зерно для воспроизводимости результатовПример: 12345
​
prompt_extend
boolean
Автоматически расширять ли промптПри включении система автоматически оптимизирует и обогащает ваш промпт
​
audio
boolean
Автоматически добавлять ли аудиоПри включении система генерирует подходящее аудио для видео
​
audio_url
string
URL заданного аудиоИмеет приоритет над параметром audio
Длительность аудио не может превышать длительность видео. Если аудио короче длительности видео, начало видео будет со звуком, а оставшаяся часть — без звука.
​
shot_type
string
Тип съёмкиВарианты:
  • single — один план
  • multi — несколько планов
​
watermark
boolean
Добавлять ли водяной знак
​
template
string
Имя шаблона эффекта для режима спецэффектов image-to-video
При использовании режима эффектов:
  • Требуется только одно изображение (передаётся через image_urls)
  • Промпт не нужен (модель игнорирует поле prompt)
Общие эффекты:
  • squish — сдавливание и сжатие
  • rotation — вращение
  • poke — тычок
  • inflate — надувание шара
  • dissolve — молекулярное растворение
  • melt — таяние от тепловой волны
  • icecream — мороженая планета
  • flying — магическая левитация
Эффекты для одного человека:
  • carousel — карусель времени
  • singleheart — Love You
  • dance1 — момент качания
  • dance2 — танцевальное движение
Дополнительные эффекты см. в документации шаблонов Alibaba Wanxiang

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

Соотношение сторонОписаниеРазмер 720pРазмер 1080p
16:9Пейзаж (по умолчанию)1280×7201920×1080
9:16Портрет720×12801080×1920
1:1Квадрат960×9601440×1440
4:3Пейзаж1088×8321632×1248
3:4Портрет832×10881248×1632

​
Ответ

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

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

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

{
  "model": "wan2.6",
  "prompt": "A cute cat stretching in the sunlight"
}

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

{
  "model": "wan2.6",
  "prompt": "A cute cat running on the grass",
  "negative_prompt": "blurry, low quality, distorted",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "seed": 12345,
  "prompt_extend": true,
  "audio": true,
  "shot_type": "single",
  "watermark": false
}

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

{
  "model": "wan2.6",
  "prompt": "A kitten running on the ground",
  "image_urls": ["https://upload.apimart.ai/f/apimart-models-images/9998233432754770-c059992d-9b01-47d5-810d-ea0502ac9279-image_task_01KD7SSXDBCEWZ869D6PF249ZW_0.png"],
  "resolution": "1080p",
  "duration": 10
}

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

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

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

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

  • Параметр prompt обязателен
  • Параметр image_urls не требуется

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

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