Документация API

Начало работы

API DeepManim позволяет программно создавать учебные анимационные видео. Создавайте видео из текстовых запросов, улучшайте их итеративно и добавляйте озвучку — всё через простой REST API.

• Аудио при генерацииПри создании нового видео через /generate озвучка включается по умолчанию.
• При изменениях аудио нетРезультат улучшения видео через /improve не содержит аудио. Сначала завершите все изменения, затем добавьте аудио через /audio, когда видео вас устроит.
• Расчётное времяГенерация видео занимает примерно 6 минут. Поле estimated_time_remaining_seconds в ответе задания показывает текущий обратный отсчёт.

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

Для всех запросов API нужен ключ API. Создайте его в приложении: Настройки → Ключи API. Передайте ключ в заголовке Authorization:

Authorization: Bearer dm_k_your_api_key_here

Быстрый старт

Создайте видео за три шага: запустите задание, проверяйте его завершение и получите результат.

curl -X POST https://api.deepmanim.com/api/v1/generate \
  -H "Authorization: Bearer dm_k_your_key" \
  -H "Content-Type: application/json" \
  -d '{"message": "Объясни, как работает фотосинтез", "preferred_locale": "ru"}'

curl https://api.deepmanim.com/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer dm_k_your_key"

# Ответ содержит:
#   status: "pending" | "running" | "completed" | "failed"
#   phase: "exploring_ideas" | "brainstorming" | "crafting_vision" | "refining_details" | "assembling_pieces" | "polishing" | "adding_voice" | "iterating" | "done"
#   estimated_time_remaining_seconds: 285

# Когда status равен "completed", ответ содержит:
{
  "job_id": "...",
  "status": "completed",
  "phase": "done",
  "estimated_time_remaining_seconds": 0,
  "result": {
    "video_url": "https://...",
    "description": "Анимация, объясняющая фотосинтез…",
    "session_id": "...",
    "message_id": "...",
    "duration_seconds": 24.6,
    "has_audio": true,
    "follow_up": "Как клеточное дыхание связано с фотосинтезом?"
  }
}

Конечные точки

Кредиты и цены

Каждый вызов API, создающий задание, списывает кредиты с вашего баланса:

Стоимость генерации и улучшения зависит от выбранной предустановки и сейчас составляет от 1,5 до 70 кредитов. Чтение сессий, сообщений, статусов заданий и данных аккаунта бесплатно и кредиты не списывает.

Ответы с ошибками

DeepManim API v1 — Остались вопросы? Напишите нам: support@deepmanim.com