Token Plan (รุ่นสำหรับทีม)
ห้ามใช้เป็นสิทธิ์ในการเรียกใช้โดยตรงแบบครอบคลุมทั้งหมด (blanket direct-call entitlement) — ให้ใช้เส้นทาง API ทั่วไปสำหรับการทดสอบและการผสานรวมแอปพลิเคชัน
การจับคู่เครื่องมือ + โมเดล
Postman / cURL พร้อมการใช้งาน API ผ่าน Alibaba Model Studio
เส้นทางการทดสอบ API สำหรับการตรวจสอบคำขอ หัวข้อ ข้อมูล และพฤติกรรมของจุดสิ้นสุดของ Model Studio
Postman และ cURL มีประโยชน์ในการตรวจสอบรูปแบบคำขอ (request shape), หัวข้อ (headers) และพฤติกรรมของโมเดล แต่เป็นเพียง 'พื้นผิวการเรียกใช้ API โดยตรง' ไม่ใช่ตัวแทนการเขียนโค้ดแบบโต้ตอบ (interactive coding agents)
เลือกเส้นทางการเข้าถึงที่เหมาะสม
เลือกเส้นทางการเข้าถึงที่เหมาะสม
ใช้คีย์ pay-as-you-go Model Studio แบบทั่วไป API คู่กับ Regional Endpoint ที่สอดคล้องกัน Alibaba แนะนำอย่างชัดเจนว่าไม่ควรเรียกใช้งาน Coding Plan จาก Postman
แนะนำPay-as-you-go Model Studio API
Coding Plan
Alibaba ระบุอย่างชัดเจนว่าไม่แนะนำให้ใช้ Postman และห้ามใช้สถานการณ์ API แบบไม่โต้ตอบ
Pay-as-you-go Model Studio API
เส้นทางที่เหมาะสมสำหรับการตรวจสอบ API ด้วยตนเอง สคริปต์ การทดสอบรวม (integration tests) และการพัฒนาฝั่ง backend
รูปแบบการกำหนดค่าที่ปลอดภัย
ทดสอบ endpoint ทั่วไปของ Model Studio ที่รองรับ OpenAI
ตัวอย่างนี้ถูกเซ็นเซอร์ไว้โดยเจตนา โปรดแทนที่ตัวแปรสถานที่ (placeholders) เฉพาะบนอุปกรณ์ของคุณเท่านั้น และห้ามวางคีย์ API จริงลงใน Nfero เด็ดขาด
สิ่งที่ต้องทำก่อนเริ่ม
- สร้างคีย์ API ทั่วไปของ Model Studio ในภูมิภาคที่ใช้งานจริง
- เลือกโมเดลที่รองรับ ซึ่งอยู่ในภูมิภาคเดียวกันและรองรับโปรโตคอล API
- จัดเก็บคีย์ไว้ใน Postman secret / current value หรือตัวแปรสภาพแวดล้อม (environment variable)
- ตั้งค่าการแจ้งเตือนด้านการเรียกเก็บเงินก่อนทำการร้องขอซ้ำหรืออัตโนมัติ
รูปแบบการกำหนดค่าที่ปลอดภัย
- โปรโตคอล
- OpenAI-compatible Model Studio API
- ใช้ endpoint ทั่วไปของภูมิภาค ซึ่งระบุไว้ในเอกสารอ้างอิง URL พื้นฐานของ Alibaba
- ส่งคีย์ผ่านหัวข้อ Authorization โดยไม่แสดงผล (printing) หรือบันทึกลงในระบบควบคุมเวอร์ชัน (committing)
- เริ่มต้นด้วยพรอมต์สั้นๆ และจำกัดจำนวนผลลัพธ์ (output limit) ให้น้อย
- ย้ายโค้ดสำหรับการใช้งานจริงไปเก็บคีย์ไว้ในระบบจัดเก็บความลับฝั่งเซิร์ฟเวอร์ (server-side secret storage) หลังจากยืนยันว่าคำขอทำงานได้ถูกต้องแล้ว
ตรวจสอบการเชื่อมต่อ
- ยืนยันว่าภูมิภาคของคีย์ตรงกับจุดเชื่อมต่อ
- ตรวจสอบสถานะการตอบกลับ (response status), รหัสคำขอ (request ID), ID ของโมเดล และฟิลด์การใช้งาน (usage fields)
- ตรวจสอบให้แน่ใจว่าคอลเลกชัน Postman ที่ส่งออกไม่มีค่าความลับ (secret values) ปัจจุบันอยู่ภายใน
- ยืนยันว่า endpoint นั้นเป็น Model Studio ทั่วไป — ไม่ใช่ URL เฉพาะแผน (plan-specific URL)
การจับคู่โมเดล
โมเดลเริ่มต้นที่แนะนำ
ใช้ เครื่องมือนี้ เพื่อทำงานด้านการเขียนโค้ดแบบโต้ตอบ วิเคราะห์ ตรวจสอบ และจัดทำเอกสารกับ แต่ละโมเดล ยืนยันความพร้อมของโมเดลใน Alibaba Cloud และการสนับสนุนแผนที่แน่นอนก่อนการใช้งานในสภาพแวดล้อมจริง.
Qwenqwen3.7-plus
การสร้างข้อความการคิดวิเคราะห์การเข้าใจภาพ
มุมมองที่ดีที่สุดในการจับคู่
เส้นทางโมเดลทั่วไปในปัจจุบัน — โปรดยืนยันว่ามีให้บริการในภูมิภาคที่คีย์นั้นใช้งานอยู่
Qwenqwen3.6-flash
การสร้างข้อความการคิดวิเคราะห์การเข้าใจภาพ
มุมมองที่ดีที่สุดในการจับคู่
ตัวเลือกที่มีประสิทธิภาพสำหรับการทดสอบรูปแบบคำขอ (request-shape tests) และการตรวจสอบการผสานรวมพื้นฐาน
ปัญหาทั่วไป
ปัญหาทั่วไป
สิ่งที่คุณเห็น
401 คีย์ API ไม่ถูกต้อง
สาเหตุที่เป็นไปได้
คีย์หาย ถูกตัดทอน หรือมาจากแผน/ภูมิภาคอื่น
ควรดำเนินการอย่างไร
ใช้คีย์ทั่วไปจาก Model Studio ภูมิภาคและ workspace เดียวกันกับ endpoint ที่ใช้งาน
สิ่งที่คุณเห็น
แผนถูกระงับโดยไม่คาดคิด หรือคีย์ถูกบล็อก
สาเหตุที่เป็นไปได้
ใช้คีย์ Coding Plan หรือ Token Plan สำหรับการเรียกใช้ API โดยตรงหรือแบบอัตโนมัติ
ควรดำเนินการอย่างไร
แทนที่ด้วยคีย์ pay-as-you-go Model Studio API ทั่วไป
ข้อจำกัดที่สำคัญ
- ห้ามวางคีย์จริงลงใน Nfero, คอลเลกชันสาธารณะ, ประวัติคำสั่งที่ตั้งใจจะแชร์ หรือระบบควบคุมเวอร์ชัน (source control)
- ห้ามใช้ข้อมูลรับรอง (credentials) ประเภท Coding Plan หรือ Token Plan สำหรับสคริปต์โดยตรง การทดสอบแบบแบตช์ (batch tests) หรือการเรียกใช้ฝั่ง backend
- ใช้ค่าจำกัดต่ำ (low limits) และการแจ้งเตือนด้านการเรียกเก็บเงินขณะตรวจสอบพฤติกรรมของคำขอ