Erste Schritte
Mit der DeepManim-API können Sie pädagogische Animationsvideos programmatisch erzeugen. Erstellen Sie Videos aus Text-Prompts, verbessern Sie sie schrittweise und fügen Sie eine Vertonung hinzu – alles über eine einfache REST-API.
Basis-URL: https://api.deepmanim.com/api/v1
Wichtige Hinweise
- Audio bei der Erstellung: Wenn Sie über /generate ein neues Video erstellen, ist die Audio-Narration standardmäßig enthalten.
- Kein Audio bei Änderungen: Eine über /improve verbesserte Version enthält kein Audio. Schließen Sie zuerst alle Änderungen ab und fügen Sie Audio über /audio hinzu, sobald das Video Ihren Vorstellungen entspricht.
- Geschätzte Dauer: Die Videoerstellung dauert ungefähr 6 Minuten. Das Feld estimated_time_remaining_seconds in der Job-Antwort zeigt einen Live-Countdown.
Authentifizierung
Alle API-Anfragen benötigen einen API-Schlüssel. Erstellen Sie ihn in der App unter Einstellungen → API-Schlüssel.
Der Kauf von Credits ist erforderlich. Der API-Zugriff steht Nutzern zur Verfügung, die mindestens einmal Credits gekauft haben. Kostenlose Credits allein reichen nicht aus.
Fügen Sie Ihren Schlüssel in den Authorization-Header ein:
Authorization: Bearer dm_k_your_api_key_here
Halten Sie Ihren API-Schlüssel geheim. Teilen Sie ihn nicht in öffentlichen Repositories oder clientseitigen Anwendungen.
Schnellstart
Erstellen Sie ein Video in drei Schritten: Job anlegen, Abschluss abfragen und Ergebnis abrufen.
1. Video erstellen
curl -X POST https://api.deepmanim.com/api/v1/generate \
-H "Authorization: Bearer dm_k_your_key" \
-H "Content-Type: application/json" \
-d '{"message": "Erkläre, wie Photosynthese funktioniert", "preferred_locale": "de"}'2. Abschluss abfragen
curl https://api.deepmanim.com/api/v1/jobs/JOB_ID \ -H "Authorization: Bearer dm_k_your_key" # Die Antwort enthält: # 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. Ergebnis abrufen
# Wenn der Status "completed" lautet, enthält die Antwort:
{
"job_id": "...",
"status": "completed",
"phase": "done",
"estimated_time_remaining_seconds": 0,
"result": {
"video_url": "https://...",
"description": "Eine Animation zur Erklärung der Photosynthese...",
"session_id": "...",
"message_id": "...",
"duration_seconds": 24.6,
"has_audio": true,
"follow_up": "Wie hängt die Zellatmung mit der Photosynthese zusammen?"
}
}Endpunkte
Videogenerierung
Jobs
Sitzungen
Nachrichten
Konto
Credits und Preise
Jeder API-Aufruf, der einen Job erstellt, zieht Credits von Ihrem Guthaben ab:
| Vorgang | Kosten |
|---|---|
| Video erstellen | Ab 1,5 Credits |
| Video verbessern | Ab 1,5 Credits |
| Audio hinzufügen | 1 Credit |
| Narration verbessern | 1 Credit |
Die Kosten für Erstellen und Verbessern hängen vom ausgewählten Preset ab und liegen derzeit zwischen 1,5 und 70 Credits. Das Lesen von Sitzungen, Nachrichten, Jobstatus und Kontoinformationen ist kostenlos und verbraucht keine Credits.
Fehlerantworten
| Status | Bedeutung |
|---|---|
| 401 | API-Schlüssel fehlt oder ist ungültig |
| 402 | Nicht genügend Credits |
| 404 | Ressource nicht gefunden (Sitzung, Nachricht oder Job) |
| 400 | Ungültige Anfrage (z. B. kein Video zum Verbessern oder keine Narration zum Überarbeiten) |