Mulai cepat
Dari akun baru sampai jawaban pertama model. Contoh di halaman ini memakai SDK resmi OpenAI dan Anthropic tanpa SDK khusus.
1. Siapkan akun dan saldo
- Daftar atau masuk di dashboard lalu verifikasi email Anda.
- Buka Saldo, lalu isi saldo lewat QRIS, virtual account, atau e-wallet. Permintaan ditolak
402 insufficient_balancebila saldo tidak cukup. - Buka API Key, lalu buat key. Anda bisa memberi batas belanja (Rp), batas permintaan per menit, tanggal kedaluwarsa, dan daftar model yang diizinkan.
2. Simpan key di variabel lingkungan
export MARKASAI_API_KEY="mt-..."
Key setara kata sandi. Jangan menaruhnya di kode sisi klien (web atau mobile), repositori publik, atau tangkapan layar. Bila bocor, cabut di dashboard (berlaku seketika) lalu buat key baru.
3. Pilih model
Lihat halaman Model atau panggil GET /v1/models. Salin nilai id ke parameter model.
curl https://api.markas.ai.id/v1/models -H "Authorization: Bearer $MARKASAI_API_KEY"
4. Panggilan pertama
curl https://api.markas.ai.id/v1/chat/completions \
-H "Authorization: Bearer $MARKASAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "Apa itu API?"}],
"max_tokens": 300
}'
import os
from openai import OpenAI
client = OpenAI(base_url="https://api.markas.ai.id/v1", api_key=os.environ["MARKASAI_API_KEY"])
resp = client.chat.completions.create(
model="MODEL_ID",
messages=[{"role": "user", "content": "Apa itu API?"}],
max_tokens=300,
)
print(resp.choices[0].message.content)
print(resp.usage)
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.markas.ai.id/v1", apiKey: process.env.MARKASAI_API_KEY });
const resp = await client.chat.completions.create({
model: "MODEL_ID",
messages: [{ role: "user", content: "Apa itu API?" }],
max_tokens: 300,
});
console.log(resp.choices[0].message.content);
Jawaban ada di choices[0].message.content. Jumlah token yang menjadi dasar tagihan ada di usage.
Format Anthropic
curl https://api.markas.ai.id/v1/messages \
-H "x-api-key: $MARKASAI_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"max_tokens": 300,
"messages": [{"role": "user", "content": "Apa itu API?"}]
}'
import os
import anthropic
client = anthropic.Anthropic(base_url="https://api.markas.ai.id", api_key=os.environ["MARKASAI_API_KEY"])
msg = client.messages.create(
model="MODEL_ID",
max_tokens=300,
messages=[{"role": "user", "content": "Apa itu API?"}],
)
print(msg.content[0].text)
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({ baseURL: "https://api.markas.ai.id", apiKey: process.env.MARKASAI_API_KEY });
const msg = await client.messages.create({
model: "MODEL_ID",
max_tokens: 300,
messages: [{ role: "user", content: "Apa itu API?" }],
});
console.log(msg.content);
max_tokens wajib di format Anthropic. SDK Anthropic memakai base URL tanpa /v1.
Langkah berikutnya
- Tampilkan jawaban kata demi kata: Streaming.
- Hubungkan Cursor, Claude Code, Codex CLI, dan alat lain: SDK dan alat AI.
- Pahami tahanan saldo dan biaya: Penagihan.