SDK dan alat AI

Hampir semua SDK dan alat AI mendukung API yang kompatibel OpenAI atau Anthropic. Cukup isi tiga hal: base URL, API key, dan ID model.

Tiga isian

Isian	Nilai
Base URL	`https://api.markas.ai.id/v1` untuk format OpenAI. `https://api.markas.ai.id` (tanpa `/v1`) untuk format Anthropic.
API key	Key `mt-...` dari dashboard.
Model	`id` dari halaman Model atau `GET /v1/models`.

Isi juga batas token keluaran dan jendela konteks di pengaturan alat sesuai max_output_tokens dan context_length model. Alat yang tidak mengirim max_tokens membuat tahanan saldo memakai batas model, sehingga saldo kecil bisa ditolak 402.

SDK dan kerangka kerja

SDK	Pengaturan
OpenAI Python	`OpenAI(base_url="https://api.markas.ai.id/v1", api_key=...)`
OpenAI Node.js	`new OpenAI({ baseURL: "https://api.markas.ai.id/v1", apiKey })`
Anthropic Python	`anthropic.Anthropic(base_url="https://api.markas.ai.id", api_key=...)`
Anthropic Node.js	`new Anthropic({ baseURL: "https://api.markas.ai.id", apiKey })`
LangChain (Python)	`ChatOpenAI(model="MODEL_ID", base_url="https://api.markas.ai.id/v1", api_key=...)`
LangChain.js	`new ChatOpenAI({ model: "MODEL_ID", apiKey, configuration: { baseURL: "https://api.markas.ai.id/v1" } })`
LlamaIndex	`OpenAILike(model="MODEL_ID", api_base="https://api.markas.ai.id/v1", api_key=..., is_chat_model=True)`
Vercel AI SDK	`createOpenAICompatible({ name: "markasai", baseURL: "https://api.markas.ai.id/v1", apiKey })`

Banyak alat membaca variabel lingkungan standar SDK OpenAI:

Terminal

export OPENAI_BASE_URL="https://api.markas.ai.id/v1"
export OPENAI_API_KEY="$MARKASAI_API_KEY"

Alat AI untuk developer

Alat	Format	Catatan
Cursor	OpenAI	Override OpenAI Base URL di Settings, Models. Chat dan Agent memakai model MarkasAI; Tab tetap model Cursor.
Claude Code	Anthropic	Tidak resmi: dirancang untuk model Claude. Lihat contoh variabel lingkungan di bawah.
Codex CLI	Responses	Provider kustom di `~/.codex/config.toml` dengan `wire_api = "responses"`.
Cline, Roo Code, Kilo Code	OpenAI	Pilih penyedia OpenAI Compatible.
Continue, OpenCode, Zed	OpenAI	Penyedia OpenAI dengan base URL kustom di berkas konfigurasi alat.
Aider	OpenAI	Variabel `OPENAI_API_BASE` dan `OPENAI_API_KEY`, model dengan awalan `openai/`.
Open WebUI	OpenAI	Tambahkan koneksi OpenAI di menu Connections.
OpenClaw, Hermes Agent	OpenAI atau Anthropic	Provider kustom di berkas konfigurasi alat.

Claude Code

Terminal

export ANTHROPIC_BASE_URL="https://api.markas.ai.id"
export ANTHROPIC_AUTH_TOKEN="$MARKASAI_API_KEY"
export ANTHROPIC_MODEL="MODEL_ID"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="SMALL_MODEL_ID"
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
claude

Codex CLI

~/.codex/config.toml

model = "MODEL_ID"
model_provider = "markasai"

[model_providers.markasai]
name = "MarkasAI"
base_url = "https://api.markas.ai.id/v1"
env_key = "MARKASAI_API_KEY"
wire_api = "responses"

Bila Codex tidak mengenal ID model, tambahkan model_context_window dan model_max_output_tokens sesuai /v1/models di blok provider.

Gejala umum

Gejala	Penyebab dan tindakan
`404` pada `/v1/v1/...`	Alat Anthropic menambahkan `/v1` sendiri. Pakai base URL tanpa `/v1`.
`404` pada `/chat/completions`	Base URL OpenAI kurang `/v1`.
Alat menolak key (mengharapkan `sk-...`)	Pakai opsi OpenAI Compatible atau penyedia kustom yang tidak memeriksa awalan key.
CORS atau Failed to fetch di aplikasi web	Pemanggilan dari browser tidak didukung. Panggil dari server Anda.
Stream berhenti di tengah	Proxy, VPN, atau antivirus menyangga SSE. Matikan buffering, atau coba tanpa streaming.