Autentikasi
Setiap permintaan ke /v1/* diautentikasi dengan API key MarkasAI. Key dibuat dan dicabut di dashboard.
Mengirim API key
| Header | Contoh |
|---|---|
Authorization | Authorization: Bearer mt-... |
x-api-key | x-api-key: mt-... |
Kedua header diterima di semua endpoint, termasuk /v1/messages. Pilih yang dipakai SDK atau alat Anda.
Format key
Key MarkasAI diawali mt- lalu 43 karakter (A-Z, a-z, 0-9, _, -). Key dengan format lain langsung ditolak 401 invalid_api_key.
Terlalu banyak percobaan dengan key salah dari satu alamat IP membuat IP itu dibatasi sementara dengan 429 rate_limit_exceeded.
Pengaturan per key
| Pengaturan | Efek |
|---|---|
| Batas belanja (Rp) | Bila tercapai, permintaan ditolak 403 key_spend_limit_exceeded. |
| Batas per menit | Lewat batas dijawab 429 rate_limit_exceeded dengan header Retry-After. |
| Kedaluwarsa | Setelah tanggal ini key ditolak 401 invalid_api_key. |
| Model yang diizinkan | Model lain ditolak 403 model_not_allowed, dan GET /v1/models hanya menampilkan model yang diizinkan. |
ID permintaan
Setiap respons membawa header x-request-id. Sertakan nilainya saat menghubungi dukungan. ID yang sama tampil di halaman Request di dashboard.
curl -i https://api.markas.ai.id/v1/models -H "Authorization: Bearer $MARKASAI_API_KEY"Praktik aman
- Panggil API dari server Anda. Jangan menaruh key di aplikasi browser atau mobile.
- Pakai satu key per aplikasi atau lingkungan supaya mudah dicabut tanpa mengganggu yang lain.
- Untuk alat pihak ketiga, pasang batas belanja dan daftar model yang diizinkan pada key-nya.
- Cabut key yang bocor di dashboard. Pencabutan berlaku seketika.