คีย์และที่อยู่ API

วิธีรับคีย์ ที่อยู่ที่ควรใช้ใน SDK แต่ละแบบ และวิธีส่งคีย์

คู่มือฉบับเต็ม

คีย์ API

สร้างคีย์ได้ในแดชบอร์ดที่ ailoot.ai หลังจาก ลงทะเบียน. คีย์มีรูปแบบเป็น sk-…. คุณสร้างหลายคีย์ได้ โดยแยกสำหรับคอมพิวเตอร์ที่ทำงาน เซิร์ฟเวอร์ และแต่ละแอป วิธีนี้ช่วยให้เพิกถอนคีย์หนึ่งได้โดยไม่กระทบคีย์อื่น

คุณกำหนดวงเงินใช้จ่ายรวม วันหมดอายุ รายการ IP ที่อนุญาตและบล็อก รวมถึงวงเงินใช้จ่ายในช่วง 5 ชั่วโมง, 1 วัน และ 7 วันให้กับคีย์ได้ หากถึงข้อจำกัดจะได้รับข้อผิดพลาดที่เข้าใจได้: api_key_quota_exhausted (ใช้วงเงินรวมครบแล้ว), usage_limit_reached (ใช้วงเงินในช่วงเวลาของคีย์ครบแล้ว — รอให้ช่วงเวลาเริ่มใหม่ หรือเพิ่มวงเงิน), api_key_expired หรือ permission_denied (เช่น ส่งคำขอจาก IP ที่ไม่ได้รับอนุญาต).

ที่อยู่ API

กฎหลัก: สำหรับไคลเอนต์ที่เข้ากันได้กับ OpenAI ที่อยู่ต้องมี /v1, ส่วน Anthropic และ Gemini ไม่ต้องมีส่วนนี้

ไคลเอนต์	ที่อยู่ฐาน	ปลายทางของคำขอ
OpenAI SDK และไคลเอนต์ที่เข้ากันได้	`https://api.ailoot.ai/v1`	`/v1/chat/completions`, `/v1/responses`, `/v1/embeddings`
Anthropic SDK, Claude Code	`https://api.ailoot.ai`	`/v1/messages`
Google GenAI SDK, Gemini CLI	`https://api.ailoot.ai`	`/v1beta/models/{model}:generateContent`
ไคลเอนต์ต้องการที่อยู่เต็ม	`https://api.ailoot.ai/v1/chat/completions`	ตามที่ระบุ

วิธีส่งคีย์

Ailoot ยอมรับคีย์ในเฮดเดอร์ใดก็ได้จากสามแบบนี้ ใช้แบบที่ SDK ของคุณส่งมาได้เลย:

ส่วนหัว	ผู้ที่ส่งด้วยวิธีนี้
`Authorization: Bearer sk-…`	OpenAI SDK และไคลเอนต์ส่วนใหญ่
`x-api-key: sk-…`	Anthropic SDK, Claude Code ที่ใช้ ANTHROPIC_API_KEY
`x-goog-api-key: sk-…`	Google GenAI SDK, Gemini CLI

บนเส้นทาง /v1/… คีย์ใน URL (?key= หรือ ?api_key=) จะไม่ได้รับการยอมรับ: คำขอจะได้รับ 400 พร้อมรหัส invalid_request และข้อความระบุว่าคีย์ถูกส่งมาใน URL วิธีนี้ช่วยป้องกันไม่ให้คีย์ปรากฏในบันทึกและประวัติเบราว์เซอร์ หากเคยส่งคีย์ใน URL แล้ว ควรสร้างคีย์ใหม่

บนเส้นทาง Gemini /v1beta/… เพื่อให้เข้ากันได้กับ Google ระบบยอมรับ ?key= — โดยมีลำดับความสำคัญต่ำสุด รองจากเฮดเดอร์ ?api_key= ก็ถูกปฏิเสธด้วย 400 เช่นกัน อย่างไรก็ตาม วิธีที่แน่นอนกว่าคือส่งคีย์ในเฮดเดอร์ x-goog-api-key.

ตัวแปรสภาพแวดล้อม

ควรสร้างตัวแปรหนึ่งตัว แล้วนำไปใช้ในการตั้งค่าโปรแกรมต่าง ๆ:

# ~/.zshrc หรือ ~/.bashrc
export AILOOT_API_KEY="sk-..."

# สำหรับโปรแกรมที่อ่านชื่อตัวแปรมาตรฐาน
export OPENAI_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_API_KEY="$AILOOT_API_KEY"
export ANTHROPIC_BASE_URL="https://api.ailoot.ai"
export ANTHROPIC_AUTH_TOKEN="$AILOOT_API_KEY"

setx AILOOT_API_KEY "sk-..."

# สำหรับโปรแกรมที่อ่านชื่อตัวแปรมาตรฐาน
setx OPENAI_BASE_URL "https://api.ailoot.ai/v1"
setx OPENAI_API_KEY "sk-..."
setx ANTHROPIC_BASE_URL "https://api.ailoot.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-..."
# เปิดเทอร์มินัลใหม่เพื่อให้ตัวแปรมีผล

ตรวจ⁠สอบคีย์

วิธีตรวจ⁠สอบคีย์ที่ประหยัดที่สุดคือขอรายชื่อโมเดล เพราะไม่มีค่าใช้จ่าย

curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY"

ยังมีคำถามอยู่ใช่ไหม ส่ง Request ID และรายละเอียดมาให้เรา เราจะช่วยตรวจ⁠สอบติดต่อฝ่ายสนับสนุน