OAuth ile sohbet istekleri gönderin
Müşteri tarafından finanse edilen sohbet tamamlamaları için onaylanmış bir ShareAI OAuth erişim belirteci kullanın ve belirteç süresinin dolmasını, onayı ve hesap sınırlarını yönetin.
Bu sayfada
Bir müşteri, uygulamanızın seçilen ShareAI hesabını kullanmasına izin verdiğinde bu yolu seçin. İlk olarak PKCE ile yetkilendirme kodunu tamamlayın ve aşağıdakileri içeren bir yetki alın: surcharge.
https://api.shareai.now/api/v1/chat/completionsMüşterinin kabul ettiği uygulama anlaşması kapsamında çıkarım çalıştırın.
- Temel URL
https://api.shareai.now- Kimlik doğrulama
- Bearer OAuth erişim token'ı
- Gerekli kapsam
surcharge
cURL
curl --fail-with-body https://api.shareai.now/api/v1/chat/completions \
-H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data '{"model":"MODEL_IDENTIFIER","messages":[{"role":"user","content":"Hello!"}],"stream":false}'
Erişim belirteci Bearer başlığına yerleştirilir#
Sohbet uç noktası ve istek gövdesi, API anahtarı akışıyla aynıdır. Fark, kimlik bilgisi ve onun yetkilendirme yaşam döngüsüdür. Yenileme jetonu yalnızca jeton uç noktasına gönderilir; bir kimlik jetonu yalnızca doğrulanmış uygulama oturum açma işlemi için kullanılır.
Kim öder ve hangi plan geçerlidir?#
Kabul edilen yetki, seçilen kişisel veya organizasyon hesabını, uygulamayı ve kullanım planını tanımlar. Hizmet, bu değerleri yetkilendirmeden belirler. Faturalandırmayı değiştirmek için sohbet gövdesine bir ödeme yapan kimliği, Builder ücreti veya başka bir müşterinin konusu göndermeyin.
Erişimi kaybetmeden yenileyin#
Erişim jetonu süresi dolduğunda, yenileme akışını arka ucunuzda kullanın ve yerine geçen yenileme jetonunu saklayın. Yetki iptal edildiğinde veya yeni bir onay gerektiğinde, müşteriyi tarayıcı akışı aracılığıyla yeniden bağlayın.
Hata yönetimi#
| Sonuç | Eylem |
|---|---|
401 consent_required | Yetkilendirme artık geçerli değilse müşteriden yeniden bağlanmasını isteyin. |
403 | Verilen çıkarım iznini ve izin verilen model/sağlayıcı erişimini kontrol edin. |
429 | Retry-After ve uygulama/hesap sınırlarınıza saygı gösterin. |
503 temporarily_unavailable | Geçici bir hizmet hatası gösterin; müşteriye onayın iptal edildiğini söylemeyin. |
Model kimliği ve yürütme sağlayıcıları#
Tam olarak yaratıcı tabanlı model tanımlayıcısını kopyalayın Modeller. Altyapıyı isteğe bağlı olarak ayrı seçin provider nesne. Varsayılan, uygun sağlayıcıları fiyatlarına göre sıralar, en düşükten başlayarak. Sağlayıcıları seçin veya danışın tam politika referansı.
Aylık harcama limitleri ve faturalama kurtarma#
Her ödeme yapan hesap, Faturalama → Abonelikler ve Taahhütler bölümünde uygulama veya müşteri hizmeti başına kendi aylık AI harcama limitini belirleyebilir. Limit, ağ maliyetini ve Builder ek ücretini içerir, sabit abonelikler ve onaylanmış satın alımlar ise ayrı tutulur. Bir limit hatası HTTP 402 kullanır application_spending_limit_exceeded; uygun krediler yetersiz olduğunda HTTP 402 kullanılır insufficient_credits. Her ikisi de bir müşteri faturalama bağlantısı sağlar. Hata sözleşmesi, akış işleme ve entegrasyon örneği.
Son güncelleme Eylül 18, 2026