Autentikasi

Sahkan setiap protokol API yang disokong dengan selamat menggunakan kunci API AnyInt.

Setiap permintaan Pembangun API memerlukan kunci API AnyInt yang aktif. Gunakan pengepala yang dijangkakan oleh protokol klien anda supaya SDK OpenAI, Anthropic dan Gemini sedia ada terus berfungsi.

Autentikasi yang Disyorkan mengikut Protokol

ProtokolInput yang disyorkanAsas API Kanonik
Serasi dengan OpenAIAuthorization: Bearer <AnyInt API Key>https://api.anyint.ai/openai/v1
Mesej 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 tak segerakAuthorization: Bearer <AnyInt API Key>https://api.anyint.ai/v1/async-tasks

Untuk keserasian klien, gerbang juga menerima pengepala kunci AnyInt yang disokong merentasi keluarga protokol dan menerima parameter kueri key Gemini pada laluan Gemini. Utamakan pengepala supaya kelayakan tidak muncul dalam URL atau log perantaraan.

Gerbang menggunakan kelayakan AnyInt sebelum penghalaan pembekal. Ia tidak pernah meneruskan kelayakan tersebut sebagai kunci pembekal huluan. Kunci yang tidak sah, tamat tempoh atau ditarik balik akan gagal tertutup.

Cipta Kunci

Cipta kunci API dalam Konsol, kemudian simpan dalam pengurus rahsia sisi pelayan atau pembolehubah persekitaran.

Kunci AnyInt yang baru dikeluarkan menggunakan awalan sk- diikuti dengan 52 aksara Base64URL (55 aksara jumlahnya). Kunci ak_ sedia ada kekal sah sehingga anda memutarkan atau melumpuhkannya. Sentiasa salin nilai lengkap yang ditunjukkan oleh Konsol; jangan tambah atau alih keluar awalan sendiri.

bash
export ANYINT_API_KEY="your_api_key"

Garis Panduan Keselamatan

  • Simpan kunci dalam pengurus rahsia sisi pelayan atau pembolehubah persekitaran.
  • Jangan sekali-kali letakkan kunci dalam JavaScript bahagian hadapan, kawalan sumber, log atau URL.
  • Gunakan kunci berasingan untuk setiap aplikasi dan persekitaran.
  • Putarkan kunci dengan segera jika ia mungkin telah terdedah.
  • Jangan teruskan kunci AnyInt kepada pembekal huluan.

Uji Autentikasi

Senaraikan model untuk mengesahkan kunci sebelum menghantar permintaan inferens.

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

Kegagalan autentikasi mengembalikan HTTP 401 dengan ralat berbentuk protokol. Kunci yang sah masih boleh menerima 402 untuk baki yang tidak mencukupi atau 503 apabila tiada pembekal yang layak tersedia.

Penyelesaian Masalah Ralat Biasa

Apabila permintaan API gagal, gunakan jadual ini untuk mengenal pasti punca dan penyelesaian dengan cepat:

Status HTTPPunca BiasaPenyelesaian Masalah & Langkah Pembetulan
401 UnauthorizedKunci API tidak sah atau tamat tempoh, atau pengepala hilangSahkan token Bearer atau pengepala x-api-key; pastikan kunci aktif dalam Kunci API Konsol.
402 Payment RequiredBaki tidak mencukupi atau had belanjawan bulanan dicapaiTambah kredit dalam Konsol atau tingkatkan had belanjawan bulanan untuk kunci API.
403 ForbiddenSekatan IP, ketidakpadanan persekitaran, atau kebenaran tidak mencukupiPeriksa skop kunci API anda dan sahkan IP pelanggan terhadap senarai IP yang dibenarkan.
404 Not FoundLaluan titik akhir tidak betul atau ID model tidak diketahuiSahkan laluan Base URL; panggil GET /v1/models untuk mengesahkan ID model aktif.
429 Too Many RequestsHad kadar (RPM/TPM) atau had serentak dicapaiKurangkan serentak; konfigurasikan percubaan semula backoff eksponen; atau minta peningkatan kuota dalam Konsol.
502 Bad GatewayRalat rangkaian pembekal huluan atau respons tidak sahGet laluan AnyInt secara automatik mencuba failover merentas saluran; jika berterusan, laporkan melalui Log Permintaan Konsol.
503 Service UnavailableSemua saluran calon penghalaan tidak tersedia buat sementaraCuba lagi selepas jeda seketika atau beralih kepada model sandaran yang setara.
504 Gateway TimeoutHad masa inferens huluan tamat (model penaakulan kompleks)Periksa kerumitan prompt; tingkatkan had masa pihak pelanggan; dayakan penstriman (stream: true) untuk model penaakulan.