MCP Dokümantasyonu

Fotovido MCP (Model Context Protocol) sunucusu; model arama, jeton maliyeti tahmini ve üretim başlatma araçlarını MCP destekleyen yapay zekâ asistanlarına ve geliştirici araçlarına açar.

Kimlik doğrulama

Fotovido hesabınıza giriş yapın.
Ayarlar → Geliştirici bölümünden bir API anahtarı oluşturun; anahtara yalnız ihtiyaç duyduğunuz kapsamları (scope) verin.
Her isteğe anahtarı x-api-key başlığıyla ekleyin.

API anahtarınızı gizli tutun: istemci tarafı koda ya da herkese açık depolara koymayın. Sızdığını düşünürseniz ayarlardan iptal edin.

API anahtarı oluştur →

Uç nokta

Streamable HTTP taşıması, JSON-RPC 2.0; oturumsuz çalışır — her istek bağımsızdır ve POST ile gönderilir.

https://fotovido.com/api/mcp

İstemci yapılandırması

Uzak (HTTP) MCP sunucusu ve özel başlık destekleyen istemcinizin yapılandırmasına ekleyin; yer tutucunun yerine kendi anahtarınızı yazın.

{
  "mcpServers": {
    "fotovido": {
      "url": "https://fotovido.com/api/mcp",
      "headers": {
        "x-api-key": "API_ANAHTARINIZ"
      }
    }
  }
}

Bağlantıyı deneyin

Aşağıdaki çağrı kullanılabilir araçları listeler; jeton düşmez.

curl -X POST https://fotovido.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-api-key: API_ANAHTARINIZ" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Araçlar

Aşağıdaki araçlar şu anda açıktır. Her araç, API anahtarınızda ilgili kapsamın (scope) bulunmasını gerektirir.

Model keşfi

search_models
Doğal dille model arar; kategoriye ve en yüksek jeton fiyatına göre süzer.
Gerekli kapsam: models:read
get_model_info
Bir modelin ayrıntılı bilgisini getirir.
Gerekli kapsam: models:read
compare_models
2–5 modeli jeton fiyatı, hız ve kalite açısından yan yana karşılaştırır.
Gerekli kapsam: models:read
get_cheapest_model
Bir kategoride en az jetonlu aktif modelleri listeler.
Gerekli kapsam: models:read

Fiyat ve maliyet

estimate_cost
Bir model ve parametreler için jeton maliyetini hesaplar; create_generation ile aynı parametreleri verdiğinizde dönen değer o çağrıda düşülecek jetondur.
Gerekli kapsam: models:read
cost_optimizer
Kullandığınız modele aynı kategoride daha az jetonlu alternatifler önerir.
Gerekli kapsam: models:read
get_market_overview
Aktif modellerin kategori bazında jeton fiyat özeti.
Gerekli kapsam: models:read
get_price_history
Bir modelin güncel jeton fiyatı ve fiyat değişim geçmişi.
Gerekli kapsam: models:read

Üretim

create_generation
Belirli bir modelle üretim başlatır ve iş kimliği döner; sonucu check_generation_status ile izleyin.
Gerekli kapsam: jobs:create
create_smart_generation
İsteğinize ve bütçenize göre modeli otomatik seçerek üretim başlatır.
Gerekli kapsam: jobs:create
batch_generation
Tek çağrıda birden çok üretim başlatır (ör. aynı istemle farklı modeller).
Gerekli kapsam: jobs:create
check_generation_status
Bir üretim işinin güncel durumunu sorgular.
Gerekli kapsam: jobs:read
get_generation_result
Tamamlanmış bir işin sonucunu (URL ve ayrıntılar) getirir.
Gerekli kapsam: jobs:read
cancel_generation
Kuyrukta ya da beklemede olan bir işi iptal eder.
Gerekli kapsam: jobs:cancel

Hesap ve yardım

get_balance
Hesabınızın jeton bakiyesini gösterir.
Gerekli kapsam: billing:read
ask_fotovido
Modeller, jeton fiyatları ve kullanım hakkında soru-cevap.
Gerekli kapsam: models:read

Ücretlendirme

Üretim araçları, üretimin jeton (⚡) maliyetini bakiyenizden düşer; maliyeti önceden estimate_cost ile görebilirsiniz. Bazı bilgi araçlarının günlük ücretsiz kullanım kotası vardır; kota aşıldığında çağrı başına jeton düşülebilir.

Hata kodları

401 — API anahtarı yok, geçersiz, iptal edilmiş ya da süresi dolmuş.
403 — Anahtarda gerekli kapsam yok, araç kapalı ya da istek izin verilmeyen bir IP adresinden geldi.
503 — Servis bakımda ya da ücretli kullanım geçici olarak kapalı.