สอบถามรายการโมเดลแพลตฟอร์ม

สอบถามรายการโมเดลแพลตฟอร์ม

รองรับการสอบถามรายการโมเดลของแพลตฟอร์ม เมื่อส่ง 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 ข้อผิดพลาดของเซิร์ฟเวอร์