---
title: คีย์ API ของ Gateway
description: คีย์ Gateway เป็นของเวิร์กสเปซเดียวและแสดงครั้งเดียว คิดค่าใช้จ่ายกับแผนก จำกัดโมเดล ที่อยู่ และวันหมดอายุ เปลี่ยนคีย์แบบมีช่วงซ้อน หรือเพิกถอนได้
url: https://agentlab.cresclab.com/docs/th/gateway/keys
language: th
updated: 2026-10-23
---

# คีย์ 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 ไม่ได้

> [!WARNING] อย่าใช้คีย์ในเบราว์เซอร์
> Gateway ปฏิเสธคำขอที่มีเฮดเดอร์ `Origin` (`server_application_required`) ให้เรียกจากเซิร์ฟเวอร์ CLI หรือสคริปต์ และเก็บคีย์ไว้ในตัวแปรสภาพแวดล้อมหรือที่เก็บความลับ

## คิดค่าใช้จ่ายของคีย์กับแผนก

**การจัดสรรค่าใช้จ่าย** ของคีย์กำหนดว่าค่าใช้จ่ายจะนับกับงบของใคร ถ้าไม่เลือกแผนก ค่าใช้จ่ายจะนับกับเวิร์กสเปซเท่านั้น ถ้าเลือกตั้งแต่หนึ่งแผนกขึ้นไป ทุกคำขอที่ใช้คีย์นี้จะนับเต็มจำนวนกับเพดานของแต่ละแผนกที่เลือกด้วย การเปลี่ยนแปลงมีผลกับคำขอถัดไป ค่าใช้จ่ายที่บันทึกไปแล้วจะไม่ย้าย

## จำกัดสิ่งที่คีย์ทำได้

แต่ละรายการไม่บังคับ และคีย์ใหม่ไม่มีการตั้งค่าใดเลย

| การควบคุม              | สิ่งที่ทำ                                                                                                               |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| วันหมดอายุ             | หลังเวลานี้คีย์จะถือว่าถูกเพิกถอน คีย์ที่ใกล้หมดอายุที่สุดจะแสดงก่อน พร้อมจำนวนวันที่เหลือ                              |
| รายการโมเดลที่อนุญาต   | คำขอที่ระบุโมเดลอื่นจะถูกปฏิเสธด้วย `gateway_key_model_not_allowed` และ `auto` จะเลือกเฉพาะจากโมเดลในรายการ             |
| รายการที่อยู่ที่อนุญาต | ช่วง IP (CIDR) ได้สูงสุด 32 ช่วง คำขอจากที่อยู่อื่นจะถูกปฏิเสธเหมือนคีย์ไม่ถูกต้อง และบันทึกการปฏิเสธพร้อมที่อยู่นั้น   |
| ขีดจำกัดอัตรา          | จำนวนคำขอและโทเค็นต่อนาทีของคีย์นี้ ดู[ขีดจำกัดอัตรา](https://agentlab.cresclab.com/docs/th/gateway/limits.md#rate-limits) |
| เพดานคำขอพร้อมกัน      | จำนวนคำขอที่ทำงานพร้อมกันได้สูงสุด ค่าเริ่มต้นไม่มี Gateway รับคำขอแบบขนานได้เหมือนการเชื่อมต่อผู้ให้บริการโดยตรง       |

## เปลี่ยนคีย์

**เปลี่ยนคีย์** จะสร้างคีย์ใหม่ที่มีแผนก รายการที่อนุญาต และขีดจำกัดเหมือนเดิม และตั้งวันหมดอายุให้คีย์เดิมหลังช่วงใช้ซ้อนกันที่คุณเลือก (เช่น เจ็ดวัน) ระหว่างช่วงนี้ทั้งสองคีย์ใช้ได้ คุณจึงย้ายเครื่องมือแต่ละตัวไปใช้คีย์ใหม่ได้โดยไม่มีช่วงขาด คีย์ใหม่จะแสดงเพียงครั้งเดียว

## เพิกถอนคีย์

**เพิกถอน** หยุดคีย์ทันที คำขอถัดไปที่ใช้คีย์นี้จะถูกปฏิเสธด้วย `application_key_not_accepted` ส่วนคำขอที่กำลังทำงานอยู่จะทำงานต่อจนเสร็จ คีย์ที่ถูกเพิกถอนแล้วกู้คืนไม่ได้

## ใช้ล่าสุด

รายการคีย์แสดงเวลาที่แต่ละคีย์ส่งคำขอถึงโมเดลครั้งล่าสุด การตรวจสอบคีย์โดยไม่ได้ส่งคำขอจะไม่นับ

## จัดการคีย์ด้วยโค้ด

ทีมแพลตฟอร์มสร้าง แสดงรายการ และเพิกถอนคีย์ได้ผ่าน `/v1/gateway/keys` ด้วยโทเค็นของผู้ดูแลเวิร์กสเปซ เช่น เพื่อให้นักพัฒนาแต่ละคนมีคีย์ของตัวเอง การเรียกเหล่านี้บันทึกเหตุการณ์ตรวจสอบเหมือนคอนโซล (`gateway.api_key_created`, `gateway.api_key_revoked`) โดยระบุช่องทางเป็น API ความลับจะส่งกลับเพียงครั้งเดียวในคำตอบของการเรียกสร้างคีย์