API Claude dan ChatGPT dengan satu kunci, bayar ikut penggunaan

Kenapa satu kunci untuk semua model?

Kalau anda mahu guna Claude untuk menulis kod, GPT untuk ringkasan dan DeepSeek untuk kerja berulang yang murah, cara biasa ialah buka tiga akaun di tiga penyedia, simpan tiga kunci API dan urus tiga bil dalam dolar AS. Bagi pembangun bebas di Johor Bahru atau pasukan kecil di Kuala Lumpur, itu banyak kerja pentadbiran untuk projek yang kadangkala cuma beberapa ratus panggilan sebulan.

Di MaCloud AI anda ada satu akaun, satu baki dan satu kunci API. Semua model yang tersenarai di halaman model boleh dipanggil dengan kunci yang sama. Tiada yuran bulanan, tiada minimum perbelanjaan bulanan: anda bayar ikut token yang benar-benar digunakan, dan harga dipaparkan dalam ringgit.

Langkah-langkah bermula

1. Daftar atau log masuk dengan e-mel anda. Akaun dibuat secara automatik semasa log masuk kali pertama, dan tidak perlu kad.
2. Sahkan e-mel. Pelanggan baharu yang sudah mengesahkan e-mel menerima sedikit kredit percubaan semasa membuka konsol kali pertama.
3. Buka Tambah nilai di konsol dan pilih kaedah bayaran yang dibuka pada masa ini (minimum RM 12). Kalau tiada kaedah yang sesuai untuk anda, hubungi khidmat pelanggan.
4. Buka API Key, klik Cipta key, beri nama (contohnya laman-kedai atau bot-whatsapp), kemudian salin kunci yang bermula dengan sk-.
5. Dalam kod atau aplikasi anda, tetapkan base URL kepada https://api.macloudai.com/v1 (format OpenAI) atau https://api.macloudai.com (format Anthropic), dan masukkan kunci tadi.
6. Isi parameter model dengan nama model yang disalin tepat dari halaman model.

Kunci API hanya dipaparkan penuh sekali selepas dicipta. Di konsol, menu API Key → butang Cipta key → salin terus dan simpan di tempat selamat, contohnya dalam fail .env yang tidak dimuat naik ke GitHub.

Contoh kod Python (OpenAI SDK)

Pasang SDK dengan pip install openai, kemudian jalankan:

from openai import OpenAI

client = OpenAI(base_url="https://api.macloudai.com/v1", api_key="sk-...")

r = client.chat.completions.create(
    model="hk-5-5",
    messages=[{"role": "user", "content": "Tulis 3 idea nama untuk kafe kecil di Georgetown, Pulau Pinang."}],
)
print(r.choices[0].message.content)
print(r.usage)  # token input dan output untuk panggilan ini

Walaupun ini SDK OpenAI, model Claude, Gemini dan DeepSeek juga boleh dipanggil melaluinya. Itu sebabnya satu kunci memadai.

Contoh kod Node.js dan curl

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.macloudai.com/v1", apiKey: "sk-..." });

const r = await client.chat.completions.create({
  model: "tt-6-luna",
  messages: [{ role: "user", content: "Terangkan apa itu API dalam dua ayat." }],
});
console.log(r.choices[0].message.content);

curl https://api.macloudai.com/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-v4.1-flash", "stream": true, "messages": [{"role": "user", "content": "Selamat pagi!"}]}'

Dengan "stream": true, jawapan dihantar sedikit demi sedikit, sesuai untuk paparan sembang. Kalau anda guna Anthropic SDK pula, tetapkan base_url kepada https://api.macloudai.com tanpa /v1.

Tukar model dengan nama sahaja

Kod di atas tidak perlu diubah selain baris model. Contohnya, satu skrip boleh mencuba beberapa model untuk soalan yang sama:

from openai import OpenAI

client = OpenAI(base_url="https://api.macloudai.com/v1", api_key="sk-...")
soalan = "Ringkaskan polisi pemulangan kedai online ini dalam 3 poin: ..."

for m in ["hk-5-5", "tt-6-luna", "gem-3.8-flash", "deepseek-v4.1-flash"]:
    r = client.chat.completions.create(model=m, messages=[{"role": "user", "content": soalan}])
    print("==", m, r.usage.prompt_tokens, r.usage.completion_tokens)
    print(r.choices[0].message.content)

Selepas itu, buka Penggunaan di konsol. Setiap panggilan dipaparkan dengan nama model, token input, token output dan kosnya, jadi anda nampak model mana yang paling berbaloi untuk tugas itu.

Berapa kosnya?

Harga ditulis dalam ringgit bagi setiap 1 juta token, dan token input serta output dikira berasingan. Jadual di bawah dibaca terus dari halaman model:

Harga sebenar sekarang

Anggaran daripada harga di halaman model: 2,000 token input dan 500 token output bagi setiap chat. Caj sebenar dipaparkan dalam konsol.

Baki tidak tamat tempoh selagi akaun aktif. Bila baki habis, permintaan akan ditolak, dan sebaik sahaja anda tambah nilai semula ia terus berfungsi. Untuk cara pengiraan penuh, baca cara kos API dikira ikut token.

Ralat biasa dan maksudnya

Jaga kunci API anda

• Jangan letak kunci dalam kod frontend (yang berjalan di pelayar) atau dalam repo awam. Sesiapa yang memegang kunci boleh guna baki anda.
• Cipta satu kunci untuk setiap projek. Kalau satu bocor, padam yang itu sahaja tanpa mengganggu projek lain.
• Isi perbualan tidak disimpan oleh kami; yang direkodkan hanya bilangan token, nama model dan masa, untuk pengebilan.

Langkah seterusnya: lihat dokumentasi untuk tetapan Cursor, Cherry Studio dan LobeChat, atau baca cara mula guna Claude Code.

Soalan lazim

Panduan lain

• Cara mula guna Claude Code dengan kunci API MaCloud AI
• Bina bot WhatsApp yang dijawab AI: panduan langkah demi langkah
• Pilih Claude, GPT, Gemini atau DeepSeek: model mana untuk anda?
• Bagaimana kos API AI dikira ikut token (dengan contoh)
• Bayar ikut penggunaan vs langganan AI bulanan: mana lebih jimat?