İstemciler/Magpie

Magpie ile Wokey API kullanımı

Bir Wokey API anahtarı alın, Magpie için base URL olarak Wokey’yi girin ve bağlantıyı tek bir curl isteğiyle doğrulayın.

Güncellendi

Bu sayfadaexpand_more

API anahtarını ve base URL’yi hazırlayınlink

Tüm istemciler aynı Wokey API anahtarını ve aynı base URL’yi kullanır.

API anahtarı oluşturun

Giriş yapın ve API sayfasında bir platform anahtarı oluşturun. Aynı hesaptaki anahtarlar hesabın bakiyesini paylaşır.

API anahtarı oluşturkey

Wokey base URL’sini kullanın

İstemcinin base URL’si olarak gateway alan adını girin; /v1 eklenip eklenmeyeceğini aşağıdaki yapılandırma gösterir.

İstemciyi yapılandırınlink

Magpie, bilgisayarınızda çalışan bir model gateway’idir. Wokey sağlayıcı olarak eklendikten sonra bilgisayardaki her agent, Wokey modellerini onun üzerinden çağırabilir. Magpie her API formatı için bir adres saklar ve tek bir komut üçünü de ayarlar.

  1. 1

    Sağlayıcıyı ekleyin

    Aşağıdaki magpie provider add komutunu, YOUR_API_KEY yerine Wokey API anahtarınızı yazarak çalıştırın. url ve responses https://api.wokey.ai/v1 değerini, anthropic ise /v1 olmadan https://api.wokey.ai değerini alır. models argümanı verilmezse Magpie model listesini Wokey’den okur.

  2. 2

    Ya da içe aktarma bağlantısı kullanın

    Magpie 0.1.8 veya sonrasında https://usemagpie.ai/import#name=Wokey&chat=https://api.wokey.ai/v1&anthropic=https://api.wokey.ai adresini açın, iletişim kutusuna API anahtarınızı yapıştırın ve onaylayın.

  3. 3

    Agent’ınızda bir model seçin

    Modeli wokey/model-id biçiminde yazın, örneğin wokey/claude-opus-5-5.

Magpie
magpie provider add "Wokey" \
  url=https://api.wokey.ai/v1 \
  responses=https://api.wokey.ai/v1 \
  anthropic=https://api.wokey.ai \
  key=YOUR_API_KEY

API formatları ve base URL’lerlink

Bir istemci API formatını değiştirdiğinde base URL’nin /v1 ile bitip bitmeyeceği değişebilir.

FormatBase URLKullanım alanı
OpenAI Chat Completionshttps://api.wokey.ai/v1DeepSeek, GLM, Kimi ve diğer modeller
OpenAI Responseshttps://api.wokey.ai/v1GPT modelleri
Anthropic Messageshttps://api.wokey.aiClaude modelleri

Yapılandırıldığı yer: magpie provider add veya içe aktarma bağlantısı (~/.config/magpie/providers.json dosyası)

curl ile doğrulayınlink

İstemci hata verirse önce curl ile anahtar ve base URL sorunlarını eleyin.

Magpie varsayılan olarak OpenAI Chat Completions formatını kullanır. Bu istek 200 dönüyorsa anahtar ve base URL doğrudur. Göndermeden önce YOUR_API_KEY yerine kendi anahtarınızı yazın.

cURL
curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-sol",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

Hatalar ve sorun gidermelink

Önce kimlik doğrulama, bakiye, hız limiti, model kullanılabilirliği ve upstream zaman aşımı durumlarını ayırın.

401

invalid api key

Anahtar eksik, yanlış yazılmış veya silinmiş ya da Authorization ile x-api-key başlıkları çelişiyor.

402

insufficient balance

Hesap bakiyesi yetersiz. Daha fazla istek göndermeden önce bakiye yükleyin.

403

model_denylisted / account_restricted

Modele veya hesaptaki tüm modellere yapılan çağrılar, tekrarlanan ihlallerin ardından duraklatıldı. Bkz. “İhlal işlem ücretleri ve kısıtlamalar”.

403

request_blocked

Bu istek upstream’e ulaşmadan engellendi ve ücretlendirilmez; örneğin modelin az önce reddettiği bir isteğin değiştirilmeden yeniden gönderilmesi veya duraklatılmış bir son kullanıcı (X-End-User-Id). Hata mesajı neyin engellendiğini belirtir; isteği buna göre değiştirin veya daha sonra yeniden deneyin. Diğer istekler etkilenmez.

429

rate limited

İstekler çok sık. Daha sonra yeniden deneyin veya eşzamanlılığı azaltın. Yalnızca tek bir model ya da tek bir son kullanıcı (X-End-User-Id) sürekli 429 döndürüyorsa bu, ihlallerden sonra uygulanan geçici bir limit olabilir.

499

client disconnected

İstemci, yanıt tamamlanmadan bağlantıyı kapattı (kod downstream_aborted). Bu varsayılan olarak ücretsizdir. Bir hesabın son 24 saatte en az 50 istemci kopması olur ve bunlar isteklerinin %10’unu veya daha fazlasını oluşturursa, sonraki kopan istekler upstream’in bildirdiği kullanım üzerinden faturalandırılır: önbellek okuma ve yazma dahil işlenen girdi ve yalnızca upstream saydıysa çıktı. Upstream herhangi bir kullanım bildirmeden önceki kopma ücretsiz kalır. Faturalandırma başladığında hesaba bildirim gönderilir ve kopma oranı normale döndükten sonra bir saat içinde faturalandırma otomatik olarak durur. Olağan neden, çok kısa bir istemci veya proxy zaman aşımı ya da istekleri tamamlanmadan iptal eden bir programdır.

502

upstream unavailable

Upstream model hizmeti geçici olarak kullanılamıyor. Model değiştirin veya daha sonra yeniden deneyin.

504

upstream timeout

Upstream yanıtı zaman aşımına uğradı. Bağlamı kısaltın, max_tokens değerini düşürün veya yeniden deneyin.

529

upstream overloaded

Upstream model geçici olarak aşırı yüklü ve Wokey başka rotalarda zaten yeniden denedi (kod upstream_overloaded). Bunun bakiyenizle ilgisi yoktur. Kısa süre sonra yeniden deneyin veya model değiştirin.

Sık sorulan sorularlink

Magpie'deki Wokey adresi /v1 ile bitmeli mi?
Magpie her format için ayrı bir adres saklar. chat ve responses için https://api.wokey.ai/v1, anthropic için /v1 olmadan https://api.wokey.ai kullanın. Adres https olmalıdır.
İçe aktarma bağlantısı hiçbir şey yapmıyorsa ne yapmalıyım?
İçe aktarma bağlantıları Magpie 0.1.8 veya sonrasını gerektirir. Önce güncelleyin ya da sağlayıcıyı magpie provider add komutuyla ekleyin.
Bir agent içinde model adını nasıl yazarım?
Sağlayıcı kimliği/model adı biçiminde. Wokey adlı bir sağlayıcı wokey kimliğini alır; dolayısıyla Claude Opus 5.5, wokey/claude-opus-5-5 olarak yazılır.
Wokey API anahtarını nereye girerim?
Anahtarı içe aktarma penceresine yapıştırın veya magpie provider add komutuna key= olarak verin. Magpie anahtarı ~/.config/magpie/providers.json dosyasında saklar.
Anahtarımı içeren bir içe aktarma bağlantısını paylaşabilir miyim?
Paylaşmayın. key parametresi düz metindir; bağlantıya sahip olan herkes bakiyenizi harcayabilir. Paylaşmadan önce key parametresini kaldırın; karşı taraf içe aktarma penceresine kendi anahtarını girer.