Documentazione API

Per iniziare

L’API DeepManim ti permette di generare video educativi animati tramite codice. Crea video da prompt testuali, migliorali in modo iterativo e aggiungi la narrazione, tutto attraverso una semplice API REST.

• Audio durante la generazioneQuando generi un nuovo video tramite /generate, la narrazione audio è inclusa per impostazione predefinita.
• Nessun audio nelle modificheQuando migliori un video tramite /improve, il risultato non include l’audio. Completa prima tutte le modifiche, poi aggiungi l’audio tramite /audio quando il video ti soddisfa.
• Tempi stimatiLa generazione del video richiede circa 6 minuti. Il campo estimated_time_remaining_seconds nella risposta del job mostra un conto alla rovescia in tempo reale.

Autenticazione

Tutte le richieste API richiedono una chiave API. Creane una in Impostazioni → Chiavi API nell’app. Includi la chiave nell’header Authorization:

Authorization: Bearer dm_k_your_api_key_here

Avvio rapido

Genera un video in tre passaggi: crea un job, controlla il completamento e recupera il risultato.

curl -X POST https://api.deepmanim.com/api/v1/generate \
  -H "Authorization: Bearer dm_k_your_key" \
  -H "Content-Type: application/json" \
  -d '{"message": "Spiega come funziona la fotosintesi", "preferred_locale": "it"}'

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

# La risposta include:
#   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

# Quando lo stato è "completed", la risposta include:
{
  "job_id": "...",
  "status": "completed",
  "phase": "done",
  "estimated_time_remaining_seconds": 0,
  "result": {
    "video_url": "https://...",
    "description": "Un’animazione che spiega la fotosintesi...",
    "session_id": "...",
    "message_id": "...",
    "duration_seconds": 24.6,
    "has_audio": true,
    "follow_up": "Qual è il rapporto tra respirazione cellulare e fotosintesi?"
  }
}

Endpoint

Crediti e prezzi

Ogni chiamata API che crea un job detrae crediti dal tuo saldo:

Il costo della generazione e del miglioramento dipende dal preset scelto e attualmente varia da 1,5 a 70 crediti. La lettura di sessioni, messaggi, stati dei job e informazioni dell’account è gratuita e non consuma crediti.

Risposte di errore

API DeepManim v1 — Domande? Scrivi a support@deepmanim.com