Pierwsze kroki
API DeepManim pozwala programowo generować edukacyjne filmy animowane. Twórz filmy z promptów tekstowych, ulepszaj je iteracyjnie i dodawaj narrację — wszystko za pomocą prostego interfejsu REST.
Podstawowy adres URL: https://api.deepmanim.com/api/v1
Ważne uwagi
- Dźwięk podczas generowania: Podczas generowania nowego filmu przez /generate narracja dźwiękowa jest domyślnie dołączona.
- Brak dźwięku przy modyfikacjach: Film ulepszony przez /improve nie zawiera dźwięku. Najpierw zakończ wszystkie modyfikacje, a następnie dodaj dźwięk przez /audio, gdy film będzie gotowy.
- Szacowany czas: Generowanie filmu trwa około 6 minut. Pole estimated_time_remaining_seconds w odpowiedzi zadania pokazuje aktualne odliczanie.
Uwierzytelnianie
Każde żądanie API wymaga klucza API. Utwórz go w aplikacji w sekcji Ustawienia → Klucze API.
Wymagany jest zakup kredytów. Dostęp do API mają użytkownicy, którzy przynajmniej raz kupili kredyty. Same kredyty z bezpłatnego planu nie wystarczą.
Umieść klucz w nagłówku Authorization:
Authorization: Bearer dm_k_your_api_key_here
Chroń swój klucz API. Nie udostępniaj go w publicznych repozytoriach ani aplikacjach po stronie klienta.
Szybki start
Wygeneruj film w trzech krokach: utwórz zadanie, sprawdzaj jego ukończenie, a potem pobierz wynik.
1. Wygeneruj film
curl -X POST https://api.deepmanim.com/api/v1/generate \
-H "Authorization: Bearer dm_k_your_key" \
-H "Content-Type: application/json" \
-d '{"message": "Wyjaśnij, jak działa fotosynteza", "preferred_locale": "pl"}'2. Sprawdzaj ukończenie
curl https://api.deepmanim.com/api/v1/jobs/JOB_ID \ -H "Authorization: Bearer dm_k_your_key" # Odpowiedź zawiera: # 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. Pobierz wynik
# Gdy status ma wartość "completed", odpowiedź zawiera:
{
"job_id": "...",
"status": "completed",
"phase": "done",
"estimated_time_remaining_seconds": 0,
"result": {
"video_url": "https://...",
"description": "Animacja wyjaśniająca fotosyntezę...",
"session_id": "...",
"message_id": "...",
"duration_seconds": 24.6,
"has_audio": true,
"follow_up": "Jak oddychanie komórkowe wiąże się z fotosyntezą?"
}
}Punkty końcowe
Generowanie wideo
Zadania
Sesje
Wiadomości
Konto
Kredyty i ceny
Każde wywołanie API tworzące zadanie odejmuje kredyty z Twojego salda:
| Operacja | Koszt |
|---|---|
| Generowanie filmu | Od 1,5 kredytu |
| Ulepszanie filmu | Od 1,5 kredytu |
| Dodanie dźwięku | 1 kredyt |
| Ulepszenie narracji | 1 kredyt |
Koszt generowania i ulepszania zależy od wybranego presetu i obecnie wynosi od 1,5 do 70 kredytów. Odczytywanie sesji, wiadomości, stanu zadań i informacji o koncie jest bezpłatne i nie zużywa kredytów.
Komunikaty błędów
| Status | Znaczenie |
|---|---|
| 401 | Brak klucza API lub nieprawidłowy klucz |
| 402 | Niewystarczająca liczba kredytów |
| 404 | Nie znaleziono zasobu (sesji, wiadomości lub zadania) |
| 400 | Nieprawidłowe żądanie (np. brak filmu do ulepszenia lub narracji do poprawy) |