สิ่งที่คุณกำลังตั้งค่า
Cursor เป็นโปรแกรมแก้ไขที่รองรับผู้ให้บริการโมเดลแบบกำหนดเอง หากคุณระบุ base URL รูปแบบ OpenAI คีย์ และชื่อโมเดลให้ Cursor จะส่งคำขอแชทไปยังที่ที่คุณระบุแทนผู้ให้บริการเริ่มต้น บริการนี้รองรับโปรโตคอล: POST /v1/chat/completions พร้อมการตรวจสอบสิทธิ์แบบ Bearer และ GET /v1/models
สองประเด็นสำคัญที่ต้องเข้าใจล่วงหน้า บริการนี้เป็น API อิสระที่รันโมเดลแบบ open-weight เพียงโมเดลเดียว ไม่ใช่ Codex ของ OpenAI และไม่ใช่ผลิตภัณฑ์อย่างเป็นทางการของ Cursor นอกจากนี้ หน้าจอตั้งค่าของ Cursor มีการเปลี่ยนแปลงบ่อย ดังนั้นตำแหน่งของป้ายกำกับด้านล่างอาจแตกต่างไปเล็กน้อยในเวอร์ชันของคุณ ค่าสามค่าที่ไม่เปลี่ยนแปลงคือ base URL, คีย์ และชื่อโมเดล
ขั้นตอนที่ 1: รับคีย์และทดสอบนอก Cursor
สมัครบน หน้าคีย์ API ด้วย Google หรือด้วยอีเมลและรหัสผ่าน บัญชีใหม่สามารถขอเครดิตทดลองใช้ $0.50 ได้ด้วยการคลิกหนึ่งครั้ง ใช้ได้ 7 วัน ไม่ต้องใช้บัตร นั่นเพียงพอสำหรับการทดสอบการตั้งค่า editor
ก่อนแตะต้อง Cursor ให้ยืนยันว่าคีย์ใช้งานได้ ความล้มเหลวภายในโปรแกรมแก้ไขจะอ่านยากกว่าความล้มเหลวในเทอร์มินัล
curl https://api.getcodexapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a Python function that reverses a string."}]
}'หากคุณได้รับคำตอบเป็น JSON ที่มีโค้ด ให้ดำเนินการต่อ หากได้รับข้อผิดพลาด ให้แก้ไขที่นี่ก่อน สาเหตุทั่วไปคือคีย์ขาดอักขระบางตัว หรือมีช่องว่างที่คัดลอกมาต่อท้าย
ขั้นตอนที่ 2: กำหนดค่า Cursor
- เปิดการตั้งค่าของ Cursor และไปที่ส่วนโมเดล
- ค้นหาช่องสำหรับคีย์ API ของ OpenAI แล้ววางคีย์ของคุณ เพิ่มชื่อโมเดล uncensored แล้วตรวจสอบ รวมค่าใช้จ่ายและขีดจำกัดจากบริการนี้
- เปิดตัวเลือกเพื่อแก้ไข base URL ของ OpenAI และป้อน
https://api.getcodexapi.com/v1 - เพิ่มโมเดลที่กำหนดเองและพิมพ์ชื่อที่ถูกต้องคือ
uncensored - กดปุ่มตรวจสอบ (verify) หากมี จากนั้นเปิดแผงแชทและเลือก
uncensoredจากรายการโมเดล
หากขั้นตอนการตรวจสอบรายงานความล้มเหลว ให้ตรวจสอบสามสิ่งตามลำดับ: base URL ลงท้ายด้วย /v1 โดยไม่มีเส้นทาง endpoint ต่อท้าย, คีย์ถูกวางโดยไม่มีช่องว่างต่อท้าย และชื่อโมเดลไม่มีตัวพิมพ์ใหญ่ คู่มือในหน้า docs แสดงค่าเดียวกันพร้อมตัวอย่างไคลเอนต์เพิ่มเติม
สิ่งที่ต้องวางแผน: การแก้ไขเป็นค่าตั้งค่า ไม่ใช่ตัวเลือกต่อโมเดล ดังนั้นหากคุณใช้คีย์ OpenAI ของคุณเองใน Cursor ที่อื่น ให้ปิดการแก้ไขนี้ก่อน จดบันทึกสิ่งที่คุณเปลี่ยนแปลงไว้
หลังจากบันทึกแล้ว ให้ถามโมเดลคำถามเกี่ยวกับการเขียนโค้ดง่ายๆ ในแชท และสังเกตคำตอบ คำตอบครั้งแรกที่ช้าเป็นเรื่องปกติขณะที่ Cursor กำลังสร้างคำขอ หากได้รับคำตอบ แสดงว่าคุณเชื่อมต่อแล้ว และขั้นตอนถัดไปคือลองใช้งานจริงในรีโพสิตอรีของคุณ
สิ่งที่จะและไม่ผ่านคีย์ของคุณ
Cursor ผสมผสานฟีเจอร์หลายอย่าง คำขอแชทและแก้ไขแบบ inline เป็นฟีเจอร์ที่มีแนวโน้มสูงสุดที่จะใช้โมเดลกำหนดเองของคุณเมื่อคุณเลือกแล้ว ฟีเจอร์อื่นๆ เช่น การเติมข้อความอัตโนมัติ (tab completion) ในอดีตใช้โมเดลที่ Cursor รันเอง และฟีเจอร์สไตล์เอเจนต์อาจขึ้นอยู่กับวิธีการจัดการเครื่องมือของ Cursor วิธีที่ตรงไปตรงมาที่สุดในการทราบคือลองใช้ฟีเจอร์ที่คุณพึ่งพาและตรวจสอบยอดเงินของคุณ
ทำได้ง่ายมาก: ทุกการตอบกลับจาก API นี้มีเฮดเดอร์ X-Balance-USD และยอดเงินของคุณจะมองเห็นได้ในบัญชีของคุณ หากคุณส่งข้อความแชทแล้วยอดเงินไม่เปลี่ยนแปลง แสดงว่าคำขอนั้นไม่ได้ส่งมายังเรา
การเรียกใช้ฟังก์ชันรองรับที่เอนด์พอยต์นี้ (tools, tool_choice, สตรีมมิง tool_calls และผลลัพธ์เป็น role: "tool") ซึ่งจำเป็นสำหรับเอเจนต์ editor การสตรีมมิงทำงานผ่าน server-sent events ด้วย stream: true หน้าต่างบริบทคือ 100,000 โทเคน รวมพรอมต์และ completion ดังนั้นไฟล์ขนาดใหญ่พร้อมเพื่อนบ้านจึงพอดีกับคำขอหนึ่งคำขอ
เหตุผลที่ใช้โมเดลแบบไม่เซ็นเซอร์ในโปรแกรมแก้ไข
งานเขียนโค้ดส่วนใหญ่ไม่ถูกปฏิเสธ เมื่อเกิดขึ้น มักเป็นงานที่ถูกต้องตามกฎหมายแต่ดูเสี่ยงต่อตัวกรองที่ระมัดระวัง: การเขียนโปรแกรมสแกนพอร์ตสำหรับเครือข่ายของคุณเอง การแยกวิเคราะห์ตัวอย่างมัลแวร์ที่คุณกำลังตรวจสอบ การสร้างข้อมูลทดสอบที่มีคำหยาบคาย การสร้างแบ็กเอนด์สำหรับแอปบทบาทสมมติหรือแอปเพื่อน companion สำหรับผู้ใหญ่ หรือการรีแฟกเตอร์โค้ดที่จัดการกับการกลั่นกรองเนื้อหา โมเดลนี้ปรับแต่งให้ตอบกลับโดยไม่มีการปฏิเสธเนื้อหาสำหรับการใช้งานผู้ใหญ่ที่ถูกต้องตามกฎหมาย
นี่เป็นโมเดลแบบเปิดน้ำหนักทั่วไปหนึ่งตัว ไม่ใช่โมเดลเฉพาะทางสำหรับโค้ด และไม่มีสิ่งใดรับประกันว่าจะทำงานเหนือกว่าทางเลือกเฉพาะใดๆ ในโค้ดเบสของคุณ นำงานของคุณไปรันผ่านโมเดลนี้ กฎหนึ่งข้อที่ตายตัวคือ: ไม่มีเนื้อหาทางเพศที่เกี่ยวข้องกับผู้เยาว์ และไม่สามารถเปลี่ยนแปลงได้
ต้นทุนในทางปฏิบัติ
ราคาอยู่ที่ $0.15 ต่อ 1M input tokens และ $0.50 ต่อ 1M output tokens โดยใช้จากเครดิตแบบเติมเงินล่วงหน้าโดยไม่ต้องสมัครสมาชิก การใช้งานใน editor มีลักษณะหนักไปทาง input เนื่องจากทุกคำขอจะส่งบริบทไฟล์กลับมา
คำขอที่มี input tokens 8,000 และ output tokens 1,000 มีต้นทุน input เท่ากับ 8,000 x $0.15 / 1,000,000 = $0.0012 และต้นทุน output เท่ากับ 1,000 x $0.50 / 1,000,000 = $0.0005 ซึ่งรวมเป็น $0.0017 หากคุณทำคำขอขนาดนั้น 150 ครั้งในวันหนึ่งๆ ต้นทุนจะเท่ากับ 150 x $0.0017 = $0.255 หรือประมาณ 26 เซนต์
คำขอที่ส่งบริบท 40,000 โทเคนและได้รับ 1,500 กลับมา มีค่าใช้จ่าย $0.006 + $0.00075 = $0.00675 การเติมเงินเริ่มต้นที่ $20 และเครดิตไม่หมดอายุ ดังนั้นจึงไม่มีความกดดันในการใช้ให้หมด ดู หน้าราคา สำหรับระดับโบนัส และ หน้า API การเขียนโค้ด สำหรับภาพรวมทั่วไป
ขีดจำกัดอัตราสำหรับการใช้งาน editor
คีย์แบบเต็มอนุญาตให้ทำคำขอพร้อมกัน (concurrent requests) ได้ 8 คำขอ และ 300 คำขอต่อนาที คีย์แบบทดลองอนุญาตให้ทำคำขอพร้อมกัน 2 คำขอ และ 60 คำขอต่อนาที คนเดียวที่พิมพ์ใน editor เดียวกันมักจะไม่เข้าใกล้ขีดจำกัดเหล่านี้ แต่ทีมที่แชร์คีย์เดียวกัน หรือเอเจนต์ที่ส่งคำขอพร้อมกันจำนวนมาก สามารถทำได้ เมื่อคุณเกินขีดจำกัด API จะส่ง HTTP 429 กลับมา ค่า rate_limited หมายถึงคำขอเกินต่อนาที และ concurrency หมายถึงคำขอเกินจำนวนพร้อมกัน หากบริการมีภาระเกินชั่วคราว คุณก็จะเห็น 429 พร้อม Retry-After: 5
แชทแบบสตรีมมิงจะยึดสล็อตการทำงานพร้อมกัน ไว้จนกว่าสตรีมจะสิ้นสุด สำหรับการใช้งานร่วมกัน ให้มอบคีย์เฉพาะให้กับนักพัฒนาแต่ละคนแทนที่จะใช้คีย์เดียวสำหรับทีม
รายการตรวจสอบการแก้ปัญหา
- ไม่พบโมเดล พิมพ์
uncensoredใหม่โดยไม่มีช่องว่าง ลบโมเดลกำหนดเองเก่าที่คุณไม่ได้ใช้ออก - ข้อผิดพลาดการตรวจสอบสิทธิ์ คัดลอกคีย์ใหม่ ตรวจสอบให้แน่ใจว่า Cursor ไม่ได้ใช้คีย์จากผู้ให้บริการรายอื่นอยู่
- การตอบหยุดเร็วเกินไป ตรวจสอบว่า Cursor ตั้งค่าขีดจำกัดเอาต์พุตของตัวเองหรือไม่ ทางเรา
max_tokensเป็นตัวเลือก - ยอดคงเหลือไม่เปลี่ยนแปลง ฟีเจอร์ที่คุณใช้ไม่ได้ถูกส่งผ่านคีย์กำหนดเองของคุณ ลองใช้แชทแทน
- พบ 429 บ่อยครั้ง ลดคำขอพร้อมกัน หรือใช้คีย์แบบเต็มแทนคีย์แบบทดลอง
