Zed'e özel bir OpenAI uyumlu sağlayıcı ekleyin.

Hızlı yanıt: settings.json'da tek bir blok.

Zed, özel OpenAI uyumlu sağlayıcıları yerel olarak destekler. settings.json'da language_models.openai_compatible altında bir sağlayıcı girdisi ekleyin, api_url'yi https://api.apisrouter.com/v1 olarak ayarlayın ve istediğiniz her modeli available_models altında adı ve bağlam boyutuyla bildirin. Modeller, agent paneli model açılır menüsünde hemen görünür. API anahtarı kasıtlı olarak settings.json'a gitmez. Zed onu, sağlayıcı ayarları arayüzü üzerinden girdiğinizde sistem anahtar zincirinde saklar veya sağlayıcı anahtarınızdan türetilen bir ortam değişkeninden okur: apisrouter adlı bir sağlayıcı APISROUTER_API_KEY'i okur. Ortam değişkenleri, anahtar zinciri değerlerine göre önceliklidir.

{
  "language_models": {
    "openai_compatible": {
      "apisrouter": {
        "api_url": "https://api.apisrouter.com/v1",
        "available_models": [
          {
            "name": "claude-sonnet-4-6",
            "display_name": "Claude Sonnet 4.6",
            "max_tokens": 200000
          }
        ]
      }
    }
  }
}

Zed özel sağlayıcıları ve modelleri nasıl çözer.

Zed (GitHub'da zed-industries, kabaca 87K yıldız), plan yapan, dosyaları düzenleyen ve araçları çalıştıran bir agent paneli olan yüksek performanslı bir editördür. openai_compatible sağlayıcı türü standart /v1/chat/completions protokolünü konuşur; bu tam olarak çoklu-satıcı bir gateway'in sunduğu şeydir, bu yüzden editör ile endpoint arasında hiçbir eklenti veya uzantı oturmaz. Seçtiğiniz sağlayıcı anahtarı (yukarıda "apisrouter") çift görev yapar. Agent paneli ayarlarında sağlayıcıyı adlandırır ve Zed'in anahtar için kontrol ettiği, büyük-alt-çizgi-biçiminde bir _API_KEY sonekiyle biten ortam değişkenini üretir. Bu adlandırma kuralı, herhangi bir şeyi hata ayıklamadan önce içselleştirmeye değer: sağlayıcıyı yeniden adlandırın ve beklenen değişken adı da onunla değişir. available_models bir izin listesidir. Zed özel bir endpoint'i kendi başına numaralandıramaz, bu yüzden yalnızca bildirdiğiniz id'ler seçilebilir hale gelir, her biri sürüm soneki dahil tam bir dize. api_url'nin arkasındaki endpoint, Claude, GPT, Gemini ve Kimi id'lerini yan yana sunduğunda, tek bir sağlayıcı bloğu, agent paneli seçicisini tek bir anahtarın arkasındaki çapraz-satıcı bir santral haline getirir. Kapsam notu: Zed'in edit predictions özelliği kendi ayrılmış modellerini kullanır ve ayrı olarak yapılandırılır; özel bir sağlayıcı, edit predictions'ı değil agent panelini ve inline asistanı besler.

Tam kurulum: modeller, bağlam boyutları ve yetenekler.

Her available_models girdisi bir addan fazlasını alır. max_tokens modelin bağlam penceresini bildirir ve max_output_tokens üretim uzunluğunu sınırlar; Zed bu rakamları uzun agent iş parçacıklarını yönetmek için kullanır, bu yüzden uzun-bağlamlı bir modeli küçük bir max_tokens ile bildirmek modelin manevra alanını sessizce boşa harcar. capabilities nesnesi Zed'e modelin neyi desteklediğini söyler: agent panelini onunla yönetmeyi planladığınız her şey için tools'u true'ya ayarlayın ve images'ı yalnızca gerçekten görüntü girdisi kabul eden modeller için etkinleştirin. Anahtar için, masaüstü bir editörde güvenilir yol, değeri sistem anahtar zincirinde saklayan sağlayıcı ayarları arayüzüdür. Ortam-değişkeni yolu da çalışır, hata ayıklama bölümünde ele alınan bir uyarıyla: dock'tan başlatılan GUI uygulamaları shell profilinizi devralmaz.

{
  "language_models": {
    "openai_compatible": {
      "apisrouter": {
        "api_url": "https://api.apisrouter.com/v1",
        "available_models": [
          {
            "name": "claude-sonnet-4-6",
            "display_name": "Claude Sonnet 4.6",
            "max_tokens": 200000,
            "max_output_tokens": 64000,
            "capabilities": { "tools": true, "images": false }
          },
          {
            "name": "claude-opus-4-7",
            "display_name": "Claude Opus 4.7",
            "max_tokens": 200000,
            "capabilities": { "tools": true }
          },
          { "name": "gpt-5.5", "display_name": "GPT-5.5", "max_tokens": 200000 },
          { "name": "kimi-k2.7-code", "display_name": "Kimi K2.7 Code", "max_tokens": 200000 }
        ]
      }
    }
  }
}

Agent paneli için model seçmek.

Bildirilen her model aynı seçicide oturduğundan, pratik iş akışı benchmark'lar yerine gerçek iş üzerinde karşılaştırmadır: aynı tür görevi farklı günlerde iki aday üzerinden çalıştırın ve anahtar başına kullanım günlüğünün her birini fiyatlandırmasına izin verin. Zed'de bir model değişikliği bir açılır menü seçimidir, bu yüzden deneyin maliyeti sıfır kurulumdur.

• Agent paneli gerçek mühendislik taşır: dosyaları okumak, çok adımlı düzenlemeleri planlamak, uzun iş parçacıkları üzerinde araçları çalıştırmak. Sınır bir kodlama modeli (claude-sonnet-4-6, claude-opus-4-7, gpt-5.5) bu slota aittir.
• kimi-k2.7-code gibi kodlamaya ayarlı id'ler, varsayılanınız olmasalar bile bildirilmeye değer; bir refactor ağırlıklı oturum için değiştirmek bir yapılandırma düzenlemesi değil, tek bir seçici seçimidir.
• gemini-3.1-pro-preview gibi uzun-bağlamlı modeller, iş parçacıkları rutin olarak büyük dosyaları veya tüm modül bağlamını tek bir konuşmaya çektiğinde yerlerini hak eder.
• Inline assist, agent iş parçacıklarından daha kısa ömürlüdür, bu yüzden hızlı bir orta-katman id, tek satırlık yeniden yazımlarda sınır token'ları yakmadan tek seferlik dönüşümleri hızlı tutar.

Kullandıkça öde · resmi fiyatların altında

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Zed özel sağlayıcılarına özgü hata modları.

Anahtar settings.json'da ama hiçbir şey çalışmıyor. Zed, tasarım gereği API anahtarlarını settings.json'dan okumaz. Anahtarı sağlayıcı ayarları arayüzüne girin veya türetilen ortam değişkenini dışa aktarın; JSON'a yapıştırılmış bir anahtar yok sayılır. Ortam değişkeni ayarlı ama Zed hâlâ anahtar istiyor. Değişken adı, sağlayıcı anahtarından türetilir, büyük-alt-çizgi ve _API_KEY eklenmiş biçimde, bu yüzden apisrouter adlı bir sağlayıcı OPENAI_API_KEY değil APISROUTER_API_KEY ister. Ve macOS'ta, dock'tan başlatılan bir uygulama shell profilinizi asla kaynak almaz, bu yüzden profil export'ları ona görünmez. Zed'i zed komutuyla bir terminalden başlatın veya anahtar zinciri yolunu kullanıp sorunu tamamen atlayın. Seçicide bir model eksik. available_models bir izin listesidir; varsaydığınız ama hiç bildirmediğiniz bir id basitçe yoktur. Id'ler sürüm sonekleri dahil tam dizelerdir ve gateway'in /v1/models listesi kopyalanacak yetkili yazımdır. Agent araçları kullanamıyor. Bir modelin capabilities bloğu tools'u false olarak söylüyorsa, Zed onunla tool kullanımı sunmaz. Yetenekleri modelin gerçekten desteklediğine eşleşecek şekilde bildirin. /v1 olmayan api_url. İstemci, verdiğiniz base'e /chat/completions gibi rota yolları ekler, bu yüzden https://api.apisrouter.com/v1 doğrudur ve çıplak host değildir. Aksi halde doğru bir blokta 404 şeklinde bir başarısızlık neredeyse her zaman budur.

Zed'i bir gateway üzerinden kim yönlendirir.

• Editörde yaşayan ve satıcı başına ayrı sağlayıcı kimlik bilgileri sürdürmek yerine Claude, GPT ve Kimi'yi tek bir agent paneli seçicisinde isteyen geliştiriciler.
• Kodlama modellerini gerçek düzenlemelerde karşılaştıran mühendisler. Her aday tek bir bildirilen girdi ve tek bir açılır menü seçimidir; deney başına yeni hesap yok.
• Tek bir sırrı standartlaştıran ekipler. Onboarding belgelerindeki tek bir APISROUTER_API_KEY, satıcı başına bir anahtar kontrol listesinin yerini alır ve anahtar başına kullanım her koltuğun ne harcadığını gösterir.
• Sınır bir agent modelini, farklı bir satıcıdan hızlı bir inline-assist modeliyle eşleştiren kullanıcılar; bu, tek-satıcı yapılandırmaların ifade edemeyeceği bir şeydir.
• Belirli bir satıcının faturalandırmasına erişimi olmayan geliştiriciler. Kart gerektirmeyen yükleme tabanlı erişim, sağlayıcı başına kayıt bağımlılığını ortadan kaldırır.

Endpoint'i doğrulayın ve ilk iş parçacığını hata ayıklayın.

Bir agent iş parçacığı başlatmadan önce gateway'in sunduklarını listeleyin. /v1/models tarafından döndürülen id'ler, available_models girdilerinizin kullanması gereken tam dizelerdir. İlk iş parçacığı başarısızlıkları tutarlıdır. 401, Zed'in çözdüğü anahtarın yanlış veya eksik olduğu anlamına gelir: sağlayıcı ayarlarındaki anahtar zinciri girdisini kontrol edin veya türetilen ortam değişkeninin yalnızca terminalinize değil Zed sürecine görünür olduğunu doğrulayın. Gateway'den bir model-not-found hatası, bildirilen bir adın sürüm soneki dahil sunulan bir id ile eşleşmediği anlamına gelir. Sağlayıcı bloğu ayarlarda hiç görünmüyorsa, JSON'u doğrulayın; settings.json yorumları tolere eder ama yapısal hataları etmez. İstekler akmaya başladığında, APIsRouter konsolu istek başına modeli, token sayılarını ve harcamayı gösterir. Agent iş parçacıkları uzun-bağlamlı, çok turlu iş yükleridir ve hangi iş parçacıklarının ve hangi modellerin token'ları tükettiğini görmek, varsayılan modelinizin slotunu hak edip etmediğine nasıl karar verdiğinizdir.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

Sık sorulan sorular