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
| Protokol | Input yang disyorkan | Asas API Kanonik |
|---|---|---|
| Serasi dengan OpenAI | Authorization: Bearer <AnyInt API Key> | https://api.anyint.ai/openai/v1 |
| Mesej Anthropic | x-api-key: <AnyInt API Key> | https://api.anyint.ai/anthropic/v1 |
| Gemini Developer API | x-goog-api-key: <AnyInt API Key> | https://api.anyint.ai/gemini/v1beta |
| Media tak segerak | Authorization: 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.
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.
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 HTTP | Punca Biasa | Penyelesaian Masalah & Langkah Pembetulan |
|---|---|---|
| 401 Unauthorized | Kunci API tidak sah atau tamat tempoh, atau pengepala hilang | Sahkan token Bearer atau pengepala x-api-key; pastikan kunci aktif dalam Kunci API Konsol. |
| 402 Payment Required | Baki tidak mencukupi atau had belanjawan bulanan dicapai | Tambah kredit dalam Konsol atau tingkatkan had belanjawan bulanan untuk kunci API. |
| 403 Forbidden | Sekatan IP, ketidakpadanan persekitaran, atau kebenaran tidak mencukupi | Periksa skop kunci API anda dan sahkan IP pelanggan terhadap senarai IP yang dibenarkan. |
| 404 Not Found | Laluan titik akhir tidak betul atau ID model tidak diketahui | Sahkan laluan Base URL; panggil GET /v1/models untuk mengesahkan ID model aktif. |
| 429 Too Many Requests | Had kadar (RPM/TPM) atau had serentak dicapai | Kurangkan serentak; konfigurasikan percubaan semula backoff eksponen; atau minta peningkatan kuota dalam Konsol. |
| 502 Bad Gateway | Ralat rangkaian pembekal huluan atau respons tidak sah | Get laluan AnyInt secara automatik mencuba failover merentas saluran; jika berterusan, laporkan melalui Log Permintaan Konsol. |
| 503 Service Unavailable | Semua saluran calon penghalaan tidak tersedia buat sementara | Cuba lagi selepas jeda seketika atau beralih kepada model sandaran yang setara. |
| 504 Gateway Timeout | Had masa inferens huluan tamat (model penaakulan kompleks) | Periksa kerumitan prompt; tingkatkan had masa pihak pelanggan; dayakan penstriman (stream: true) untuk model penaakulan. |