§02
ที่อยู่ API และการยืนยันตัวตน
รูปแบบ OpenAI (เครื่องมือและ SDK ส่วนใหญ่) ใช้ที่อยู่ที่มี /v1:
https://api.macloudai.com/v1รูปแบบ Anthropic (Anthropic SDK, Claude Code) ใช้ที่อยู่ที่ไม่มี /v1:
https://api.macloudai.comส่ง API Key ในเฮดเดอร์ Authorization: Bearer sk-... (รูปแบบ Anthropic ใช้ x-api-key ก็ได้) คีย์ใช้ยอดคงเหลือของคุณ อย่าใส่ไว้ในโค้ดฝั่งหน้าเว็บหรือ repo สาธารณะ
§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}'รองรับ stream (ส่งผลลัพธ์แบบสตรีม)
§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)ที่อยู่แบบ Anthropic ไม่มี /v1
§05
Claude Code
ตั้งตัวแปรสภาพแวดล้อมเหล่านี้ในเทอร์มินัลแล้วรัน claude (ถ้าอยากให้ใช้ได้ตลอดให้เขียนลงใน ~/.zshrc หรือ ~/.bashrc):
export ANTHROPIC_BASE_URL=https://api.macloudai.com
export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_MODEL=hk-5-5
claude§06
Cursor
- เปิด Settings → Models
- ใส่คีย์ของคุณในช่อง OpenAI API Key เปิด Override OpenAI Base URL แล้วใส่ https://api.macloudai.com/v1
- กด + Add model ใส่ชื่อโมเดลจากหน้าโมเดล แล้วกด Verify
§07
Cherry Studio
- Settings → Model Provider → Add เลือกประเภท OpenAI (โมเดล Claude เลือก Anthropic ก็ได้)
- ตั้ง API Host เป็น https://api.macloudai.com และใส่คีย์ของคุณที่ API Key
- กด Manage หรือ Add แล้วใส่ชื่อโมเดลจากหน้าโมเดล
§08
LobeChat
ใน Settings → Language Model → OpenAI ใส่ API Key และ API proxy address เป็น https://api.macloudai.com/v1 ถ้าติดตั้งเองให้ตั้งตัวแปรสภาพแวดล้อม:
OPENAI_API_KEY=sk-...
OPENAI_PROXY_URL=https://api.macloudai.com/v1§09
การคิดเงินและข้อผิดพลาด
การเรียกแต่ละครั้งหักจากยอดคงเหลือตามจำนวน token อินพุตและเอาต์พุต ดูราคาได้ที่หน้าโมเดล เมื่อยอดคงเหลือหมด คำขอจะถูกปฏิเสธ และใช้ได้ทันทีหลังเติมเงิน
| รหัสสถานะ | ความหมาย |
|---|---|
| 401 | API Key ไม่ถูกต้อง ถูกปิดใช้งาน หรือถูกลบแล้ว |
| 403 | ยอดคงเหลือไม่พอ หรือคีย์นี้ใช้โมเดลนี้ไม่ได้ |
| 404 | ชื่อโมเดลผิด ใส่ตามชื่อในหน้าโมเดล |
| 429 | ส่งคำขอถี่เกินไป รอสักครู่แล้วลองใหม่ |
| 5xx | โมเดลต้นทางขัดข้องชั่วคราว ลองใหม่อีกสักครู่ |