Autentikasi

Otentikasi setiap protokol API yang didukung dengan aman menggunakan kunci API AnyInt.

Setiap permintaan Developer API memerlukan kunci API AnyInt yang aktif. Gunakan header yang diharapkan oleh protokol klien Anda sehingga SDK OpenAI, Anthropic, dan Gemini yang sudah ada tetap berfungsi.

Autentikasi yang Direkomendasikan berdasarkan Protokol

ProtokolInput yang direkomendasikanBasis API Kanonik
Kompatibel dengan OpenAIAuthorization: Bearer <AnyInt API Key>https://api.anyint.ai/openai/v1
Pesan Anthropicx-api-key: <AnyInt API Key>https://api.anyint.ai/anthropic/v1
Gemini Developer APIx-goog-api-key: <AnyInt API Key>https://api.anyint.ai/gemini/v1beta
Media AsinkronAuthorization: Bearer <AnyInt API Key>https://api.anyint.ai/v1/async-tasks

Untuk kompatibilitas klien, gateway juga menerima header kunci AnyInt yang didukung di seluruh keluarga protokol dan menerima parameter kueri key Gemini pada rute Gemini. Utamakan header agar kredensial tidak muncul di URL atau log perantara.

Gateway mengonsumsi kredensial AnyInt sebelum perutean penyedia. Gateway tidak pernah meneruskan kredensial tersebut sebagai kunci penyedia hulu. Kunci yang tidak valid, kedaluwarsa, atau dicabut akan gagal tertutup.

Buat Kunci

Buat kunci API di Konsol, lalu simpan di pengelola rahasia sisi server atau variabel lingkungan.

Kunci AnyInt yang baru diterbitkan menggunakan awalan sk- diikuti oleh 52 karakter Base64URL (total 55 karakter). Kunci ak_ yang ada tetap valid hingga Anda memutar atau menonaktifkannya. Selalu salin nilai lengkap yang ditampilkan oleh Konsol; jangan menambahkan atau menghapus awalan sendiri.

bash
export ANYINT_API_KEY="your_api_key"

Pedoman Keamanan

  • Simpan kunci di pengelola rahasia sisi server atau variabel lingkungan.
  • Jangan pernah menempatkan kunci di JavaScript frontend, kontrol sumber, log, atau URL.
  • Gunakan kunci terpisah untuk setiap aplikasi dan lingkungan.
  • Putar kunci segera jika mungkin telah terekspos.
  • Jangan meneruskan kunci AnyInt ke penyedia hulu.

Uji Autentikasi

Daftar model untuk memverifikasi kunci sebelum mengirim permintaan inferensi.

bash
curl "https://api.anyint.ai/openai/v1/models" \
  --header "Authorization: Bearer $ANYINT_API_KEY"

Kegagalan autentikasi mengembalikan HTTP 401 dengan kesalahan berbentuk protokol. Kunci yang valid masih dapat menerima 402 untuk saldo yang tidak mencukupi atau 503 ketika tidak ada penyedia yang memenuhi syarat yang tersedia.

Pemecahan Masalah Kesalahan Umum

Saat permintaan API gagal, gunakan tabel ini untuk mengidentifikasi penyebab dan solusinya dengan cepat:

Status HTTPPenyebab UmumPemecahan Masalah & Solusi
401 UnauthorizedKunci API tidak valid atau kedaluwarsa, atau header hilangVerifikasi token Bearer atau header x-api-key; pastikan kunci aktif di Kunci API Konsol.
402 Payment RequiredSaldo tidak mencukupi atau batas anggaran bulanan tercapaiTambahkan kredit di Konsol atau tingkatkan batas anggaran bulanan untuk kunci API.
403 ForbiddenPembatasan IP, ketidakcocokan lingkungan, atau izin tidak memadaiPeriksa cakupan kunci API Anda dan verifikasi IP klien terhadap daftar IP yang diizinkan.
404 Not FoundJalur titik akhir salah atau ID model tidak dikenalVerifikasi jalur Base URL; panggil GET /v1/models untuk memastikan ID model aktif.
429 Too Many RequestsBatas laju (RPM/TPM) atau batas konkurensi tercapaiKurangi konkurensi; konfigurasikan coba lagi backoff eksponensial; atau minta peningkatan kuota di Konsol.
502 Bad GatewayKesalahan jaringan penyedia upstream atau respons salah formatGateway AnyInt secara otomatis mencoba failover antar saluran; jika berlanjut, laporkan melalui Log Permintaan Konsol.
503 Service UnavailableSemua saluran kandidat perutean sementara tidak tersediaCoba lagi setelah beberapa saat atau beralih ke model cadangan yang setara.
504 Gateway TimeoutBatas waktu inferensi upstream terlampaui (model penalaran kompleks)Periksa kompleksitas prompt; tingkatkan batas waktu sisi klien; aktifkan streaming (stream: true) untuk model penalaran.