คีย์ API ของ Gateway
คีย์ Gateway เป็นของเวิร์กสเปซเดียวและแสดงครั้งเดียว คิดค่าใช้จ่ายกับแผนก จำกัดโมเดล ที่อยู่ และวันหมดอายุ เปลี่ยนคีย์แบบมีช่วงซ้อน หรือเพิกถอนได้
สร้างคีย์#
เจ้าของและผู้ดูแลเวิร์กสเปซจัดการคีย์ได้ที่ AI Gateway › เริ่มต้นใช้งาน เลือก สร้างคีย์ API ตั้งชื่อ เช่น ชื่อทีมหรือเครื่องมือที่จะใช้ แล้วคัดลอกคีย์ คีย์จะแสดงเพียงครั้งเดียวและเก็บไว้เป็นค่าแฮชเท่านั้น ถ้าทำหาย ให้สร้างคีย์ใหม่
คีย์มีรูปแบบ al_gw_<id>.<secret> ส่งเป็น Authorization: Bearer <key> ทุก endpoint ยกเว้น /v1/chat/completions รับเป็น x-api-key ได้ด้วย คีย์เรียกได้เฉพาะ endpoint /v1 ของ Gateway เท่านั้น เรียกคอนโซลหรือผลิตภัณฑ์อื่นของ Agent Lab ไม่ได้
อย่าใช้คีย์ในเบราว์เซอร์
Gateway ปฏิเสธคำขอที่มีเฮดเดอร์ Origin (server_application_required) ให้เรียกจากเซิร์ฟเวอร์ CLI หรือสคริปต์ และเก็บคีย์ไว้ในตัวแปรสภาพแวดล้อมหรือที่เก็บความลับ
คิดค่าใช้จ่ายของคีย์กับแผนก#
การจัดสรรค่าใช้จ่าย ของคีย์กำหนดว่าค่าใช้จ่ายจะนับกับงบของใคร ถ้าไม่เลือกแผนก ค่าใช้จ่ายจะนับกับเวิร์กสเปซเท่านั้น ถ้าเลือกตั้งแต่หนึ่งแผนกขึ้นไป ทุกคำขอที่ใช้คีย์นี้จะนับเต็มจำนวนกับเพดานของแต่ละแผนกที่เลือกด้วย การเปลี่ยนแปลงมีผลกับคำขอถัดไป ค่าใช้จ่ายที่บันทึกไปแล้วจะไม่ย้าย
จำกัดสิ่งที่คีย์ทำได้#
แต่ละรายการไม่บังคับ และคีย์ใหม่ไม่มีการตั้งค่าใดเลย
| การควบคุม | สิ่งที่ทำ |
|---|---|
| วันหมดอายุ | หลังเวลานี้คีย์จะถือว่าถูกเพิกถอน คีย์ที่ใกล้หมดอายุที่สุดจะแสดงก่อน พร้อมจำนวนวันที่เหลือ |
| รายการโมเดลที่อนุญาต | คำขอที่ระบุโมเดลอื่นจะถูกปฏิเสธด้วย gateway_key_model_not_allowed และ auto จะเลือกเฉพาะจากโมเดลในรายการ |
| รายการที่อยู่ที่อนุญาต | ช่วง IP (CIDR) ได้สูงสุด 32 ช่วง คำขอจากที่อยู่อื่นจะถูกปฏิเสธเหมือนคีย์ไม่ถูกต้อง และบันทึกการปฏิเสธพร้อมที่อยู่นั้น |
| ขีดจำกัดอัตรา | จำนวนคำขอและโทเค็นต่อนาทีของคีย์นี้ ดูขีดจำกัดอัตรา |
| เพดานคำขอพร้อมกัน | จำนวนคำขอที่ทำงานพร้อมกันได้สูงสุด ค่าเริ่มต้นไม่มี Gateway รับคำขอแบบขนานได้เหมือนการเชื่อมต่อผู้ให้บริการโดยตรง |
เปลี่ยนคีย์#
เปลี่ยนคีย์ จะสร้างคีย์ใหม่ที่มีแผนก รายการที่อนุญาต และขีดจำกัดเหมือนเดิม และตั้งวันหมดอายุให้คีย์เดิมหลังช่วงใช้ซ้อนกันที่คุณเลือก (เช่น เจ็ดวัน) ระหว่างช่วงนี้ทั้งสองคีย์ใช้ได้ คุณจึงย้ายเครื่องมือแต่ละตัวไปใช้คีย์ใหม่ได้โดยไม่มีช่วงขาด คีย์ใหม่จะแสดงเพียงครั้งเดียว
เพิกถอนคีย์#
เพิกถอน หยุดคีย์ทันที คำขอถัดไปที่ใช้คีย์นี้จะถูกปฏิเสธด้วย application_key_not_accepted ส่วนคำขอที่กำลังทำงานอยู่จะทำงานต่อจนเสร็จ คีย์ที่ถูกเพิกถอนแล้วกู้คืนไม่ได้
ใช้ล่าสุด#
รายการคีย์แสดงเวลาที่แต่ละคีย์ส่งคำขอถึงโมเดลครั้งล่าสุด การตรวจสอบคีย์โดยไม่ได้ส่งคำขอจะไม่นับ
จัดการคีย์ด้วยโค้ด#
ทีมแพลตฟอร์มสร้าง แสดงรายการ และเพิกถอนคีย์ได้ผ่าน /v1/gateway/keys ด้วยโทเค็นของผู้ดูแลเวิร์กสเปซ เช่น เพื่อให้นักพัฒนาแต่ละคนมีคีย์ของตัวเอง การเรียกเหล่านี้บันทึกเหตุการณ์ตรวจสอบเหมือนคอนโซล (gateway.api_key_created, gateway.api_key_revoked) โดยระบุช่องทางเป็น API ความลับจะส่งกลับเพียงครั้งเดียวในคำตอบของการเรียกสร้างคีย์