apimart-zoe API

apimart-zoe — мультимодальная нейросеть APIMart для генерации видео; для вызова используется ID модели apimart-zoe. apimart-zoe API поддерживает генерацию по тексту, по первому и последнему кадру, по референсам из изображений, видео и аудио, редактирование готового видео, генерацию звука вместе с видео по выбору, а также двухэтапный сценарий «черновик 480p → финал 1080p». Длина клипа — 4–30 секунд, разрешение — 480p, 720p, 1080p, 2k или 4k.

Отправьте POST /v1/videos/generations с model apimart-zoe и промптом, указав заголовок Authorization: Bearer <API-ключ>. В ответе придёт task_id. Генерация обычно занимает 1–3 минуты: опрашивайте GET /v1/tasks/{task_id} каждые 5–10 секунд, пока data.status не станет completed, затем возьмите URL видео из data.result.videos[0].url[0]. В примере на этой странице есть код на cURL и Python, а полный справочник apimart-zoe API — в документации APIMart.

Обязателен model (apimart-zoe). prompt обязателен для генерации по тексту, необязателен, если вы передаёте только медиа, и может содержать до 204 800 символов. Необязательные параметры: resolution (480p, 720p, 1080p, 2k или 4k), aspect_ratio или size (21:9, 16:9, 4:3, 1:1, 3:4, 9:16 или adaptive), duration или seconds (4–30 или -1), audio или generate_audio, seed, image_with_roles, image_urls (псевдонимы image, images, image_url), first_frame_image, last_frame_image, video_urls, audio_urls, draft, draft_task_id, omni_reference_task_type (auto, reference или edit), return_last_frame, output_format или response_format (mp4 или mov) и enhance_prompt, а также поле платформы APIMart nsfw_check. negative_prompt, camera_fixed (включая camerafixed), extend_from_task_id, mask_url, video_list, element_list, multi_shot и tools не поддерживаются: если поле есть в запросе, даже пустое, false или null, возвращается 400. n можно только не передавать или передать 1. Значения по умолчанию и ограничения указаны в таблице параметров на этой странице.

Задайте duration (или seconds) целым числом от 4 до 30; по умолчанию 5, а -1 позволяет модели выбрать длительность самой. resolution — 480p, 720p (по умолчанию), 1080p, 2k или 4k, регистр не важен. aspect_ratio (также принимается как size) — 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 или adaptive (по умолчанию: кадр определяет модель или ваши медиа). При редактировании видео не передавайте duration и aspect_ratio (или передайте -1 и adaptive): длина и кадр повторяют исходное видео. Черновики всегда в 480p, финалы — в 1080p.

Да. Передайте first_frame и last_frame в image_with_roles или используйте first_frame_image и last_frame_image. На каждый кадр — одно изображение, а последний кадр требует первого. Запрос с первым и последним кадром не может одновременно содержать референсные изображения, видео или аудио: такой запрос возвращает 400 и не оплачивается. Опишите в промпте, как камера переходит от одного кадра к другому.

До 30 референсных изображений, 10 видео и 10 аудиофрагментов — не более 50 файлов в сумме; референсное аудио передаётся только вместе с референсным изображением или видео. Изображения — jpeg, png, webp, bmp, tiff, gif, heic или heif, сторона 300–6000 пикселей, соотношение сторон 0,4–2,5, до 30 МБ. Видео — mp4 или mov (H.264/H.265, звуковая дорожка AAC или MP3), 2–15 секунд каждое (допускается 1,8–15,2 с) и до 200 МБ, ширина и высота по 300–6000 пикселей, ширина × высота от 409 600 до 8 295 044 (примерно от 640×640 до 3840×2160), соотношение сторон 0,4–2,5, 24–60 кадров/с после округления (23,976 и 59,94 допустимы); исходное видео для редактирования может длиться 4–30 секунд (не меньше 3,8 с и короче 30,2 с), а без указания типа задачи видео длиннее 15 секунд требуют edit. Аудио — wav или mp3, 2–15 секунд (1,8–15,2 с) и до 15 МБ каждый фрагмент, не более 30 секунд в сумме (до 30,2 с). Длина, размеры, соотношение сторон и частота кадров референсных видео, а также длина референсного аудио проверяются при отправке: при несоответствии возвращается 400 invalid_request_error, оплата не списывается. Размеры изображений, объём файлов и кодировка проверяются во время генерации: при несоответствии задача завершается ошибкой, а сумма возвращается автоматически, поэтому проверяйте файлы заранее. Все медиа передаются только по публичным http(s) URL или как asset:// ID; data: URI не принимаются, поэтому сначала загрузите файлы по публичному адресу. При отправке APIMart сам регистрирует каждый файл, а тот же файл в течение 7 дней повторно не регистрируется. Если вы отправляете только медиа, prompt можно не указывать.

Отправьте запрос с draft: true и получите недорогое превью в 480p; черновик может быть только в 480p и не сочетается с редактированием видео. После успешного черновика отправьте второй запрос с model и draft_task_id, равным task_id черновика. Финал рендерится в 1080p и берёт промпт, медиа, длительность, формат кадра, seed и настройку звука из черновика. Кроме model, draft_task_id, resolution и общих полей вроде nsfw_check или webhook, передавать ничего нельзя: prompt, медиа, duration, aspect_ratio, seed, audio, omni_reference_task_type, return_last_frame, output_format или enhance_prompt вернут 400, даже пустые. Создайте финал в течение 24 часов после черновика: draft_task_id, которого нет, который не является черновиком, ещё не готов или старше 24 часов, возвращает 400. Черновик и финал оплачиваются как отдельные генерации; финал тарифицируется по 1080p с длительностью черновика (если черновик был с -1 — по его фактической длине).

Ошибки отправки возвращаются объектом error с полями message, type, param и code и не оплачиваются. 400 invalid_request_error — недопустимые значения, количество и сочетание медиа (например, первый и последний кадр вместе с референсами или image_urls вместе с image_with_roles), длина, размеры, соотношение сторон или частота кадров референсного видео и длина референсного аудио вне допустимых пределов, правила типа задачи и редактирования видео, значения output_format, правила черновика и финала, а также неподдерживаемые параметры вроде negative_prompt или camera_fixed. 400 input_video_probe_failed — референсное видео недоступно или его длину не удалось определить. 402 payment_required — недостаточно средств; для duration -1 и редактирования видео резервируется 30 секунд. 400 nsfw_content_detected — сработала проверка nsfw_check; в message указаны выявленные категории. 503 draft_channel_unavailable или draft_task_unavailable — черновики временно недоступны: повторите позже или создайте черновик заново.

Клип обычно готов за 1–3 минуты, поэтому опрашивайте задачу каждые 5–10 секунд. data.status принимает значения pending, processing, completed или failed, а data.progress — от 0 до 100. URL видео в data.result.videos[0].url хранится на APIMart и истекает через 72 часа после завершения, поэтому скачайте файл вовремя. С return_last_frame: true в data.result.last_frame_url также придёт последний кадр в виде png-изображения. Если задача не выполнится, в том числе когда медиа не прошли регистрацию или при генерации не пройдена проверка размеров изображения, объёма файла или кодировки, data.error.message укажет причину, data.error.code будет task_failed, а data.cost — 0: зарезервированная сумма возвращается автоматически.

apimart-zoe API тарифицируется за секунду результата: есть ставки для 480p, 720p, 1080p, 2k и 4k и отдельная ставка для запросов с референсным видео. Если вы задали duration (4–30) или оставили значение по умолчанию 5, оплачивается запрошенное число секунд — после завершения оно не пересчитывается по длине ролика. Для duration -1 и редактирования видео (omni_reference_task_type: edit) предварительно списываются 30 секунд, а после завершения сумма пересчитывается по фактической длине ролика, округлённой до целых секунд; редактирование видео тарифицируется по ставке для запросов с референсным видео. С референсным видео оплачиваемые секунды = длительность видео + max(общая длина референсных видео, ⌈длительность видео × 2/3⌉); длина референсов измеряется при отправке по каждому видео, суммируется, округляется вниз до целых секунд и потом не меняется. Финал из черновика тарифицируется по 1080p с длительностью черновика (если черновик был с -1 — по его фактической длине) и, если в черновике было референсное видео, тоже учитывает его длину. Итоговое списание зависит от скидки вашего уровня членства или группы аккаунта — смотрите таблицу цен на этой странице.

На APIMart обе модели используют POST /v1/videos/generations и GET /v1/tasks/{task_id}, создают клипы длиной 4–30 секунд в форматах кадра от 21:9 до 9:16, принимают до 30 референсных изображений, 10 видео и 10 аудиофрагментов в запросе, поддерживают seed, генерацию звука, return_last_frame, output_format и редактирование видео (omni_reference_task_type: edit), а также сценарий «черновик 480p → финал 1080p». Различия: apimart-zoe (ID модели apimart-zoe) дополнительно выводит 2k и 4k, не разрешает передавать первый и последний кадр вместе с референсами, требует референсное изображение или видео при передаче референсного аудио и, если audio не указан, оставляет решение о звуке модели; у Seedance 2.5 (seedance-2.5) generate_audio включён по умолчанию, и она дополнительно поддерживает продление видео (extend), которое в apimart-zoe пока не открыто. С референсным видео модели также по-разному считают оплачиваемые секунды. Все различия и текущие цены за секунду приведены в таблицах сравнения на этой странице.

Зависит от разрешения и от того, используете ли вы референсное видео. Сравнение цен на этой странице показывает текущие ставки за секунду обеих моделей с референсным видео и без него, разницу в процентах и примеры стоимости для типичной длины клипа. С референсным видео apimart-zoe добавляет к секундам результата max(общие секунды референсных видео с округлением вниз, ⌈секунды результата × 2/3⌉), а Seedance 2.5 — секунды референсного видео, поэтому сравнивайте пример, близкий к вашему клипу. У apimart-zoe также есть тарифы 2k и 4k, которых нет у Seedance 2.5. Ставки берутся из API цен APIMart и зависят от уровня членства.

Нет. Это платный API с оплатой по факту за каждую секунду результата; черновик и финал из него оплачиваются как отдельные генерации. Ошибки при отправке не оплачиваются, при недостатке средств запрос возвращает 402, а за неудачные задачи средства возвращаются автоматически и data.cost равен 0. Цена зависит от уровня членства или группы аккаунта; актуальная цена для каждого разрешения указана в таблице цен на этой странице.

Чтобы купить доступ, зарегистрируйтесь на APIMart, откройте страницу API Keys в личном кабинете и создайте ключ, затем передавайте его как Authorization: Bearer <key>. Тот же ключ подходит для apimart-zoe API и других моделей APIMart: оплата по факту, без подписки.