Endpoint ของ AI Gateway และ Environment Variable

นอกจากฟีเจอร์ One-click Takeover สำหรับเครื่องมือ AI ที่พร้อมใช้งาน คุณยังสามารถเรียกใช้งาน AI Gateway จากแอปพลิเคชัน, สคริปต์ หรือเครื่องมือ AI อื่น ๆ ของคุณโดยตรงได้ เอกสารนี้จะอธิบายรูปแบบ Endpoint ของ Gateway ที่ถูกเปิดเผยออกมา และขั้นตอนการเชื่อมต่อด้วยคีย์เสมือน

Proxy Endpoint

บริการ Proxy ของ AI Gateway จะรันอยู่ที่ http://127.0.0.1:11580 เพื่อให้รองรับ SDK และเครื่องมือของผู้ให้บริการรายต่าง ๆ Gateway จึงมี Endpoint หลายรูปแบบบนพอร์ตเดียวกันดังนี้:

รูปแบบโปรโตคอล	Endpoint	ใช้ในกรณี
รองรับ OpenAI	http://127.0.0.1:11580/v1	ใช้กับ SDK หรือเครื่องมือที่เรียก OpenAI API เช่น /v1/chat/completions
รองรับ Anthropic	http://127.0.0.1:11580/v1/messages	ใช้กับ Anthropic SDK และ Claude Code ฯลฯ
รองรับ Gemini	http://127.0.0.1:11580/v1beta	ใช้กับ Google Gemini SDK และ Gemini CLI ฯลฯ

เพียงแค่เลือก Endpoint ให้ตรงกับโปรโตคอลของ SDK ที่คุณใช้ และชี้ปลายทางไปที่ Gateway ระบบจะทำการ Route ไปยังช่องทาง (Channel) ของผู้ให้บริการแต่ละรายตามสิทธิ์ของคีย์เสมือนโดยอัตโนมัติ

การยืนยันตัวตน: ใช้คีย์เสมือน

ทุกการเรียกใช้งาน Gateway ต้องใช้คีย์เสมือนเพื่อยืนยันตัวตน ไม่ใช่คีย์จริงของผู้ให้บริการ กรุณาสร้างและคัดลอกคีย์เสมือนจากหน้า คีย์ ก่อน

ที่หน้า AI Gateway → Endpoint (Endpoints) คุณสามารถเลือกคีย์เสมือน ระบบจะช่วยสร้างตัวแปรสภาพแวดล้อมที่สามารถคัดลอกไปใช้งานกับเครื่องมือยอดนิยมได้ทันที

ตัวอย่าง Environment Variable

ตัวอย่างต่อไปนี้สมมุติว่าคุณมีคีย์เสมือนแล้ว (แทนด้วย <คีย์เสมือนของคุณ>)

SDK/เครื่องมือที่รองรับ OpenAI

export OPENAI_BASE_URL="http://127.0.0.1:11580/v1"
export OPENAI_API_KEY="<คีย์เสมือนของคุณ>"

Claude Code / Anthropic

# หมายเหตุ: โปรโตคอล Anthropic ใช้ Gateway root address โดยไม่ต้องใส่ /v1
export ANTHROPIC_BASE_URL="http://127.0.0.1:11580"
export ANTHROPIC_AUTH_TOKEN="<คีย์เสมือนของคุณ>"

Gemini

export GOOGLE_GEMINI_BASE_URL="http://127.0.0.1:11580"
export GEMINI_API_KEY="<คีย์เสมือนของคุณ>"

ตัวอย่างการเรียกใช้งาน (OpenAI Compatible)

curl http://127.0.0.1:11580/v1/chat/completions \
  -H "Authorization: Bearer <คีย์เสมือนของคุณ>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好"}]
  }'

สำหรับ model ต้องเป็นโมเดลที่คุณได้ตั้งค่าไว้ในช่องทาง (Channel) และคีย์เสมือนนี้มีสิทธิ์เรียกใช้

ข้อกำหนดเบื้องต้น

• บริการ AI Gateway Proxy ต้องกำลังรันอยู่
• ต้องตั้งค่า Channel อย่างน้อย 1 ช่องทางที่มีสถานะปกติ และสร้างคีย์เสมือนที่มีสิทธิ์กับโมเดล/ช่องทางที่ต้องการใช้งานแล้ว

คำถามที่พบบ่อย (FAQ)

• ถาม: ทำไมได้รับแจ้งว่ายืนยันตัวตนล้มเหลว?
  • ตอบ: โปรดตรวจสอบว่าใช้คีย์เสมือน (ไม่ใช่คีย์จริงของผู้ให้บริการ) และคีย์นั้นยังไม่หมดอายุหรือถูกเพิกถอน
• ถาม: ขึ้นแจ้งว่าโมเดลไม่พร้อมใช้งานหรือไม่มีสิทธิ์เข้าถึง?
  • ตอบ: ตรวจสอบว่า model ที่เรียกได้ตั้งค่าไว้ใน Channel แล้ว และสิทธิ์ของคีย์เสมือนนี้รวมถึงโมเดล/Channel ดังกล่าว
• ถาม: เลือกใช้ Endpoint แบบไหนดี?
  • ตอบ: เลือกตามโปรโตคอลของ SDK ที่คุณใช้งาน — ถ้าเป็นแบบ OpenAI ใช้ /v1, Anthropic ใช้ /v1/messages (Base URL ไม่ต้องต่อ /v1), Gemini ใช้ /v1beta
• ถาม: อุปกรณ์อื่นในเครือข่ายภายในสามารถเข้าถึง Gateway ได้ไหม?
  • ตอบ: ตามค่าเริ่มต้น Gateway จะฟังเฉพาะ 127.0.0.1 (เฉพาะเครื่องนี้เท่านั้น) จึงปลอดภัยมากกว่า

สรุป

AI Gateway ให้บริการ Endpoint ภายในเครื่องในรูปแบบที่รองรับ OpenAI / Anthropic / Gemini พร้อมระบบคีย์เสมือนเพื่อยืนยันตัวตน คุณสามารถเชื่อมต่อแอปพลิเคชันหรือเครื่องมือ AI อะไรก็ได้ผ่าน Gateway เพื่อจัดการคีย์และจำกัดการใช้งานได้ในที่เดียว สำหรับเครื่องมือ CLI ทั่วไป แนะนำฟีเจอร์ One-click Takeover เพื่อความสะดวกยิ่งขึ้น