API-Dokumentation

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.

• Audio bei der ErstellungWenn Sie über /generate ein neues Video erstellen, ist die Audio-Narration standardmäßig enthalten.
• Kein Audio bei ÄnderungenEine ü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 DauerDie 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. Fügen Sie Ihren Schlüssel in den Authorization-Header ein:

Authorization: Bearer dm_k_your_api_key_here

Schnellstart

Erstellen Sie ein Video in drei Schritten: Job anlegen, Abschluss abfragen und Ergebnis abrufen.

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"}'

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

# 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

Credits und Preise

Jeder API-Aufruf, der einen Job erstellt, zieht Credits von Ihrem Guthaben ab:

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

DeepManim-API v1 — Fragen? Schreiben Sie an support@deepmanim.com