§01

Mulai dalam tiga langkah

Daftar pakai email atau akun Google. Daftar gratis
Isi saldo di konsol, lalu buat API key.
Ganti base URL di aplikasimu ke alamat kami, tempel API key, dan isi model dengan nama dari halaman model. Lihat model

§02

Alamat & autentikasi

Format OpenAI (kebanyakan tool dan SDK) pakai alamat dengan /v1:

https://api.macloudai.com/v1

Format Anthropic (Anthropic SDK, Claude Code) pakai alamat tanpa /v1:

https://api.macloudai.com

Kirim API key di header Authorization: Bearer sk-... (format Anthropic juga bisa pakai x-api-key). Key = saldo kamu, jangan taruh di kode frontend atau repo publik.

§03

OpenAI SDK

from openai import OpenAI

client = OpenAI(base_url="https://api.macloudai.com/v1", api_key="sk-...")
r = client.chat.completions.create(
    model="op-5-5",
    messages=[{"role": "user", "content": "Halo"}],
)
print(r.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.macloudai.com/v1", apiKey: process.env.API_KEY });
const r = await client.chat.completions.create({
  model: "op-5-5",
  messages: [{ role: "user", content: "Halo" }],
});
console.log(r.choices[0].message.content);

curl https://api.macloudai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "op-5-5", "messages": [{"role": "user", "content": "Halo"}], "stream": true}'

Streaming didukung.

§04

Anthropic SDK

import anthropic

client = anthropic.Anthropic(base_url="https://api.macloudai.com", api_key="sk-...")
r = client.messages.create(
    model="op-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Halo"}],
)
print(r.content[0].text)

Alamat format Anthropic tanpa /v1.

§05

Claude Code

Set variabel ini di terminal lalu jalankan claude (supaya permanen, tulis di ~/.zshrc atau ~/.bashrc):

export ANTHROPIC_BASE_URL=https://api.macloudai.com
export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_MODEL=op-5-5
claude

§06

Cursor

Buka Settings → Models.
Isi OpenAI API Key dengan key kamu, nyalakan Override OpenAI Base URL, isi https://api.macloudai.com/v1.
Klik + Add model, isi nama model dari halaman model, lalu klik Verify.

§07

Cherry Studio

Settings → Model Provider → Add, pilih tipe OpenAI (untuk model Claude bisa juga Anthropic).
Isi API Host dengan https://api.macloudai.com dan API Key dengan key kamu.
Klik Manage atau Add, isi nama model dari halaman model.

§08

LobeChat

Di Settings → Language Model → OpenAI, isi API key dan API proxy address https://api.macloudai.com/v1. Kalau self-host, pakai variabel ini:

OPENAI_API_KEY=sk-...
OPENAI_PROXY_URL=https://api.macloudai.com/v1

§09

Biaya & kode error

Setiap panggilan dipotong dari saldo sesuai token input dan output, harga ada di halaman model. Kalau saldo habis, request ditolak dan langsung jalan lagi setelah isi saldo.

Kode	Artinya
401	API key salah, dinonaktifkan, atau sudah dihapus.
403	Saldo tidak cukup, atau key ini tidak boleh pakai model tersebut.
404	Nama model salah. Pakai nama persis dari halaman model.
429	Terlalu banyak request. Tunggu sebentar lalu coba lagi.
5xx	Model sedang error sementara. Coba lagi sebentar lagi.