Zipir

Zıpır API

Kendi programından belgeden video ders başlat, durumunu izle, indirme bağlantısını al.

Kısa yanıt: Zıpır API, panelin yaptığı işi kendi programına açar: anahtarını Authorization: Bearer başlığında gönderirsin, bir belgeyi ya da metni derse çevirirsin, bitmiş videonun indirme bağlantısını alırsın. Ders, paneldeki aynı hattan geçer: belge okunur, sahne planı çıkarılır ve sen panelde onaylamadan tek kare üretilmez.

Anahtar

Kendi kendine bağla. İletişime geçmene gerek yok: panelde anahtarı oluştur, kodu çalıştır. API videoları, fiyat sayfasındaki plan ve dakika paketleriyle aynı sayaçtan düşer — API için ayrı ücret yok.

1. Panelde Hesap → API anahtarları → Anahtar oluştur.
2. Anahtarı sunucunda ortam değişkeni yap: ZIPIR_API_KEY.
3. İlk isteği gönder; sonuç JSON döner, video hazır olunca indirme bağlantısı verilir.

Panelde Hesap → API anahtarları → Anahtar oluştur. Anahtar zipir_ ile başlar ve yalnız oluşturulduğu an bir kez gösterilir; sunucuda yalnız sha256 özeti saklanır. Her istek şu başlığı taşır:

Authorization: Bearer $ZIPIR_API_KEY

Anahtarı tarayıcıya ya da istemciye gömme; sunucunda ortam değişkeni olarak tut. Bir anahtar silinince aynı saniyede çalışmayı bırakır.

Uçlar

Makine okunur şema: /openapi.json (OpenAPI 3.1). İstemciler ve araç dizinleri uçları bu dosyadan okur.

Taban adres https://api.zipirapp.com. Gövde ve yanıtlar JSON; dosya yüklemesi multipart/form-data. Bugün 19 biçim açık; listeyi GET /v1/formats verir, adları biçimler sayfasında.

Metot	Yol	Ne yapar
GET	/v1/formats	Kullanılabilir biçimler; canlı katalog.
GET	/v1/voices	List narrator voices (call this before create_lesson when the user names a voice, a tone or a gender)
GET	/v1/lessons	List this account's recent lessons (use when someone asks "my videos", "what did I make", or wants to continue an earlier one)
POST	/v1/lessons	Ders başlatır: dosya, metin ya da sayfa bağlantısı. 202 ve ders kimliği.
GET	/v1/lessons/{id}	Durum, aşama, süre, hata; sahne planı onay bekliyor mu.
DELETE	/v1/lessons/{id}	Dersi durdurur ve siler.
POST	/v1/lessons/{id}/approve	Approve the storyboard and start rendering (the only call that spends the account's minutes)
POST	/v1/lessons/{id}/edit	Change one scene of a lesson (rewrite, shorten, retitle or restyle it); no render starts
POST	/v1/lessons/{id}/rerender	Render a finished lesson again (the minutes rule is the approval's own)
GET	/v1/lessons/{id}/plan	Read the questions, the answers in force and the plan of a lesson started with interview=true
POST	/v1/lessons/{id}/answers	Send the answers to the questions and ask for the plan
POST	/v1/lessons/{id}/plan/accept	Accept the plan (or skip the questions with quick) and start the script and storyboard
GET	/v1/lessons/{id}/download	İmzalı indirme bağlantısı (15 dakika geçerli).
GET	/v1/usage	Bu anahtarın dönem dakikaları ve dakikada istek sınırı.

MCP: yapay zekâ asistanına bağla

Zıpır bir MCP sunucusu olarak da çalışır: Claude Desktop, Cursor veya VS Code içinden "belgeden video ders" aracını çağırabilirsin. Kurulum tek komut, anahtarın aynısı ve aynı dakika sayacı.

npx @zipir/mcp

Kendi bilgisayarında çalıştırmak istemiyorsan barındırılan sunucu da hazır: https://api.zipirapp.com/mcp (HTTP, MCP 2025-06-18). Aynı anahtarı Authorization: Bearer zipir_... başlığıyla gönderirsin; araçlar, kota ve dakika sayacı birebir aynıdır.

Claude'da en kısa yol: Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle, adres https://api.zipirapp.com/mcp. Anahtar kopyalamazsın: Zıpır hesabınla giriş yaparsın (OAuth, PKCE S256), dakika ve onay kuralları aynı yerden işler. Adım adım anlatım: Zıpır'ı Claude'a bağla.

Yapılandırma (tek blok, claude_desktop_config.json ya da Cursor ayarları):

{
  "mcpServers": {
    "zipir": {
      "command": "npx",
      "args": ["-y", "@zipir/mcp"],
      "env": { "ZIPIR_API_KEY": "zipir_..." }
    }
  }
}

Araçlar: list_formats, create_lesson, get_lesson, approve_lesson, get_download, get_usage. Paket: @zipir/mcp.

Örnekler

Biçimleri oku:

curl https://api.zipirapp.com/v1/formats \
  -H "Authorization: Bearer $ZIPIR_API_KEY"

Bir PDF'ten ders başlat. Idempotency-Key aynı isteğin tekrarını aynı derse bağlar (24 saat):

curl https://api.zipirapp.com/v1/lessons \
  -H "Authorization: Bearer $ZIPIR_API_KEY" \
  -H "Idempotency-Key: isg-2026-10-31" \
  -F "file=@belge.pdf" \
  -F "format=briefing" \
  -F "title=İSG oryantasyonu"

Metinden ya da herkese açık bir sayfadan:

curl https://api.zipirapp.com/v1/lessons \
  -H "Authorization: Bearer $ZIPIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Fotosentez, bitkilerin ışık enerjisini kimyasal enerjiye çevirdiği süreçtir."}'

curl https://api.zipirapp.com/v1/lessons \
  -H "Authorization: Bearer $ZIPIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://ornek.com.tr/rehber"}'

Durumu izle ve indirme bağlantısını al:

curl https://api.zipirapp.com/v1/lessons/DERS_KIMLIGI \
  -H "Authorization: Bearer $ZIPIR_API_KEY"

curl "https://api.zipirapp.com/v1/lessons/DERS_KIMLIGI/download?variant=720" \
  -H "Authorization: Bearer $ZIPIR_API_KEY"

Kalan dakikalar:

curl https://api.zipirapp.com/v1/usage -H "Authorization: Bearer $ZIPIR_API_KEY"

Kurallar

• Her yanıtta x-request-id var. Hatalar tek biçimde: {"error":{"code","message","request_id"}}. Desteğe yazarken bu kimliği gönder.
• Ders hemen başlamaz. POST /v1/lessons 202 döner; durum queued → rendering → done (ya da failed) ilerler. needs_approval: true iken sahne planı panelde onay bekliyordur; onaylanmadan kare üretilmez.
• Kota 402, hız 429. Anahtarın aylık dakikası ya da hesabın kendi sınırı dolduğunda 402; dakikada istek sınırı dolduğunda 429 ve Retry-After.
• İndirme bir bağlantıdır. 900 saniye geçerlidir. variant=720 her planda açık; variant=1080 Stüdyo ve Takım planlarında.
• Tekrar deneme güvenli. Aynı Idempotency-Key 24 saat içinde aynı dersi döndürür; farklı gövdeyle aynı anahtar 409.
• Belge 50 MB, metin 5 MB. Kişisel veri içeren belgeler için Güven sayfası geçerli: belgen yalnız videon için okunur, model eğitilmez.

Fiyat

API ayrı ücretlendirilmez; panelin planıyla çalışır: Stüdyo ₺990/ay, ayda 15 bitmiş video dakikası; Takım ₺3.490/ay, ayda 60 bitmiş video dakikası. KDV dahil. Ölçü bitmiş video dakikasıdır. Fiyat sayfası.

Örnek çıktı

Aynı hattın ürettiği videoyu Kanıt sayfasında izleyebilirsin: 6331 sayılı Kanun'un 17. maddesinden yapılmış, her cümlesi kaynağındaki satırı gösteren bir ders.

Son güncelleme: 3 Kasım 2026

---

Kaynak: https://zipirapp.com/api/