Справочник API

Что такое этот API

API MyDreamVid позволяет вашему собственному ПО генерировать видео и изображения моделями Seedance и Seedream — без единого клика в студии. Ваша программа отправляет промпт (и при необходимости референс-файлы), мы применяем те же проверки безопасности и те же цены, что и в веб-студии, а ваша программа забирает готовый файл. Кредиты списываются с того же баланса аккаунта.

Для кого он

• Команды, генерирующие в объёме: каталоги товаров, варианты рекламы, клипы для соцсетей, локализованные версии одного видео.
• Разработчики, добавляющие генерацию видео или изображений в своё приложение, инструмент, бота или внутренний пайплайн.
• Агентства и студии, которым нужен собственный фронтенд, пока мы отвечаем за модели, очереди и оплату.

Если вы делаете несколько видео в неделю вручную, API вам не нужен. Студия умеет всё то же самое и по тем же ценам.

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

Каждый запрос несёт bearer-ключ. Ключи создаются в студии и показываются один раз.

• Заголовок: Authorization: Bearer mdv_live_…
• Права write позволяют создавать и отменять задачи и загружать файлы; read — только просматривать списки и получать данные.
• Ключи доступны после пополнения Creator ($25) или Studio ($50). Кредиты не сгорают.
• API предназначен для вызова с вашего сервера. Не встраивайте ключи в браузерный или мобильный код.

Сначала узнайте цену

Каждая задача стоит кредитов (1 кредит = $0,01). Запросите расчёт до создания: это бесплатно, не требует Idempotency-Key и возвращает ровно ту сумму, которую задача зарезервирует. То же число приходит как credits_reserved при создании задачи, а credits_charged у завершённой задачи — то, что вы реально заплатили (неиспользованная часть резерва возвращается).

GET /v1/credits в любой момент показывает доступный и зарезервированный баланс. Задачи, созданные через API, также видны в студии в «Моих работах» и в истории кредитов.

Эндпоинты

• GET /v1/models — Модели с длительностями, разрешениями, соотношениями сторон, ценами в кредитах за секунду и лимитами референсов.
• POST /v1/videos/quote — Точная стоимость задачи в кредитах. Бесплатно, без резервирования.
• POST /v1/videos — Создать задачу. Тело: kind (t2v | i2v | r2v), model, prompt, duration_s, resolution, ratio, опционально generate_audio, references. Требует Idempotency-Key.
• GET /v1/videos/{id} — Статус задачи; у успешной задачи есть video_url.
• GET /v1/videos — Ваши задачи, новые первыми, курсорная пагинация (limit, cursor).
• POST /v1/videos/{id}/cancel — Отменить задачу в статусе waiting или queued.
• POST /v1/files/presign — Слот загрузки для референс-изображения, видео или аудиофайла.
• POST /v1/files/{media_id}/confirm — Завершить загрузку: файл анализируется и проходит проверку безопасности, после чего может использоваться как референс.
• GET /v1/credits — Доступные и зарезервированные кредиты.

Лимиты

• 60 запросов в минуту на ключ.
• 2 задачи в работе (waiting, queued или running) на аккаунт через API.
• Полосы моделей общие для всех; когда полоса занята, задача ждёт своей очереди и отправляется автоматически.
• До 5 активных ключей на аккаунт.
• Файлы: изображения до 10 МБ, видео до 50 МБ, аудио до 20 МБ. Референс-видео — не короче 2 секунд; видео и аудио — не длиннее 5 минут.