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.
URL di base: https://api.deepmanim.com/api/v1
Note importanti
- Audio durante la generazione: Quando generi un nuovo video tramite /generate, la narrazione audio è inclusa per impostazione predefinita.
- Nessun audio nelle modifiche: Quando 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 stimati: La 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.
È necessario acquistare crediti. L’accesso API è disponibile per gli utenti che hanno acquistato crediti almeno una volta. I soli crediti del piano gratuito non sono sufficienti.
Includi la chiave nell’header Authorization:
Authorization: Bearer dm_k_your_api_key_here
Tieni segreta la chiave API. Non condividerla in repository pubblici o applicazioni lato client.
Avvio rapido
Genera un video in tre passaggi: crea un job, controlla il completamento e recupera il risultato.
1. Genera un 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": "Spiega come funziona la fotosintesi", "preferred_locale": "it"}'2. Controlla il completamento
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
3. Ottieni il risultato
# 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
Generazione video
Job
Sessioni
Messaggi
Account
Crediti e prezzi
Ogni chiamata API che crea un job detrae crediti dal tuo saldo:
| Operazione | Costo |
|---|---|
| Genera video | A partire da 1,5 crediti |
| Migliora video | A partire da 1,5 crediti |
| Aggiungi audio | 1 credito |
| Migliora narrazione | 1 credito |
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
| Stato | Significato |
|---|---|
| 401 | Chiave API mancante o non valida |
| 402 | Crediti insufficienti |
| 404 | Risorsa non trovata (sessione, messaggio o job) |
| 400 | Richiesta non valida (ad esempio nessun video da migliorare o nessuna narrazione da perfezionare) |