รับรายการโมเดล

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

API นี้จำกัดอัตราการเรียกที่ 60 ครั้ง/นาที ต่อบัญชี รายการโมเดลของแพลตฟอร์มไม่ได้เปลี่ยนแปลงบ่อย แนะนำให้แคชผลลัพธ์ไว้ฝั่งผู้เรียก

วิธีการร้องขอ

GET

URL สำหรับร้องขอ

https://api-${endpoint}.gptbots.ai/v1/model/list

การตรวจสอบสิทธิ์ในการร้องขอ

API นี้ใช้ DevKey / DevSecret ระดับบัญชี ส่งผ่าน HTTP Basic Authentication:

                      
                      Authorization: Basic base64(${DevKey}:${DevSecret})

                    

นำ DevKey และ DevSecret มาต่อกันด้วยเครื่องหมายทวิภาค (:) แล้วเข้ารหัสทั้งหมดด้วย Base64 และเติม Basic ไว้ด้านหน้า (โปรดสังเกตว่ามีช่องว่างหนึ่งช่อง)

วิธีรับ DevKey / DevSecret: เข้าสู่ระบบคอนโซล ไปที่ ศูนย์ส่วนตัว - บัญชี - ข้อมูลนักพัฒนา จะพบรหัสประจำตัวนักพัฒนา (DevKey) และ API DevSecret

⚠️ โปรดอย่าสับสนกับการตรวจสอบสิทธิ์ระดับ Agent: API เช่น API สนทนาใช้ API Key ของ Agent (Authorization: Bearer ${API Key}) ในการตรวจสอบสิทธิ์ ส่วน API นี้ใช้ DevKey / DevSecret ของบัญชีร่วมกับการตรวจสอบสิทธิ์แบบ Basic ทั้งสองแบบใช้แทนกันไม่ได้

Base64 เป็นการเข้ารหัสแบบย้อนกลับได้ ไม่ใช่การเข้ารหัสลับ โปรดปฏิบัติต่อสตริงที่เข้ารหัสแล้วเช่นเดียวกับรหัสผ่านแบบข้อความธรรมดา อย่า commit ลงในคลังโค้ดหรือเขียนลงในเอกสารสาธารณะ

การร้องขอ

ตัวอย่างการร้องขอ

                      
                      curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/model/list' \
-H 'Authorization: Basic ${base64(DevKey:DevSecret)}'

                    

ส่วนหัวของการร้องขอ

พารามิเตอร์ของการร้องขอ

ไม่มี

การตอบกลับ

ตัวอย่างการตอบกลับ

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "CHAT": {
      "OPEN_AI": [
        { "aiModelVersion": "gpt-4o", "modelId": "65f2c1a8d3b4e5f601234567" },
        { "aiModelVersion": "gpt-3.5-turbo", "modelId": "65f2c1a8d3b4e5f601234568" }
      ],
      "ANTHROPIC_CLAUDE": [
        { "aiModelVersion": "claude-opus-4-8", "modelId": "65f2c1a8d3b4e5f601234569" }
      ]
    },
    "EMBEDDING": {
      "OPEN_AI_EMB": [
        { "aiModelVersion": "text-embedding-3-large", "modelId": "65f2c1a8d3b4e5f60123456a" }
      ]
    },
    "RERANK": { },
    "SPEECH2TEXT": { },
    "TEXT2SPEECH": { },
    "MODERATION": { },
    "ANONYMIZATION": { }
  }
}

                    

การตอบกลับเมื่อสำเร็จ

โครงสร้างสองระดับของ data

                      
                      data
 └── ความสามารถของโมเดล     คีย์ชั้นนอก 7 ประเภท ลำดับคงที่
      └── ผู้ให้บริการโมเดล    คีย์ชั้นใน เช่น OPEN_AI
           └── [ รายการโมเดล ]

                    

คีย์ชั้นนอกคือความสามารถของโมเดล กำหนดตายตัวเป็น 7 ประเภทต่อไปนี้ และส่งกลับตามลำดับนี้เสมอ:

คีย์ชั้นในคือตัวระบุผู้ให้บริการโมเดล ยกตัวอย่าง CHAT ค่าที่อาจปรากฏได้แก่ OPEN_AI, AZURE, ANTHROPIC_CLAUDE, GEMINI, ALI_QWEN, DEEP_SEEK, KIMI, META_LLAMA, MISTRAL, ZHIPU_CHATGLM, HUNYUAN, ERINE, XAI_GROK, BYTEDANCE_SEED, SENSE เป็นต้น ความสามารถอื่นจะมีตัวระบุผู้ให้บริการต่างออกไป (เช่น EMBEDDING มี OPEN_AI_EMB, JINA_EMB เป็นต้น)

• หากความสามารถใดยังไม่มีโมเดลที่พร้อมใช้งาน ค่าของมันจะเป็นออบเจ็กต์ว่าง {} โดยคีย์จะยังคงปรากฏและไม่ถูกละเว้น โปรดตรวจสอบว่าว่างหรือไม่ก่อนวนซ้ำ
• แพลตฟอร์มอาจเพิ่มหรือยกเลิกผู้ให้บริการได้ โปรดยึดตามข้อมูลที่ API ส่งกลับจริง อย่าฮาร์ดโค้ดรายชื่อผู้ให้บริการลงในโค้ด
• ผู้ให้บริการและโมเดลเรียงตามลำดับความสำคัญในการแสดงผลที่แพลตฟอร์มกำหนด ลำดับนี้ใช้เพื่อการแสดงผลเท่านั้น อย่านำไปใช้เป็นตรรกะทางธุรกิจ (เช่น "ตัวแรกคือโมเดลเริ่มต้น")

การตอบกลับเมื่อเกิดข้อผิดพลาด

รหัสข้อผิดพลาด