Bir OpenCode AI geçidi, terminal iş akışınız ile gerçekten kullanmak istediğiniz modeller arasında sabit bir API katmanı sağlar. Ayrı sağlayıcı anahtarları, ayrı faturalama sayfaları ve ayrı erişilebilirlik riskleriyle uğraşıyorsanız, bu ekstra katman OpenCode'u günlük olarak çalıştırmayı çok daha kolay hale getirebilir.
ShareAI bu rolü iyi bir şekilde yerine getirir çünkü size 150+ model için tek bir API, akıllı yönlendirme, failover ve pazar görünürlüğü sunar. OpenCode zaten özel OpenAI uyumlu sağlayıcıları destekler, bu nedenle kurulum çoğunlukla OpenCode'u doğru temel URL'ye yönlendirmek ve kullanmak istediğiniz modeli eklemekle ilgilidir.
Bu rehber bizim Geliştiriciler AI yönlendirme, model erişimi ve üretime hazır entegrasyonlar hakkındaki.
makalelerimizin bir parçasıdır.
İlk etapta neden bir OpenCode AI geçidi kullanmalısınız? baseURL baseURL.
- değerleri ve OpenAI uyumlu uç noktalar için destek gösterir. Bu esneklik güçlüdür, ancak aynı zamanda yalnızca temiz bir kodlama iş akışı istediğinizde her sağlayıcıyı ayrı ayrı yönetmek zorunda kalabileceğiniz anlamına gelir.
- Model satıcısı başına bir anahtar yerine tek bir API anahtarı.
- Birkaç kontrol paneli yerine tek bir faturalama yüzeyi.
- Hızlı düzenlemeler, uzun bağlam görevleri veya daha ağır yeniden yapılandırmalar için modeller arasında daha temiz geçiş.
Bir sağlayıcı yavaş, erişilemez veya iş için artık en uygun olmadığında yardımcı olabilecek bir yönlendirme katmanı.
Ayrı sağlayıcı altyapısını sürdürmeden esneklik isteyen geliştiriciler için, genellikle bir AI geçidinin kendini amorti etmeye başladığı nokta burasıdır.
OpenCode'un bu kurulumu nasıl desteklediği OpenCode sağlayıcı dokümantasyonu, sağlayıcı ayarlarını özelleştirebilirsiniz opencode.json, özel bir ayar belirleyin baseURL, ve kullanın @ai-sdk/openai-compatible OpenAI-uyumlu sağlayıcılar için. Genel OpenCode GitHub deposu ayrıca yapılandırma yollarını belgeler ve aracın sağlayıcı düzeyinde esneklik için tasarlandığını doğrular.
Bu, başlamak için özel bir ShareAI entegrasyon paketine ihtiyacınız olmadığı anlamına gelir. ShareAI'yi özel bir sağlayıcı olarak ekleyebilir, API anahtarınızı bir ortam değişkeninde tutabilir ve ardından OpenCode'un çağırmasını istediğiniz modeli seçebilirsiniz.
Adım 1: ShareAI API anahtarınızı oluşturun ve bir model seçin
Kimlik bilgilerini oluşturmakla başlayın Bir API Anahtarı oluşturun. Ardından ShareAI model pazarından göz atarak OpenCode iş akışınızı destekleyecek modeli seçin.
Pratik bir yöntem, günlük kodlama görevleri için bir varsayılan model seçmek ve daha düşük gecikme süresi, daha düşük maliyet veya daha güçlü bir akıl yürütme modeli istediğiniz durumlar için bir veya iki alternatif düşünmektir.
Adım 2: ShareAI'yi opencode.json dosyasına özel bir sağlayıcı olarak ekleyin
OpenCode, OpenAI uyumlu bir uç nokta ile özel bir sağlayıcı tanımlamanıza olanak tanır. Basit bir başlangıç şablonu şu şekilde görünür:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"shareai": {
"npm": "@ai-sdk/openai-compatible",
"name": "ShareAI",
"options": {
"baseURL": "https://api.shareai.now/v1",
"apiKey": "{env:SHAREAI_API_KEY}"
},
"models": {
"your-shareai-model": {
"name": "Choose a ShareAI model"
}
}
}
}
}Değiştir your-shareai-model ShareAI model kataloğundan kullanmak istediğiniz tam model tanımlayıcısı ile. API anahtarını dosyanın kendisinden uzak tutun ve bunun yerine bir ortam değişkeni aracılığıyla yükleyin.
export SHAREAI_API_KEY="your_api_key_here"
opencodeDaha geniş istek formatı ve kimlik doğrulama ayrıntılarını istiyorsanız, API Referansı temel ShareAI API akışını kapsar.
Adım 3: Kurulumunuzu yeniden oluşturmadan modelleri değiştirin
ShareAI sağlayıcı katmanı olduğunda, model değişiklikleri çok daha hafif hale gelir. Farklı bir modeli test etmek istediğinizde her seferinde satıcı kimlik doğrulamasını yeniden düzenlemek zorunda kalmazsınız. Bunun yerine, aynı API yüzeyini korur ve OpenCode'u yönlendirdiğiniz modeli değiştirirsiniz.
Bu, kodlama iş akışınız göreve göre değiştiğinde özellikle kullanışlıdır. Hızlı düzenlemeler için bir model, daha büyük depo mantığı için başka bir model ve maliyet veya gecikme süresi en yüksek kapasiteden daha önemli olduğunda üçüncü bir model isteyebilirsiniz. Seçenekleri karşılaştırabilirsiniz model pazarı değil ve davranışı kontrol edebilirsiniz Playground'da varsayılanı kilitlemeden önce.
Doğrudan sağlayıcı anahtarlarının hala mantıklı olduğu durumlar
Doğrudan gitmenin makul olduğu durumlar hâlâ vardır. Sağlayıcıya özgü bir beta özelliğine, özel bir kurumsal anlaşmaya veya sağlayıcı içi katı bir yönetim kurulumuna bağlıysanız, bu yolu ayrı tutmak isteyebilirsiniz.
Ancak OpenCode'un esnek, taşınabilir ve daha kolay çalıştırılabilir kalmasını isteyen ekipler için, bir OpenCode AI geçidi kullanmak genellikle daha temiz bir varsayılan seçenektir. Hesap karmaşasını azaltır ve hangi satıcı girişini en son yapılandırdığınıza göre değil, performans ve uyuma göre modelleri değerlendirmenize olanak tanır.
Son çıkarım
Bir OpenCode AI geçidi, sırf araç eklemek için değil, tek bir kodlama iş akışını korurken modelleri değiştirme, sağlayıcıları karşılaştırma ve temel model ortamı değiştiğinde ilerlemeye devam etme alanı sağlamak içindir. OpenCode'dan bunu istiyorsanız, ShareAI bunu tek bir API aracılığıyla yapmanız için pratik bir yol sunar.