TypeSafe API rehberi

HTTP değerlendirme uç noktası

İstek gövdesinde üç üst düzey alan bulunur. state zorunludur; metin dizesi, nesne veya metin dizisi olabilir. model zorunludur; doküman örneklerinde jev-latest kullanılır. questions, türü belirlenmiş Question nesnelerinden oluşan bir haritadır. Her anahtarı siz seçersiniz. Eşleşen yanıt aynı kimlikle döner. Anahtar, alttaki modele gönderilmez ve çıkarımda kullanılmaz.

Asgari bir Noul şöyle görünür: {"state": "Yardım edin! Ödemelerim 3 gündür başarısız oluyor.", "model": "jev-latest", "questions": {"is_urgent": {"type": "noul", "instructions": "Bu, aciliyet ifade ediyor mu?"}}}. Choice, seçenek adlarını açıklamalarla eşleyen bir ölçüt haritası ekler. Score ise sıralı bir düzey ölçütleri dizisi ekler. Üçü de type ve instructions alanlarını paylaşır; her biri kendine özgü criteria yapısını ekler.

https://console.typesafe.ai/settings/keys. adresinden bir API anahtarı alın. HTTP'yi doğrudan çağırıyorsanız 429 yanıtını retry-after ile işleyin. Jev 1.13 için hız sınırları saniyede 250,000 token ve dakikada 1,200 istektir; bunlar önceden bildirilmeden değişebilir. SDK'lar varsayılan olarak artan bekleme süreleriyle yeniden dener. Modelleri listelemek için aynı Bearer tokenıyla GET /v1/models isteği gönderilir.

Resmî SDK'lar

Python: pip install typesafe-sdk. typesafe_sdk içinden TypeSafeClient öğesini içe aktarın. İstemci olarak TypeSafeClient() kullanın: client.system_one(state, questions). Noul, Choice ve Score gibi kurucular pakette yer alır; böylece JSON tür alanını elle yazmanız gerekmez. Varsayılan model jev-latest'tür. Python 3.10 veya daha yenisi gerekir.

JavaScript: npm install @typesafe-ai/sdk. "@typesafe-ai/sdk" içinden { TypeSafeClient } öğesini içe aktarın. İstemci aynı uç noktayla iletişim kurar. Çalışma ortamı Node.js 20+ sürümüdür. Depo: https://github.com/typesafe-ai/typesafe-sdk-js. Her iki SDK da takma ad kataloğu için models.list() sunar.

https://console.typesafe.ai/playground adresindeki oyun alanı, herkese açık bir gömme içerik değil, giriş gerektiren bir konsoldur. state olarak metin yapıştırın, "Bu mesaj aciliyet ifade ediyor mu?" gibi bir Noul ekleyin, ardından aynı çağrıya başka sorular da katın. Üretim anahtarlarını bağlamadan önce paralel değerlendirmeyi deneyimlemenin en hızlı yolu budur.

İlk curl isteği

Authorization: Bearer $TYPESAFE_API_KEY ve Content-Type: application/json ile curl -X POST https://api.typesafe.ai/v1/systemone komutunu çalıştırın. Gövde: state alanında bir Stripe-connect hata mesajı, model alanında jev-latest, questions.urgency alanında ise noul türü ve "Bu mesaj aciliyet ifade ediyor mu?" talimatı. Hızlı başlangıç örneği budur. İkinci bir gidiş dönüş yapmadan billing / technical / sales ölçütlerine sahip department adlı bir Choice ve sıralı düzeylere sahip frustration adlı bir Score ekleyin.

Bir şey başarısız olduğunda talimatlara daha fazla açıklama eklemeden önce jaggedness bölümünü okuyun. Harfi harfine okuma, tam koşulun talimatlarda ve ölçütlerde belirtilmesini gerektirir. Matematik işlemleri kod içinde yapılmalıdır. Üretim için farklı bir model gerekir. Zincirlenmiş Choice aracılığıyla Jev öğesinden paragraf yazmasını isterseniz API yine türü belirlenmiş bir yanıt döndürür; ancak sonuç yavaş ve kötü olur. Seçenekleri regex veya üretken bir modelle oluşturun, ardından seçimi Jev öğesine bırakın.

Cloudflare Workers AI, typesafe/jev adını katalogda listeler. Bu, üçüncü taraf bir listelemedir; api.typesafe.ai yerine geçmez. Steam'de Jev uygulaması yoktur. Anahtarları TypeSafe konsolunda tutun ve github.com/typesafe-ai kuruluşunu takip etmiyorlarsa Awesome Jev üzerindeki topluluk SDK'larını gayriresmî kabul edin.

Hatalar, yeniden denemeler ve kimlikler

Saniye başına token veya dakika başına istek sınırını aştığınızda belgelenmiş yanıt 429 Too Many Requests olur. retry-after değerine uyun. Resmî SDK'lar zaten artan sürelerle bekler. HTTP'yi kendiniz sarmalıyorsanız 429 sonrasında uç noktaya peş peşe istek göndermeyin; aynı sınır penceresinde kalırsınız.

Soru kimlikleri izleme kayıtlarınız içindir. Çıkarıma asla girmezler. Döngü içinde item_0 ile item_n arasında kimlikler üretip yine her biri için bir Noul alabilirsiniz. Bu anahtarları istek içinde benzersiz tutun. Bir anahtarı yeniden kullanmak, haritadaki sorunun sessizce üzerine yazar.

Yetkilendirme, panodan alınan bir Bearer TypeSafe API anahtarıyla yapılır. api.typesafe.ai üzerinde çerez tabanlı oturum yoktur. Anahtarları bu wiki'ye e-posta göndererek değil, konsoldan yenileyin. Oyun alanının giriş duvarı ayrıdır: alternatif bir HTTP API değil, tarayıcı konsoludur.

Hızlı başlangıç curl komutunu bir kez kopyalayın, ardından SDK lehine deponuzdan silin. Yeniden denemeleri ve türü belirlenmiş kurucuları SDK yönetir. Ham HTTP, resmî istemcisi olmayan diller içindir. Her iki yol da aynı JSON gövdesini ve Bearer anahtarlarını POST /v1/systemone adresine gönderir.

GET /v1/models, hesabınızın gönderebileceği takma adları listeler. Bu kimlik POST /v1/systemone içinde çalışsa bile jev-1.13.0 listede yer almayabilir. Listeyi sürümlü kimliklerin izin listesi saymayın. Bunu takma ad kataloğu olarak değerlendirin ve sürümlü kimliği kendi yapılandırmanızda tutun.

TYPESAFE_API_KEY değerini asla depoya işlemeyin. Sızarsa panodan yenileyin. contact@jevai.wiki, sızmış bir gizli anahtar için yanlış adrestir; TypeSafe'ın kendi kanallarını kullanın.

Belgelenen alt sınırlar Python 3.10 ve Node.js 20'dir. Daha eski çalışma ortamları resmî istemcilerin kapsamı dışındadır.