Kirim permintaan obrolan dengan OAuth

Pilih jalur ini ketika pelanggan telah mengizinkan aplikasi Anda untuk menggunakan akun ShareAI yang mereka pilih. Pertama, selesaikan kode otorisasi dengan PKCE dan dapatkan grant yang mencakup surcharge.

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}'

Token akses dimasukkan ke dalam header Bearer#

Endpoint chat dan body permintaan sama seperti alur API-key. Perbedaannya adalah kredensial dan siklus hidup otorisasinya. Refresh token hanya dikirim ke endpoint token; ID token hanya digunakan untuk masuk aplikasi yang divalidasi.

Siapa yang membayar dan rencana mana yang berlaku?#

Grant yang diterima mengidentifikasi akun personal atau organisasi yang dipilih, aplikasi, dan rencana penggunaan. Layanan menentukan nilai-nilai tersebut dari otorisasi. Jangan kirim ID pembayar, biaya builder, atau subjek klien lain dalam body chat untuk mengubah penagihan.

Perbarui akses tanpa kehilangan persetujuan#

Ketika access token kedaluwarsa, gunakan alur refresh di backend Anda dan simpan refresh token pengganti. Ketika grant dicabut atau persetujuan baru diperlukan, sambungkan kembali pelanggan melalui alur browser.

Penanganan kegagalan#

Identitas model dan penyedia eksekusi#

Salin pengenal model berbasis kreator yang tepat dari Model. Pilih infrastruktur secara terpisah dengan opsi provider objek. Secara default, peringkat penyedia yang memenuhi syarat berdasarkan harga, dari yang terendah terlebih dahulu. Pilih penyedia atau konsultasikan referensi kebijakan lengkap.

Batas pengeluaran bulanan dan pemulihan tagihan#

Setiap akun berbayar dapat menetapkan batas pengeluaran bulanan AI-nya sendiri per aplikasi atau layanan klien di Billing → Subscriptions & Commitments. Batas tersebut mencakup biaya jaringan dan biaya tambahan builder, sementara langganan tetap dan pembelian yang dikonfirmasi tetap terpisah. Kesalahan batas menggunakan HTTP 402 application_spending_limit_exceeded; kredit yang memenuhi syarat tidak mencukupi menggunakan HTTP 402 insufficient_credits. Keduanya menyediakan tautan tagihan pelanggan. Kontrak kesalahan, penanganan streaming, dan contoh integrasi.