Dokumentasi API MarkasAI
API MarkasAI kompatibel dengan OpenAI dan Anthropic. Aplikasi, SDK, dan alat AI yang sudah mendukung salah satu format itu cukup diarahkan ke base URL MarkasAI dengan API key MarkasAI. Biaya dipotong dari saldo prabayar dalam Rupiah.
Base URL
Semua endpoint ada di bawah alamat berikut. Gunakan HTTPS dan body JSON (Content-Type: application/json).
https://api.markas.ai.id/v1SDK dan alat berformat OpenAI memakai base URL dengan /v1. SDK dan alat berformat Anthropic memakai https://api.markas.ai.id tanpa /v1, karena mereka menambahkan /v1/messages sendiri.
Endpoint yang tersedia
| Metode | Jalur | Fungsi |
|---|---|---|
POST | /v1/chat/completions | Chat, format OpenAI |
POST | /v1/messages | Chat, format Anthropic |
POST | /v1/responses | Responses API OpenAI (dipakai Codex CLI) |
POST | /v1/images/generations | Generate gambar |
POST | /v1/videos/generations | Generate video |
GET | /v1/models | Daftar model yang boleh dipakai key, beserta harga |
GET | /healthz | Pemeriksaan hidup, tanpa autentikasi |
Jalur lain dijawab 404 not_found. Metode HTTP yang salah dijawab 405 method_not_allowed.
Yang didukung dan yang belum
- Chat format OpenAI dan Anthropic, dalam JSON maupun streaming SSE.
- Responses API (
/v1/responses) secara stateless:storedipaksafalsebila tidak diisi. - Generate gambar (dikembalikan sebagai base64) dan video (dikembalikan sebagai URL), ditagih dari saldo yang sama.
- Fitur yang dipahami model, seperti tool calling dan gambar sebagai masukan, diteruskan apa adanya. Ketersediaannya bergantung model.
- Batas belanja, batas permintaan per menit, kedaluwarsa, dan daftar model yang diizinkan, diatur per API key.
Belum tersedia: embeddings, audio, fine-tuning, batch, unggah file, dan endpoint pembantu seperti /v1/messages/count_tokens. Pemanggilan langsung dari browser juga tidak didukung (tanpa CORS): panggil dari server Anda.
Langkah berikutnya
- Mulai cepat: buat key dan kirim panggilan pertama.
- Autentikasi: cara mengirim API key dan pengaturan per key.
- Daftar model: ID model, jendela konteks, dan harga lewat API.
- Galat: kode galat dan kapan perlu mencoba ulang.