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

แคตตาล็อกและการกำหนดผลิตภัณฑ์

ค้นหา version ของผลิตภัณฑ์ที่เผยแพร่แล้ว และตัดสินใจว่าโปรเจกต์ใดเรียกใช้ได้ — สองการกระทำที่แยกจากกัน

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

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

แคตตาล็อก#

สมาชิกขององค์กรที่ลงชื่อเข้าใช้ทุกคนเลือกดูแคตตาล็อกขององค์กรได้ มันแสดง version ของผลิตภัณฑ์ที่เผยแพร่แล้วและแก้ไขไม่ได้: ผลิตภัณฑ์ที่แพลตฟอร์มเผยแพร่ บวกกับผลิตภัณฑ์ที่องค์กรของคุณเองยื่นและได้รับอนุมัติ — ผลิตภัณฑ์เหล่านั้นเป็นส่วนตัวขององค์กรคุณ แต่ละรายการเป็น version ที่ตรึงไว้พร้อมราคาที่ตรึงไว้ ไม่ว่าจะเป็นราคาคงที่ต่อคำขอ หรืออัตราแยกสำหรับ input และ output ต่อหนึ่งล้าน token

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

ผลิตภัณฑ์แซนด์บ็อกซ์ที่เป็นส่วนตัวของโปรเจกต์ไม่เคยปรากฏในแคตตาล็อกหรือใน /v1/models — มันเป็นของโปรเจกต์เดียวและเข้าถึงผ่านโปรเจกต์นั้น

การกำหนดผลิตภัณฑ์ให้โปรเจกต์#

Owner หรือ Administrator ขององค์กร เป็นผู้กำหนดผลิตภัณฑ์ และการกำหนดระบุ version ที่เผยแพร่แล้วเพียง version เดียวอย่างแน่นอน — version นั้นและราคาของมันถูกยอมรับสำหรับโปรเจกต์นั้น หนึ่งครั้ง อย่างชัดแจ้ง ไม่มีสวิตช์ระดับองค์กร

กฎสามข้อทำให้การกำหนดผลิตภัณฑ์คาดเดาได้:

  • การกำหนดเป็นรายโปรเจกต์ และไม่มีอะไรไหลต่อ การกำหนดผลิตภัณฑ์ให้โปรเจกต์หนึ่งไม่ได้รวมทีมของมัน สมาชิกของมัน หรือโปรเจกต์พี่น้องเข้าไปด้วย รายการโปรเจกต์ที่เรียกผลิตภัณฑ์หนึ่งได้คือรายการการกำหนดนั่นเอง
  • การยกเลิกการกำหนดมีผลทันที การเรียกครั้งถัดไปถูกปฏิเสธ ส่วน reservation ที่ถือไว้แล้วสำหรับการเรียกที่กำลังทำงานอยู่ยังคงตัดบัญชีตามที่บันทึกไว้ — ยอดที่ถือไว้ไม่เคยถูกทิ้งค้างเพราะการถอนการกำหนด
  • การกำหนดตรึง version ไว้ หากมีการเผยแพร่ version ใหม่ของผลิตภัณฑ์ การกำหนดที่มีอยู่จะไม่ตามไป — การย้ายไป version ใหม่เป็นการกำหนดใหม่โดยเจตนา
GET/api/v2/tenants/{tenantID}/catalogue
GET/api/v2/tenants/{tenantID}/projects/{projectID}/products
POST/api/v2/tenants/{tenantID}/projects/{projectID}/products
GET/api/v2/tenants/{tenantID}/product-assignments?projectId=
การ subscribe โปรเจกต์เข้ากับผลิตภัณฑ์จากเมนูของแถว — การยอมรับราคาที่ตรึงไว้จะเปิดใช้สิทธิ์ให้ทั้งโปรเจกต์

เวิร์กสเปซส่วนบุคคลไม่ต้องกำหนดผลิตภัณฑ์#

เวิร์กสเปซส่วนบุคคลมีข้อยกเว้นหนึ่งข้อ: managed project ของมันผูกกับผลิตภัณฑ์ที่เรียกใช้ได้ทุกตัวที่เวิร์กสเปซมองเห็นโดยอัตโนมัติ ไม่มีขั้นตอนการกำหนด และการผูกนี้เอาออกไม่ได้ ลงชื่อเข้าใช้ เติมเงิน แล้วเรียกใช้ได้เลย

สิ่งที่ผู้เรียกเห็น#

เมื่อไม่มีสิทธิ์เข้าถึง การปฏิเสธจะกลับมาก่อนที่เงินจะเคลื่อนไหว:

ข้อผิดพลาด เกิดที่ ความหมาย วิธีแก้
403 product_not_assigned playground ผลิตภัณฑ์เรียกใช้ได้ในองค์กร แต่ยังไม่ถูกกำหนดให้โปรเจกต์ที่ระบุ ให้ Owner หรือ Administrator กำหนดให้
404 model_not_found คีย์ API id นั้นใช้กับโปรเจกต์ของคีย์ไม่ได้ในขณะนี้ รวมถึงกรณีที่การกำหนดถูกถอนไป ตรวจ /v1/models; ขอให้กำหนดผลิตภัณฑ์
403 key_scope คีย์ API resource ใช้ได้ แต่รายการของคีย์เองไม่รวมมันไว้ ใช้คีย์ที่มีรายการนั้น
402 insufficient_budget ทั้งสองแบบ กระเป๋าเงินของโปรเจกต์ครอบคลุม reservation ไม่ได้ เติมเงิน

การเรียกที่ถูกปฏิเสธไม่เคยถูกคิดเงิน ดู การใช้งานและการวัดปริมาณ สำหรับสิ่งที่ถูกบันทึกไว้

ถัดไป#