API-documentatie

Openbare DeepManim API v1

Aan de slag

Met de DeepManim API genereer je programmatisch educatieve animatievideo's. Maak video's vanuit tekstprompts, verbeter ze stap voor stap en voeg voice-over toe — allemaal via een eenvoudige REST API.

Basis-URL: https://api.deepmanim.com/api/v1

Belangrijke opmerkingen

  • Audio tijdens het genereren: Wanneer je via /generate een nieuwe video maakt, wordt standaard audio-voice-over toegevoegd.
  • Geen audio bij wijzigingen: Wanneer je via /improve een video verbetert, bevat het resultaat geen audio. Rond eerst alle wijzigingen af en voeg daarna via /audio audio toe.
  • Geschatte tijd: Een video genereren duurt ongeveer 6 minuten. Het veld estimated_time_remaining_seconds in het antwoord op de taak geeft een live aftelling.

Authenticatie

Voor elke API-aanvraag is een API-sleutel nodig. Maak er een aan via Instellingen → API-sleutels in de app.

Een credit-aankoop is vereist. API-toegang is beschikbaar voor gebruikers die minstens één keer credits hebben gekocht. Alleen credits uit de gratis laag zijn niet voldoende.

Neem je sleutel op in de Authorization-header:

Authorization: Bearer dm_k_your_api_key_here

Houd je API-sleutel geheim. Deel hem niet in openbare repositories of client-side applicaties.

Snel starten

Genereer een video in drie stappen: maak een taak, vraag de status op tot hij klaar is en haal daarna het resultaat op.

1. Genereer een video

curl -X POST https://api.deepmanim.com/api/v1/generate \
  -H "Authorization: Bearer dm_k_your_key" \
  -H "Content-Type: application/json" \
  -d '{"message": "Leg uit hoe neurale netwerken leren", "preferred_locale": "nl"}'

2. Vraag voltooiing op

curl https://api.deepmanim.com/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer dm_k_your_key"

# In de reactie staat:
#   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. Haal het resultaat op

# Als de taak klaar is:
{
  "job_id": "...",
  "status": "completed",
  "phase": "done",
  "estimated_time_remaining_seconds": 0,
  "result": {
    "video_url": "https://...",
    "description": "Een animatie die fotosynthese uitlegt...",
    "session_id": "...",
    "message_id": "...",
    "duration_seconds": 24.6,
    "has_audio": true,
    "follow_up": "Welke rol speelt cellulaire ademhaling bij fotosynthese?"
  }
}

Endpoints

Videogeneratie

Taken

Sessies

Berichten

Account

Credits en prijzen

Elke API-aanvraag die een taak maakt, trekt credits van je saldo af:

BewerkingKosten
Video genererenVanaf 1,5 credits
Video verbeterenVanaf 1,5 credits
Audio toevoegen1 credit
Voice-over verbeteren1 credit

De kosten voor genereren en verbeteren hangen af van de gekozen voorinstelling en liggen momenteel tussen 1,5 en 70 credits. Sessies, berichten, taakstatus en accountinformatie lezen is gratis en kost geen credits.

Foutmeldingen

StatusBetekenis
401Ontbrekende of ongeldige API-sleutel
402Onvoldoende credits
404Bron niet gevonden (sessie, bericht of taak)
400Ongeldige aanvraag (bijv. geen video om te verbeteren of geen voice-over om te verfijnen)
API-documentatie | DeepManim