ให้โมเดลแก่โปรเจกต์

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

การแยกกันนี้เป็นไปโดยเจตนา มันคือสิ่งที่ทำให้การใช้จ่ายระบุที่มาได้ และทำให้การเข้าถึงเป็นสิ่งที่ระบุชัด ไม่ใช่สิ่งที่สืบทอดกันมา

ก่อนเริ่ม#

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

1. ค้นหาโมเดล#

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

ป้าย N projects ของโมเดลบอกว่ามีกี่โปรเจกต์ที่มีโมเดลนั้นแล้ว

2. กำหนด version ที่แน่นอน#

ทำได้สองทาง ผลลัพธ์เดียวกัน:

จากหน้ารายละเอียดของโมเดล คลิก Assign to a project แล้วยืนยัน Accept rate and assign
จากแท็บ Products ของโปรเจกต์ คลิก Assign product

ไม่ว่าทางใด คุณกำลังยอมรับ version นั้นที่ราคานั้น สำหรับโปรเจกต์นั้น หนึ่งครั้ง อย่างชัดแจ้ง

หน้ารายละเอียดโมเดลที่มี Assign to a project และ Open in playground อยู่ในส่วนหัว — ระเบียนของโมเดล — **Assign to a project** ตรึง version และราคาที่แน่นอนนี้ไว้ให้โปรเจกต์หนึ่ง ส่วน **Open in playground** ใช้ตรวจสอบได้ในคลิกเดียวหลังจากนั้น

3. ยืนยันว่าเรียกใช้ได้#

แท็บ Products ของโปรเจกต์จะแสดงผลิตภัณฑ์พร้อม Version vN, Price และ Status เป็น Callable

เมื่อใช้คีย์ที่ผูกกับโปรเจกต์ GET /v1/models จะแสดงโมเดลนั้นแล้ว — endpoint นี้คืนค่าสิ่งที่คีย์เรียกได้พอดี จึงเป็นการทดสอบที่ตรงไปตรงมาที่สุด:

GET/v1/models

การลองในเพลย์กราวด์สั้น ๆ โดยเลือกโปรเจกต์ไว้ก็ใช้ได้เช่นกัน

ตรวจว่าสำเร็จแล้ว#

GET /v1/models แสดงโมเดลนั้น และการเรียกไปยังมันสำเร็จ แทนที่จะตอบ 403 product_not_assigned

หากยังไม่สำเร็จ#

สิ่งที่คุณเห็น	ความหมาย
`403 product_not_assigned`	โมเดลเผยแพร่แล้วและใช้ได้ แต่ยังไม่ถูกกำหนดให้โปรเจกต์ของคีย์นี้
`404 model_not_found`	id ที่เดาเอา โมเดลของโปรเจกต์อื่น หรือการกำหนดที่ถูกถอนไปแล้ว
`403 key_scope`	โมเดลถูกกำหนดแล้ว แต่รายการ Allowed resources ของคีย์นี้ไม่รวมมันไว้
`403 denied`	คุณไม่มีสิทธิ์ใช้งานบนโปรเจกต์ — การกำหนดผลิตภัณฑ์กับการเข้าถึงเป็นคนละเรื่อง
ไม่มีปุ่ม Assign product	คุณไม่ใช่ Owner หรือ Administrator

การยกเลิกการกำหนดมีผลทันที: การเรียกครั้งถัดไปถูกปฏิเสธ ส่วน reservation ที่ถือไว้แล้วสำหรับการเรียกที่กำลังทำงานอยู่ยังคงตัดบัญชีตามที่บันทึกไว้ จึงไม่มีอะไรค้างคา

ถัดไป#

ลองใช้โมเดลในเพลย์กราวด์ — ยืนยันได้ในคลิกเดียว
เชิญทีมของคุณ — ให้เพื่อนร่วมงานเรียกใช้ได้ด้วย
การเลือกดูแคตตาล็อกโมเดล — การอ่านหน้ารายละเอียดของโมเดลฉบับเต็ม