Начало работы
API DeepManim позволяет программно создавать учебные анимационные видео. Создавайте видео из текстовых запросов, улучшайте их итеративно и добавляйте озвучку — всё через простой REST API.
Базовый URL: https://api.deepmanim.com/api/v1
Важные замечания
- Аудио при генерации: При создании нового видео через /generate озвучка включается по умолчанию.
- При изменениях аудио нет: Результат улучшения видео через /improve не содержит аудио. Сначала завершите все изменения, затем добавьте аудио через /audio, когда видео вас устроит.
- Расчётное время: Генерация видео занимает примерно 6 минут. Поле estimated_time_remaining_seconds в ответе задания показывает текущий обратный отсчёт.
Аутентификация
Для всех запросов API нужен ключ API. Создайте его в приложении: Настройки → Ключи API.
Требуется покупка кредитов. Доступ к API есть у пользователей, которые хотя бы один раз покупали кредиты. Одних кредитов бесплатного уровня недостаточно.
Передайте ключ в заголовке Authorization:
Authorization: Bearer dm_k_your_api_key_here
Храните ключ API в секрете. Не публикуйте его в открытых репозиториях и клиентских приложениях.
Быстрый старт
Создайте видео за три шага: запустите задание, проверяйте его завершение и получите результат.
1. Создать видео
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"}'2. Проверять завершение
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
3. Получить результат
# Когда 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 кредита |
| Улучшить видео | От 1,5 кредита |
| Добавить аудио | 1 кредит |
| Улучшить озвучку | 1 кредит |
Стоимость генерации и улучшения зависит от выбранной предустановки и сейчас составляет от 1,5 до 70 кредитов. Чтение сессий, сообщений, статусов заданий и данных аккаунта бесплатно и кредиты не списывает.
Ответы с ошибками
| Статус | Значение |
|---|---|
| 401 | Ключ API отсутствует или недействителен |
| 402 | Недостаточно кредитов |
| 404 | Ресурс не найден (сессия, сообщение или задание) |
| 400 | Недействительный запрос (например, нет видео для улучшения или озвучки для доработки) |