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

  1. Daftar atau masuk di dashboard lalu verifikasi email Anda.
  2. Buka Saldo, lalu isi saldo lewat QRIS, virtual account, atau e-wallet. Permintaan ditolak 402 insufficient_balance bila saldo tidak cukup.
  3. 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

Terminal
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
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