wold.

GELİŞTİRİCİ REHBERİ

OpenAI uyumlu API nasıl kullanılır?

Wold, yapay zeka modellerine OpenAI ve Anthropic uyumlu uç noktalar üzerinden erişmeni sağlayan bir API geçididir. Bu rehber, Console'dan anahtar oluşturarak ilk isteğini göndermeni anlatır.

Yayın ve son güncelleme:

API uyumluluğu ne demek?

Uyumlu API, desteklenen istek ve yanıt biçimlerinin ilgili protokole benzer şekilde çalışmasıdır. Wold'un OpenAI biçimindeki sohbet uç noktası /v1/chat/completions, Anthropic biçimindeki mesaj uç noktası ise /v1/messages adresidir.

Bu, OpenAI veya Anthropic'in bütün özelliklerinin ve modellerinin desteklendiği anlamına gelmez. Model, araç ve istemci sürümüne göre destek değişebilir. Wold bu şirketlerin resmi hizmeti değildir ve kendi temel modelini geliştirmez.

1. Console'dan API anahtarı oluştur

  1. Davet aldıysan Wold Console'a giriş yap ve e-posta doğrulamanı tamamla.
  2. Güncel kullanım şartlarını ve yurt dışına veri aktarımı için ayrı onay ekranını kendin değerlendir. Gerekli onaylar tamamlanmadan API erişimi açılmaz.
  3. API anahtarları bölümünden bir anahtar oluştur. Anahtarı güvenli bir yerde sakla ve kullanım limitini Console'dan kontrol et.

Aşağıdaki örnekler Bash içindir, Linux, macOS veya WSL terminalinde çalıştırılabilir. Yer tutucuları kendi değerlerinle değiştir. Ortam değişkenine anahtar yazarken paylaşılan cihazlarda terminal geçmişine dikkat et.

export WOLD_API_KEY='kendi_api_anahtarin'
export WOLD_BASE_URL='https://api.wold.cloud/v1'

API anahtarını tarayıcıya gönderilen kodda, ekran görüntüsünde veya herkese açık bir depoda paylaşma. Uygulama isteklerini kendi sunucun üzerinden yap. Anahtar açığa çıkarsa Console'dan iptal et.

2. Kullanılabilir modelleri listele

Model kimliklerini tahmin etmek yerine hesabının erişebildiği güncel listeyi API'den al:

curl "$WOLD_BASE_URL/models" \
  -H "Authorization: Bearer $WOLD_API_KEY"

Yanıttaki data listesinden uygun modelin id değerini seç. İlgili protokolün o model için desteklendiğini de kontrol et. Aşağıdaki yer tutucuyu bu kimlikle değiştir:

export WOLD_MODEL='listeden_sectigin_model_id'

3. OpenAI biçiminde sohbet isteği gönder

Mesajları messages dizisinde gönder. Bu örnekte yanıt uzunluğu max_tokens ile sınırlanır:

curl "$WOLD_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $WOLD_API_KEY" \
  -H "Content-Type: application/json" \
  --data "{\"model\":\"$WOLD_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"Merhaba! Kısaca kendini tanıt.\"}],\"max_tokens\":128}"

OpenAI uyumlu bir SDK veya editör kullanıyorsan, özel sağlayıcı ayarlarında temel URL'yi https://api.wold.cloud/v1, anahtarı Wold anahtarın ve modeli listeden seçtiğin kimlik olarak ayarla. Her araç özel temel URL ayarını desteklemez. Cline ve OpenCode için adım adım ayarlar kodlama araçları rehberinde.

4. Anthropic biçiminde mesaj isteği gönder

Anthropic mesaj biçimini destekleyen bir model seçtiğinde x-api-key başlığını ve mesaj uç noktasını kullanabilirsin:

curl "$WOLD_BASE_URL/messages" \
  -H "x-api-key: $WOLD_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  --data "{\"model\":\"$WOLD_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"Merhaba! Kısaca kendini tanıt.\"}],\"max_tokens\":128}"

İki örnek farklı protokol biçimlerini gösterir. Bir modelin bir biçimde listelenmesi, diğer biçimde de çalışacağını garanti etmez.

Hata kontrolü ve sık sorulanlar

İstek neden çalışmıyor?

Betada ücret öder miyim?

Mevcut kapalı beta ücretsizdir ve hesaplara test kullanım limiti tanımlanır. Bu limit ücretli bir paket satın aldığın veya sınırsız erişimin olduğu anlamına gelmez. Güncel hesabına ait kullanım bilgisi Console'dadır.

Gönderdiğim veriler için neyi kontrol etmeliyim?

Wold bir API geçididir, istekler ilgili altyapı ve model sağlayıcılarına iletilebilir. Hassas veri göndermeden önce gizlilik aydınlatmasını, kullanım şartlarını ve kullanacağın modelin güncel veri işleme koşullarını incele.