Faturalama hatalarını ve müşteri harcama limitlerini yönetin

Kimlik doğrulama için ShareAI ile Giriş Yap'ı ve hesap fonlu işlemler için açıkça ShareAI ile Öde yetkilendirmesini kullanın. openid yalnızca kapsam harcama yetkisi vermez. AI çıkarımı inference veya onaylanmış, rızası alınmış surcharge bir izin gerektirir; payments talepler ayrı ayrı onaylanmış ödeme işlemleri gerektirir. Müşteri, Console'da aylık AI limitini kontrol eder. Uygulamanız bunu değiştiremez.

Hataları kodla yönet#

HTTP 402 · insufficient_credits: ödeme hesabında bu sağlayıcı/model ve talep için uygun, süresi dolmamış yeterli kredi yok. Müşteriden kredilerini yönetmesini isteyin. Bazı krediler sağlayıcı veya model kısıtlamalarına sahiptir.

HTTP 402 · application_spending_limit_exceeded: aylık limit aşılmış, ayrılmış talepler mevcut ödeneği kullanır veya bu talebin ücreti limiti aşar. Bunu hız sınırı olarak değerlendirmeyin veya otomatik olarak yeniden denemeyin. Müşteriden limiti değiştirmesini veya reset_at.

HTTP 429 · oauth_rate_limit: geçici talep/eşzamanlılık sınırı. Retry-After ve sınırlı geri çekilme uygulayın. HTTP 401 · consent_required: rıza süresi dolmuş, iptal edilmiş veya artık geçerli değil; yeni bir yetkilendirme alın, kredi yüklemesi istemeyin.

{
  "error": {
    "type": "billing_error",
    "code": "application_spending_limit_exceeded",
    "message": "This application's monthly AI spending limit has been reached or this request would exceed it. Manage the limit or wait for the next month.",
    "management_url": "https://console.shareai.now/?shareai_billing_context=OPAQUE_SHORT_LIVED_VALUE",
    "help": "https://console.shareai.now/?shareai_billing_context=OPAQUE_SHORT_LIVED_VALUE",
    "monthly_limit": "50",
    "reset_at": "2026-10-01T00:00:00Z"
  }
}

İki finansal hata error.type = billing_error. management_url müşteri kurtarma hedefidir; help uyumluluk takma adıdır. monthly_limit tam bir EUR ondalık dizisidir ve reset_at UTC'dir. Bunlar limit hatalarında bulunur, yetersiz kredi hatalarında bulunmayabilir.

Doğru ödeme hesabını aç#

Görünür bir Faturalamayı Yönet eylemini döndürülen URL'yi kullanarak sunun. Opak bağlam 15 dakika içinde sona erer, orijinal ödeme hesabını ve bağlantıyı tanımlar ve oturum açma yönlendirmesinden sonra devam eder. Console, oturum açmış ziyaretçinin sahip/admin izinlerini kontrol eder ve bu hesabı seçmeden önce doğrular. Uygulama sahibinin faturalama sayfasıyla değiştirmeyin, bir aktör kimliği oluşturmayın, erişim belirteci eklemeyin veya müşteriyi otomatik olarak yönlendirmeyin.

Console kaynağı için bir izin listesi kullanın ve rel="noopener noreferrer" yeni bir sekme açıyorsanız. Bağlantı, fonların eklendiğine dair bir yetkilendirme veya kanıt değildir. Kalıcı bir yer imi olarak veya genel günlüklerde saklamayın. Süresi dolduğunda, müşteri doğrudan Faturalama'yı açabilir. Müşteri açıkça yeniden denemeyi istediğinde yeni bir bağlantı döndürülebilir.

const response = await fetch("https://api.shareai.now/api/v1/chat/completions", options);
const body = await response.json();
const error = body.error;
if (response.status === 402 && error?.type === "billing_error") {
  const message = error.code === "application_spending_limit_exceeded"
    ? "Your monthly limit for this app has been reached."
    : "Your ShareAI account needs eligible credits.";
  showBillingMessage(message);
  if (error.management_url) {
    const target = new URL(error.management_url);
    if (target.origin === "https://console.shareai.now") {
      // Render a user-activated link; never silently open it or retry spending.
      showManageBillingLink(target.href);
    }
  }
  return;
}
if (!response.ok || error) throw new Error(error?.message || "Request failed");
renderAnswer(body);

Akış ve nihai hesaplaşma#

ShareAI, kabul/bağlama öncesinde limiti kontrol eder ve gerçek ağ maliyetini artı ek ücreti nihai hesaplaşmada atomik olarak kontrol eder. Eşzamanlı talepler aynı limiti paylaşır. Girdi tahminleri boşluk bırakır; çıktı uzunluğu önceden bilinmez. Kalan ödeneği aşacak nihai bir ücret, kullanım borcu veya Builder ek ücret kredisi olmadan reddedilir.

Chat Completions SSE için, event: error aynı error.code ve kurtarma alanlarını kullanarak yönetin. Responses SSE için, response.failed ve okuyarak yönetin. response.error. Akış başladığında HTTP durumu zaten 200'dür; kısmi içerik başarılı tamamlanma anlamına gelmez. Sonucu tamamlanmış olarak işaretlemeyin, aşağı akışta ücretli işlemler gerçekleştirmeyin veya terminal hatasından sonra otomatik olarak yeniden göndermeyin. Akışsız Chat, Responses, Embeddings ve Images, faturalama hatasını HTTP 402 kök error zarfında gösterir.

Kapsam ve sıfırlamalar#

Takvim ayı UTC olarak işler. Limit, ödeme yapan hesap ve uygulama başına olup OAuth istemcileri, izinler ve yenilenmiş tokenler arasında paylaşılır; bir istemci hizmeti, Üretim anahtar döngüleri boyunca sabit iş kimliğini kullanır. Sadece yerleşmiş AI ağ maliyeti ve ek ücret sayılır. Sabit abonelikler ve ayrı olarak onaylanmış satın alımlar kendi ödeme yetkilendirmesine sahiptir ve bu AI limitini tüketmez. Sıfır, ek AI harcamalarını durdurur; null, limit olmadığı anlamına gelir. Limit düzenlendiğinde veya bağlantı yeniden yetkilendirildiğinde geçmiş ücretler korunur.

Bunlar Konsol'daki müşteri kontrolleridir, bütçeleri artırmak için bir geliştirici uç noktası değildir. İznin kapsamlarını, onaylanmış modelleri, müşteri sağlayıcı tercihlerini ve kabul edilen ek ücret şartlarını uygulamaya devam edin. Müşteri faturalandırma rehberi · Ödeme API'si.