AI Gridเอกสาร
สมัครใช้งาน

ภาพรวม

ปลายทางรันไทม์ การยืนยันตัวตน ชนิดการตอบกลับ และข้อผิดพลาด — ภาพรวมของ API สาธารณะ

อัปเดต 10 ก.ย. 2026

ทราฟฟิกรันไทม์ทั้งหมดไปยังโฮสต์เดียว ไม่ว่าโปรเจกต์ของคุณจะใช้ผลิตภัณฑ์ใด:

POSThttps://api.aigridapp.com/v1/chat/completions
GEThttps://api.aigridapp.com/v1/models
POSThttps://api.aigridapp.com/v1/sandbox/{id}/invoke
POSThttps://api.aigridapp.com/v1/sandbox/{id}/mcp
POSThttps://api.aigridapp.com/v1/embeddings
POSThttps://api.aigridapp.com/v1/rerank
POSThttps://api.aigridapp.com/v1/images
POSThttps://api.aigridapp.com/v1/images/generations
POSThttps://api.aigridapp.com/v1/audio/speech
POSThttps://api.aigridapp.com/v1/audio/transcriptions
POSThttps://api.aigridapp.com/v1/videos
GEThttps://api.aigridapp.com/v1/videos/{videoID}
GEThttps://api.aigridapp.com/v1/videos/{videoID}/content
  • Chat completions คือปลายทางที่เข้ากันได้กับ OpenAI ซึ่งคุณจะเรียกใช้บ่อยที่สุด — ดู การเติมข้อความในแชต
  • Models แสดงรายการที่คีย์ของคุณเรียกใช้ได้ในขณะนี้ — ดู โมเดล
  • Sandbox invoke และ MCP endpoint ใช้รันผลิตภัณฑ์แซนด์บ็อกซ์ส่วนตัวของโปรเจกต์ — ดู Sandbox products
ทัวร์ชม API reference: รายการ endpoint แผง Call this model ของโมเดล และการอ่าน error envelope

การยืนยันตัวตน#

ทุกคำขอส่ง bearer key (aig_…) คีย์หนึ่งผูกกับ หนึ่งโปรเจกต์เท่านั้น ตั้งแต่สร้าง และโปรเจกต์นั้นคือบริบทการดำเนินการและการคิดค่าใช้จ่ายของทุกการเรียก คำขอไม่เลือกโปรเจกต์ใหม่ในแต่ละครั้ง: เฮดเดอร์ตัวเลือกทำได้เพียงระบุซ้ำโปรเจกต์ที่ผูกไว้ และจะถูกปฏิเสธหากไม่ตรงกัน ดู การยืนยันตัวตน

ความเข้ากันได้#

ปลายทางแชตใช้ความหมายแบบ OpenAI: รูปแบบคำขอและการตอบกลับ การสตรีม (text/event-stream) และฟิลด์ tool call ทำงานตามที่ SDK เดิมของคุณคาดไว้ หากโค้ดของคุณเรียก OpenAI API อยู่แล้ว โดยทั่วไปเปลี่ยนเพียง base_url และคีย์ก็ย้ายมาใช้ Grid ได้

Grid ตั้งใจเข้มงวดกว่าในจุดหนึ่ง: ฟิลด์คำขอที่ไม่รู้จัก จะถูกปฏิเสธด้วย 422 unsupported_parameter แทนการทิ้งเงียบ ๆ

ข้อผิดพลาดเป็น JSON เสมอ#

การตอบกลับข้อผิดพลาดของ API ใช้ JSON envelope ชนิดของการตอบกลับที่สำเร็จขึ้นอยู่กับปลายทาง: แชตทั่วไปเป็น JSON แชตแบบสตรีมใช้ text/event-stream speech ส่งกลับเสียง และ video content ส่งกลับสื่อ ใช้ปลายทางที่ผลิตภัณฑ์เลือกไว้รองรับ และตรวจ Content-Type ของการตอบกลับ

รายละเอียด envelope และรหัสที่ควรใช้ในโค้ดอยู่ที่ ข้อผิดพลาด

json
{ "error": { "code": "model_not_found", "message": "…", "requestId": "…" } }

รหัส invocation#

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

ขั้นตอนถัดไป#