Початок роботи
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": "uk"}'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 | Недійсний запит (наприклад, немає відео для покращення або озвучення для доопрацювання) |