Başlarken
DeepManim API ile eğitim amaçlı animasyon videolarını programla üretebilirsiniz. Metin istemlerinden videolar oluşturun, yinelemeli olarak iyileştirin ve basit bir REST API üzerinden anlatım ekleyin.
Temel URL: https://api.deepmanim.com/api/v1
Önemli notlar
- Üretimde ses: /generate üzerinden yeni video ürettiğinizde sesli anlatım varsayılan olarak eklenir.
- Değişikliklerde ses yok: /improve üzerinden iyileştirilen videoda ses bulunmaz. Önce tüm değişiklikleri tamamlayın; videodan memnun kaldığınızda /audio üzerinden ses ekleyin.
- Tahmini süreler: Video üretimi yaklaşık 6 dakika sürer. İş yanıtındaki estimated_time_remaining_seconds alanı canlı geri sayım sağlar.
Kimlik doğrulama
Tüm API istekleri bir API anahtarı gerektirir. Uygulamada Ayarlar → API anahtarları bölümünden bir anahtar oluşturun.
Kredi satın alımı gerekir. API erişimi en az bir kez kredi satın almış kullanıcılara açıktır. Yalnızca ücretsiz katman kredileri yeterli değildir.
Anahtarınızı Authorization üst bilgisine ekleyin:
Authorization: Bearer dm_k_your_api_key_here
API anahtarınızı gizli tutun. Anahtarınızı herkese açık depolarda veya istemci tarafı uygulamalarda paylaşmayın.
Hızlı başlangıç
Üç adımda video üretin: bir iş oluşturun, tamamlanana kadar sorgulayın, ardından sonucu alın.
1. Video oluştur
curl -X POST https://api.deepmanim.com/api/v1/generate \
-H "Authorization: Bearer dm_k_your_key" \
-H "Content-Type: application/json" \
-d '{"message": "Fotosentezin nasıl çalıştığını açıkla", "preferred_locale": "tr"}'2. Tamamlanana kadar sorgula
curl https://api.deepmanim.com/api/v1/jobs/JOB_ID \ -H "Authorization: Bearer dm_k_your_key" # Yanıt şunları içerir: # 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. Sonucu al
# status "completed" olduğunda yanıt şunları içerir:
{
"job_id": "...",
"status": "completed",
"phase": "done",
"estimated_time_remaining_seconds": 0,
"result": {
"video_url": "https://...",
"description": "Pisagor teoremini açıklayan bir animasyon...",
"session_id": "...",
"message_id": "...",
"duration_seconds": 24.6,
"has_audio": true,
"follow_up": "Bunun gerçek hayattaki uygulamaları nelerdir?"
}
}Uç noktalar
Video üretimi
İşler
Oturumlar
Mesajlar
Hesap
Krediler ve fiyatlandırma
İş oluşturan her API çağrısı bakiyenizden kredi düşer:
| İşlem | Maliyet |
|---|---|
| Video oluştur | 1,5 krediden başlar |
| Videoyu iyileştir | 1,5 krediden başlar |
| Ses ekle | 1 kredi |
| Anlatımı iyileştir | 1 kredi |
Üretim ve iyileştirme maliyetleri seçilen ön ayara bağlıdır ve şu anda 1,5 ile 70 kredi arasındadır. Oturumları, mesajları, iş durumunu ve hesap bilgilerini okumak ücretsizdir; kredi düşmez.
Hata yanıtları
| Durum | Anlamı |
|---|---|
| 401 | Eksik veya geçersiz API anahtarı |
| 402 | Yetersiz kredi |
| 404 | Kaynak bulunamadı (oturum, mesaj veya iş) |
| 400 | Geçersiz istek (ör. iyileştirilecek video veya düzeltilecek anlatım yok) |