Генерация видео apimart-zoe

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "apimart-zoe",
    "prompt": "Рыжий котёнок на подоконнике смотрит в камеру, солнечный свет падает сбоку, камера медленно приближается",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 8,
    "audio": true,
    "nsfw_check": true,
    "return_last_frame": true
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/videos/generations",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "apimart-zoe",
        "prompt": "Рыжий котёнок на подоконнике смотрит в камеру, солнечный свет падает сбоку, камера медленно приближается",
        "resolution": "1080p",
        "aspect_ratio": "16:9",
        "duration": 8,
        "audio": True,
        "nsfw_check": True,
        "return_last_frame": True
    }
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "model": "apimart-zoe",
    "prompt": "Рыжий котёнок на подоконнике смотрит в камеру, солнечный свет падает сбоку, камера медленно приближается",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 8,
    "audio": true,
    "nsfw_check": true,
    "return_last_frame": true
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

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

​

Выбор режима

​

Заголовки

​

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

​

Адреса и ограничения материалов

​

Проверка референсного видео

​

Правила сочетания материалов

• Нельзя одновременно передавать image_urls и image_with_roles: при отправке возвращается HTTP 400 (invalid_request_error) без оплаты. Псевдонимы image, images, image_url также считаются image_urls и не обходят это ограничение.
• Первый/последний кадры нельзя сочетать в одном запросе с референсными изображениями, видео или аудио.
• Не более одного первого и одного последнего кадра. Последний кадр требует первого.
• До 30 изображений, 10 видео и 10 аудиореференсов; всего не более 50 материалов.
• Нарушение ограничений сочетания или количества возвращает синхронный HTTP 400 без списания средств.
• Для omni_reference_task_type: "edit" нужно хотя бы одно исходное видео (3.8 ≤ t < 30.2 секунд). duration / seconds: только пропуск или -1; aspect_ratio / size: только пропуск или adaptive. Нельзя сочетать с draft: true. Для auto/reference сохраняются 2–15 секунд с указанным допуском.

​

Примеры запросов

​

Первый и последний кадры

{
  "model": "apimart-zoe",
  "prompt": "Плавный переход от первого кадра к последнему с сохранением освещения",
  "image_with_roles": [
    {
      "url": "https://example.com/start.jpg",
      "role": "first_frame"
    },
    {
      "url": "https://example.com/end.jpg",
      "role": "last_frame"
    }
  ],
  "duration": 6
}

​

Изображения, видео и аудио как референсы

{
  "model": "apimart-zoe",
  "prompt": "Персонаж с изображения естественно движется в сцене из референсного видео, музыка соответствует ритму изображения",
  "image_urls": [
    "https://example.com/character.jpg"
  ],
  "video_urls": [
    "https://example.com/scene.mp4"
  ],
  "audio_urls": [
    "https://example.com/bgm.mp3"
  ],
  "duration": -1
}

​

Редактирование видео

{
  "model": "apimart-zoe",
  "prompt": "Превратить сцену в классический чёрно-белый фильм, сохранив движение камеры и композицию",
  "video_urls": [
    "https://example.com/source_20s.mp4"
  ],
  "omni_reference_task_type": "edit"
}

​

Последний кадр, MOV и оптимизация промпта

{
  "model": "apimart-zoe",
  "prompt": "Рыжий котёнок на подоконнике смотрит в камеру, солнечный свет падает сбоку, камера медленно приближается",
  "duration": 5,
  "return_last_frame": true,
  "output_format": "mov",
  "enhance_prompt": true
}

​

Черновик → финальное видео

1. Отправьте черновик с draft: true. Если resolution опущен, используется 480p; при явном указании также допустим только 480p.

{
  "model": "apimart-zoe",
  "prompt": "Рыжий котёнок на подоконнике смотрит в камеру, солнечный свет падает сбоку, камера медленно приближается",
  "draft": true
}

2. Дождитесь успеха черновика и отправьте его task_id для финального видео. Достаточно model и draft_task_id. При явном указании resolution допустим только 1080p.

{
  "model": "apimart-zoe",
  "draft_task_id": "task_01KZOEEXAMPLE"
}

​

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

curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task_01KZOEEXAMPLE \
  --header 'Authorization: Bearer <token>'

{
  "code": 200,
  "data": {
    "id": "task_01KZOEEXAMPLE",
    "status": "completed",
    "result": {
      "videos": [
        {
          "url": [
            "https://example.com/generated-video.mp4"
          ],
          "expires_at": 1794475442
        }
      ],
      "last_frame_url": "https://example.com/generated-last-frame.png"
    },
    "progress": 100,
    "completed": 1794389042
  }
}

​

Правила оплаты

• Суммарная длительность референсных видео R: измерить каждую при отправке, сложить и округлить сумму вниз до целых секунд. Далее не корректируется.
• Без референсных видео: оплачиваемые секунды = D. С ними: D + max(R, ceil(D × 2/3)). ceil округляет вверх до целого. Используется тариф с референсным видео.
• Пример: запрос 8 секунд даёт D = 8, даже если результат длится 8.2 секунды. Автоматическая длительность 8.5 секунды даёт D = 9. Референсы 2.8 и 3.8 секунды сначала суммируются до 6.6, затем округляются вниз: R = 6.
• Черновик (480p) и финальное видео (1080p) оплачиваются отдельно. Исходная длительность референсов черновика учитывается и для финального видео; загружать их повторно не нужно.
• Отклонённые запросы не оплачиваются. При неудаче задачи средства возвращаются автоматически.

​

Частые ошибки