สอบถามรายการโมเดลแพลตฟอร์ม
สอบถามรายการโมเดลแพลตฟอร์ม
รองรับการสอบถามรายการโมเดลของแพลตฟอร์ม เมื่อส่ง ID ขององค์กรมาด้วยจะสามารถสอบถามโมเดลที่องค์กรนั้นใช้งานได้จริง
คุณสามารถใช้อินเทอร์เฟซนี้เพื่อสอบถามรายการโมเดลของแพลตฟอร์ม เมื่อส่ง org_id มาด้วยจะคืนโมเดลที่องค์กรนั้นใช้งานได้จริง รวมถึงโมเดลที่องค์กรกำหนดค่าเอง
วิธีการร้องขอ
GET
URL สำหรับร้องขอ
https://api.${endpoint}/v1/model/list
การยืนยันตัวตนในการร้องขอ
ใช้การยืนยันตัวตนแบบ Basic ด้วย DevKey / DevSecret ระดับบัญชี
การร้องขอ
ตัวอย่างการร้องขอ
curl -X GET 'https://api.${endpoint}/v1/model/list?org_id=p-xxxx&agent_type=LOOP_AGENT' \
-H 'Authorization: Basic ${BASIC_TOKEN}'
curl -X GET 'https://api.${endpoint}/v1/model/list?org_id=p-xxxx&agent_type=LOOP_AGENT' \
-H 'Authorization: Basic ${BASIC_TOKEN}'
บล็อกโค้ดนี้ในหน้าต่างลอย
Header สำหรับร้องขอ
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
| Authorization | Basic ${BASIC_TOKEN} | Basic Token ที่ได้จากการเข้ารหัส Base64 ของ DevKey:DevSecret |
พารามิเตอร์การร้องขอ (Query Parameters)
| พารามิเตอร์ | ประเภท | คำอธิบาย | required |
|---|---|---|---|
| org_id | String | ID ขององค์กร เมื่อส่งมาจะตรวจสอบสถานะการเป็นสมาชิกองค์กร และคืนโมเดลที่องค์กรใช้งานได้ | true |
| agent_type | String | ประเภท Agent รองรับ AGENT, FLOW_AGENT, LOOP_AGENT, WORKFLOW; |
true |
การตอบกลับ
ตัวอย่างการตอบกลับ
{
"code": 0,
"message": "OK",
"data": {
"CHAT": {
"OPEN_AI": [
{
"model_name": "GPT-4o",
"aiModelVersion": "gpt-4o",
"modelId": "mv-xxxx",
"capabilities": ["pluginSupport", "ImageRecognition", "jsonSchema"]
}
]
}
}
}
{
"code": 0,
"message": "OK",
"data": {
"CHAT": {
"OPEN_AI": [
{
"model_name": "GPT-4o",
"aiModelVersion": "gpt-4o",
"modelId": "mv-xxxx",
"capabilities": ["pluginSupport", "ImageRecognition", "jsonSchema"]
}
]
}
}
}
บล็อกโค้ดนี้ในหน้าต่างลอย
การตอบกลับเมื่อสำเร็จ
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
| model_name | String | ชื่อที่แสดงของโมเดล |
| aiModelVersion | String | ชื่อเวอร์ชันของโมเดล |
| modelId | String | ID เวอร์ชันของโมเดล ใช้เมื่ออินเทอร์เฟซอื่นอ้างอิงถึงโมเดล |
| capabilities | String[] | รายการความสามารถของโมเดล |
การตอบกลับเมื่อผิดพลาด
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
| code | Integer | รหัสข้อผิดพลาด |
| message | String | รายละเอียดข้อผิดพลาด |
รหัสสถานะ
| รหัสสถานะ | คำอธิบาย |
|---|---|
| 200 | สำเร็จ |
| 400 | พารามิเตอร์ไม่ถูกต้อง |
| 401 | ไม่ได้รับอนุญาต |
| 403 | สิทธิ์ไม่เพียงพอ |
| 429 | คำขอถี่เกินไป |
| 500 | ข้อผิดพลาดของเซิร์ฟเวอร์ |
