Mulai dalam 5 menit

Dokumentasi API yang jelas untuk membangun dengan ModelMu.

Gunakan endpoint kompatibel OpenAI untuk list model, chat completions, billing berbasis kredit, dan mode mock untuk development lokal.

Base URL

http://localhost:3000/api/v1

Authorization

Bearer sk_modelmu_xxx

Format

application/json

01 / Quickstart

Alur penggunaan API

Step 1

Daftar atau login

Masuk ke dashboard ModelMu untuk mengelola saldo, API key, dan riwayat penggunaan.

Step 2

Buat API key

Buka menu API Keys, buat key baru, lalu simpan sebagai environment variable.

Step 3

Ganti baseURL

Arahkan SDK OpenAI ke endpoint ModelMu tanpa mengubah struktur request utama.

Step 4

Kirim request

Gunakan endpoint chat completions atau list models untuk mulai membangun aplikasi AI.

02 / Auth

Base URL dan Authorization

Semua request API v1 memakai base URL lokal berikut. Untuk deployment production, ganti domain sesuai domain ModelMu yang Anda gunakan.

Environment variable
MODELMU_API_KEY=sk_modelmu_xxx
MODELMU_BASE_URL=http://localhost:3000/api/v1

Format header wajib

Authorization: Bearer sk_modelmu_xxx

03 / Endpoint

List model dan chat completions

GET/api/v1/models

Gunakan endpoint ini untuk menampilkan model yang tersedia di aplikasi Anda.

cURL list models
curl http://localhost:3000/api/v1/models \
  -H "Authorization: Bearer sk_modelmu_xxx"
POST/api/v1/chat/completions

Kirim percakapan ke model pilihan. Struktur payload mengikuti format OpenAI Chat Completions.

cURL chat completions
curl http://localhost:3000/api/v1/chat/completions \
  -H "Authorization: Bearer sk_modelmu_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      {"role": "user", "content": "Halo dari Indonesia"}
    ],
    "max_tokens": 500
  }'

04 / SDK

Node.js dengan SDK OpenAI

Jika aplikasi Anda sudah memakai SDK OpenAI, integrasi ModelMu cukup dengan mengganti `baseURL` dan API key.

Install dan request pertama
npm install openai

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.MODELMU_API_KEY,
  baseURL: "http://localhost:3000/api/v1",
});

const response = await client.chat.completions.create({
  model: "claude-sonnet-4-6",
  messages: [{ role: "user", content: "Buatkan ide SaaS AI" }],
});

console.log(response.choices[0].message.content);

05 / Models

Model awal yang tersedia

gpt-4o-mini
gpt-4.1
claude-sonnet-4-6
claude-opus-4-8
gemini-2.5-flash
gemini-2.5-pro

06 / Development

Mode mock untuk development lokal

Uji endpoint tanpa API key provider eksternal

Set environment variable berikut agar endpoint chat bisa diuji secara lokal. Billing, usage log, API key, dan response shape tetap berjalan.

Mock provider
MOCK_AI_PROVIDER=true

07 / Bantuan

Troubleshooting error umum

401

API key tidak valid

Pastikan header Authorization memakai format Bearer dan key belum dihapus dari dashboard.

402

Saldo tidak cukup

Top up kredit atau pilih model yang lebih hemat sebelum mengirim request baru.

400

Payload tidak valid

Periksa field model, messages, max_tokens, dan tipe data JSON yang dikirim.

Tips debugging

Mulai dari `GET /api/v1/models` untuk memastikan API key benar, lalu lanjutkan ke chat completions dengan payload minimal.

Siap coba request pertama?

Buat API key dari dashboard, salin contoh cURL di atas, lalu kirim request pertama Anda ke ModelMu.

Buat API key