İçeriğe geç
Bozok
EnglishGirişÜcretsiz başla

Geliştiriciler

Bozok'un üretim döngüsünü kendi kodundan ya da yapay zekâ asistanından yürüt. Bir REST API'si ve uzak bir MCP sunucusu var; ikisi de aynı API anahtarıyla çalışır.

API anahtarı oluştur

Bozok'a gir, Ayarlar > API anahtarları sayfasını aç ve yeni bir anahtar oluştur. Anahtar yalnız bir kez gösterilir, güvenli bir yere kopyala. Anahtar, onu oluşturan kişi gibi çalışma alanında işlem yapar ve seçtiğin izinlerin dışına çıkamaz.

API anahtarları sayfasını aç

İzinler

Her anahtar bir ya da birkaç izin taşır. Okuma her anahtarda bulunur.

  • Okuma

    Üretimleri, çıktıları, kanalları ve takvimi görür. Kredi harcamaz. Her anahtarda bulunur.

  • Düzenleme

    Takvimi, kanal profilini ve asistan konuşmalarını düzenler. Kredi harcamaz.

  • Harcama

    Üretim başlatır, onay kapılarını geçirir ve kredi harcar. Yalnız sahip ve yönetici verebilir.

  • Yayın

    Videoyu yayına onaylar. Yalnız sahip ve yönetici verebilir.

REST API

Taban adres: https://bozok.org/api/v1

Her istekte anahtarı Authorization başlığında gönder:

curl https://bozok.org/api/v1/me \
  -H "Authorization: Bearer bzk_..."

Tüm uç noktalar OpenAPI 3.1 belgesinde: /api/v1/openapi.json

Sınırlar: anahtar başına dakikada 120 istek ve saatte 10 üretim başlatma. Video, altyazı ve kapak indirmeleri ayrı sayılır: dakikada 600 istek. Sınır aşılırsa 429 ve Retry-After başlığı döner.

MCP sunucusu

Sunucu adresi: https://bozok.org/api/mcp

Akıtılabilir HTTP (Streamable HTTP) taşıması, oturumsuz: her istek kendi anahtarını taşır. Yalnız Authorization: Bearer başlığı kabul edilir, çerez oturumları kabul edilmez. Her araç, aynı işi yapan REST uç noktasıyla aynı izinleri ve aynı sınırları kullanır.

Araçlar ve gereken izin

Kredi harcayan araçlar bunu açıklamalarında söyler. Asistanından, bir üretim başlatmadan önce estimate_run ile maliyeti göstermesini iste. Yayına alma (approve_package_and_publish) ayrıca confirm: true ister.

  • Okuma

    • whoami
    • list_channels
    • get_channel
    • list_formats
    • list_playbooks
    • estimate_run
    • list_runs
    • get_run
    • get_run_outputs
    • list_calendar
    • list_trends
    • get_usage

  • Düzenleme

    • update_channel_profile
    • cancel_run
    • preview_package
    • move_calendar_item

  • Harcama

    • create_run
    • approve_gate
    • resume_run
    • create_version
    • ask_producer
    • launch_proposal
    • refresh_trends

  • Yayın

    • approve_package_and_publish

Bağlan

bzk_... yerine kendi anahtarını yaz. Anahtarı herkese açık bir depoya koyma.

Claude Code

claude mcp add --transport http bozok https://bozok.org/api/mcp --header "Authorization: Bearer bzk_..."

Claude Desktop

Claude Desktop yapılandırma dosyasında yerel komut çalıştırır. Uzak sunucuya Authorization başlığı eklemek için mcp-remote köprüsünü kullan; Node.js gerekir.

{
  "mcpServers": {
    "bozok": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://bozok.org/api/mcp",
        "--header",
        "Authorization:${BOZOK_AUTHORIZATION}"
      ],
      "env": {
        "BOZOK_AUTHORIZATION": "Bearer bzk_..."
      }
    }
  }
}

Cursor

Cursor'da bu içerik mcp.json dosyasına girer.

{
  "mcpServers": {
    "bozok": {
      "url": "https://bozok.org/api/mcp",
      "headers": {
        "Authorization": "Bearer bzk_..."
      }
    }
  }
}

Tek tıkla bağlayıcılar

Claude.ai web ve ChatGPT'deki tek tıkla (OAuth) bağlayıcılar henüz desteklenmiyor. Şimdilik yalnız API anahtarıyla bağlanılır.

Ücretsiz başla