§01

Mula dalam tiga langkah

Daftar dengan e-mel atau akaun Google. Daftar percuma
Tambah nilai di konsol, kemudian cipta API Key.
Tukar base URL dalam aplikasi anda kepada alamat kami, tampal API Key, dan isi model dengan nama dari halaman model. Lihat model

§02

Alamat & pengesahan

Format OpenAI (kebanyakan alat dan SDK) menggunakan alamat dengan /v1:

https://api.macloudai.com/v1

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

https://api.macloudai.com

Hantar API Key dalam header Authorization: Bearer sk-... (format Anthropic juga menerima x-api-key). Key itu sama dengan baki anda, jadi jangan letak dalam kod frontend atau repo awam.

§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="gem-3.8-flash",
    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: "gem-3.8-flash",
  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": "gem-3.8-flash", "messages": [{"role": "user", "content": "Halo"}], "stream": true}'

Streaming disokong.

§04

Anthropic SDK

import anthropic

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

Alamat format Anthropic tidak mempunyai /v1.

§05

Claude Code

Tetapkan pemboleh ubah ini dalam terminal, kemudian jalankan claude (tambah ke ~/.zshrc atau ~/.bashrc supaya kekal):

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

§06

Cursor

Buka Settings → Models.
Masukkan key anda di OpenAI API Key, hidupkan Override OpenAI Base URL dan masukkan https://api.macloudai.com/v1.
Klik + Add model, masukkan nama model dari halaman model, kemudian klik Verify.

§07

Cherry Studio

Settings → Model Provider → Add, pilih jenis OpenAI (untuk model Claude, Anthropic juga boleh).
Tetapkan API Host kepada https://api.macloudai.com dan API Key kepada key anda.
Klik Manage atau Add dan masukkan nama model dari halaman model.

§08

LobeChat

Di Settings → Language Model → OpenAI, masukkan API Key dan API proxy address https://api.macloudai.com/v1. Jika dihos sendiri, tetapkan pemboleh ubah ini:

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

§09

Caj & ralat

Setiap panggilan ditolak daripada baki ikut token input dan output, harga ada di halaman model. Apabila baki habis, permintaan ditolak dan berfungsi semula sebaik sahaja anda tambah nilai.

Kod	Maksud
401	API Key salah, dinyahaktifkan atau sudah dipadam.
403	Baki tidak mencukupi, atau key ini tidak boleh menggunakan model tersebut.
404	Nama model salah. Guna nama tepat dari halaman model.
429	Terlalu banyak permintaan. Tunggu sebentar dan cuba lagi.
5xx	Model sedang ralat buat sementara. Cuba lagi sebentar lagi.