cursorapikey.com/คู่มือ
แก้ไขคีย์ API ของ Cursor ที่ไม่ทำงาน: ใช้เอนด์พอยต์แบบกำหนดเอง
เมื่อคีย์ API ของ Cursor ไม่ทำงาน สาเหตุมักจะเป็นหนึ่งในสี่สิ่งนี้: Base URL, ชื่อโมเดล, คีย์เอง หรือขีดจำกัดบนบัญชี คำสั่ง curl เพียงคำสั่งเดียวจะบอกคุณว่าข้อใดคือสาเหตุ
อัปเดต


ประเด็นสำคัญ
- ทดสอบคีย์นอก Cursor ก่อนด้วย curl; หาก curl ทำงานได้ ปัญหาอยู่ที่การตั้งค่าของ Cursor
- Base URL ต้องเป็น https://api.cursorapikey.com/v1 และชื่อโมเดลต้องเป็น uncensored อย่างถูกต้อง
- รหัส 401 หมายถึงคีย์ไม่ถูกต้อง, 404 หมายถึง URL ไม่ถูกต้อง, 429 หมายถึงเกินขีดจำกัดอัตราหรือจำนวนคำขอพร้อมกัน และข้อผิดพลาดของโมเดลหมายถึงชื่อโมเดลไม่ถูกต้อง
- ป้ายเมนูเปลี่ยนไประหว่างเวอร์ชันของ Cursor ดังนั้นให้จับคู่วัตถุประสงค์ของฟิลด์แทนที่จะเป็นคำพูดที่ตรงกัน
ขั้นตอนที่ 1: ทดสอบคีย์นอก Cursor
ตัด Cursor ออกไปจากสมการก่อน หากคำขอธรรมดาทำงานได้ แสดงว่าคีย์และบัญชีของคุณใช้งานได้ปกติ และปัญหาอยู่ที่การตั้งค่าโปรแกรมแก้ไข หากล้มเหลว เนื้อหาข้อผิดพลาดจะระบุปัญหา
curl -i https://api.cursorapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'
flag -i จะพิมพ์บรรทัดสถานะและส่วนหัว สถานะ 200 พร้อมอาร์เรย์ choices หมายถึงสำเร็จ ส่วนหัว X-Balance-USD แสดงเครดิตคงเหลือ ซึ่งเป็นสิ่งแรกที่ต้องตรวจสอบหากเกิดข้อผิดพลาดการยืนยันตัวตนหรือการชำระเงิน
คุณยังสามารถแสดงรายการโมเดล ซึ่งยืนยันคีย์โดยไม่เสียค่าใช้จ่ายใดๆ:
curl https://api.cursorapikey.com/v1/models -H "Authorization: Bearer YOUR_KEY" | grep uncensored
การตอบกลับควรมีรหัสโมเดล uncensored
ขั้นตอนที่ 2: ตั้งค่าฟิลด์ใน Cursor
เปิดการตั้งค่าของ Cursor และไปที่ส่วนโมเดล คุณต้องกรอกค่าสามค่า และความผิดพลาดในค่าใดค่าหนึ่งจะทำให้เกิดข้อผิดพลาดที่คล้ายกับการที่คีย์เสีย
- OpenAI API key: วางคีย์ของคุณโดยไม่มีช่องว่างหรือการขึ้นบรรทัดใหม่ที่ต้นหรือท้าย
- การแทนที่ Base URL: เปิดการแทนที่และป้อน
https://api.cursorapikey.com/v1เก็บ/v1ไว้และตัด/chat/completionsออก - Custom model: เพิ่มโมเดลชื่อ
uncensoredและเปิดใช้งาน ปิดโมเดลที่ไม่ได้ใช้เพื่อให้ Cursor ไม่เลือกโมเดลที่เอนด์พอยต์ไม่รู้จัก
หลังจากบันทึก ให้ใช้ตัวเลือก verify หากเวอร์ชันของคุณมี จากนั้นเลือก uncensored ใน dropdown chat model การเปิดแท็บแชทใหม่เป็นการทดสอบที่ดี เพราะแท็บเก่าอาจเก็บโมเดลเดิมไว้ การแนะนำทีละขั้นตอนใน วิธีใช้ Cursor API แสดงการตั้งค่าเดียวกันพร้อมบริบทเพิ่มเติม
จับคู่ข้อผิดพลาดกับการแก้ไข
| สิ่งที่คุณเห็น | สาเหตุที่เป็นไปได้ | การแก้ไข |
|---|---|---|
| 401, "คีย์ไม่ถูกต้อง", "ไม่ได้รับอนุญาต" | พิมพ์คีย์ผิด คีย์ถูกตัดทอน หรือถูกเพิกถอน | คัดลอกอีกครั้งจากหน้าคีย์; ตรวจสอบช่องว่างท้าย |
| 404, "not found" | URL ผิด, ขาด /v1 หรือ path ซ้ำ | ใช้ https://api.cursorapikey.com/v1 อย่างเดียว |
| "model not found" หรือคล้ายกัน | ชื่อโมเดลไม่ตรงกับ uncensored | เพิ่มโมเดลกำหนดเองด้วยชื่อนั้น ตัวพิมพ์เล็กทั้งหมด |
429 พร้อม rate_limited | เกินขีดจำกัดคำขอต่อนาที | ลดความเร็วลง; คีย์แบบทดลองอนุญาต 60 คำขอต่อนาที คีย์แบบเต็มอนุญาต 300 |
429 พร้อม concurrency | คำขอพร้อมกันมากเกินไป | ลดการรัน agent พร้อมกัน; ทดลอง 2, คีย์เต็ม 8 |
429 พร้อม Retry-After: 5 | โอเวอร์โหลดชั่วคราว | รอห้าวินาทีแล้วลองใหม่ |
| ทำงานใน curl แต่ล้มเหลวใน Cursor | การตั้งค่าไม่ถูกบันทึก โมเดลในแท็บผิด หรือฟีเจอร์ที่ไม่ใช้คีย์กำหนดเอง | ดูส่วนถัดไป |
คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน ดังนั้นการลองใหม่ขณะแก้ไขข้อผิดพลาดจึงไม่เสียค่าใช้จ่าย
เมื่อ curl ทำงานแต่ Cursor ยังล้มเหลว
นี่เป็นกรณีที่ทำให้สับสนที่สุด และมีคำอธิบายทั่วไปหลายอย่าง
เลือกโมเดลผิด Cursor เก็บโมเดลในตัวไว้ในรายการ หากเลือกโมเดลเหล่านี้ คำขอจะไม่ไปที่ endpoint ของคุณเลย ให้เลือก uncensored โดยตรงในรายการแบบเลื่อนลงของการสนทนาหรือตัวแต่งข้อความที่คุณใช้
ไม่ใช่ทุกฟีเจอร์ที่ใช้คีย์ของคุณ ฟีเจอร์ที่พึ่งพาโมเดลของ Cursor เช่น การเติมข้อความอัตโนมัติแบบ inline อาจยังคงใช้โมเดลเหล่านั้นโดยไม่สนใจคีย์ที่คุณเพิ่ม คีย์แบบกำหนดเองจะใช้เมื่อคุณสามารถเลือกโมเดลได้ ซึ่งได้แก่โหมดการสนทนาและแก้ไข ตรวจสอบเอกสารปัจจุบันของ Cursor เนื่องจากสิ่งนี้เปลี่ยนแปลงระหว่างเวอร์ชัน
จำนวนคำขอพร้อมกันจากโหมดเอเจนต์ โหมดเอเจนต์และการรันหลายขั้นตอนสามารถส่งคำขอหลายรายการพร้อมกันได้ คีย์ทดลองอนุญาตให้ใช้สองรายการพร้อมกัน หากข้อผิดพลาดปรากฏเฉพาะในโหมดเอเจนต์ คุณอาจชนกับขีดจำกัด concurrency และคีย์แบบเต็มจะเพิ่มขีดจำกัดนี้เป็นแปด คำขอแบบ stream จะครอบครองช่องรอจนกว่า stream จะจบ ดังนั้น output ยาวจึงใช้ช่องรอนานกว่า
Tool calls API รองรับ tool calling โดย tool_calls จะถูก stream และผลลัพธ์จะถูกส่งกลับเป็น role: "tool" คุณภาพของการใช้ tool ขึ้นอยู่กับโมเดล ดังนั้นหาก agent run ติดขัดที่ขั้นตอน tool ลองใช้ task เดียวกันใน plain chat ก่อน
ตรวจสอบฝั่งบัญชี
หาก curl ส่งข้อผิดพลาดเกี่ยวกับ balance แสดงว่าคีย์ใช้ได้แต่เครดิตว่างเปล่าหรือ trial จบลง trial มีมูลค่า $0.50 ใช้ได้ 7 วัน รับได้ด้วยการคลิกเดียวที่หน้า API key หลังจากสมัคร หลังจากนั้นคุณต้อง top-up
Top-ups เป็นจำนวนเต็มตั้งแต่ $20 ถึง $500 พร้อมโบนัส +5% จาก $50, +10% จาก $100 และ +15% จาก $200 คุณสามารถจ่ายด้วยcrypto (USDT บน TRC20, USDC บน Base) หน้า ราคา แสดงตาราง หากยังไม่มีคีย์ รับที่นี่
ใช้คีย์เดียวต่อเครื่องมือ หากนำคีย์ไปวางในโปรแกรมแก้ไขและสคริปต์หลายแห่ง ขีดจำกัดอัตราจะถูกแชร์ระหว่างกัน ซึ่งอาจดูเหมือนความล้มเหลวแบบสุ่ม
ตรวจสอบสคริปต์สำหรับกรณีที่ยาก
หากยังหาสาเหตุไม่พบ ให้รันสคริปต์สั้นๆ ที่จำลองสิ่งที่โปรแกรมแก้ไขทำ สคริปต์นี้ใช้ SDK ของ OpenAI ซึ่งไคลเอนต์สไตล์ Cursor ถูกออกแบบมาตาม และจะแสดงวัตถุข้อผิดพลาดที่แท้จริง
from openai import OpenAI, APIStatusError
client = OpenAI(base_url="https://api.cursorapikey.com/v1", api_key="YOUR_KEY")
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a one-line Python hello world."}],
stream=True,
)
for chunk in r:
print(chunk.choices[0].delta.content or "", end="")
except APIStatusError as e:
print(e.status_code, e.response.headers.get("X-Request-Id"))
print(e.response.text)
หากสคริปต์สตรีมข้อความ แสดงว่าเอนด์พอยต์ คีย์ และโมเดลถูกต้อง และปัญหาที่เหลือคือการตั้งค่าของ Cursor หากสคริปต์แสดงรหัสสถานะ ให้ใช้ตารางด้านบน เก็บค่า X-Request-Id ไว้เมื่อติดต่อฝ่ายสนับสนุน เนื่องจากค่านี้ระบุคำขอที่แน่นอน รายละเอียดพารามิเตอร์เต็มรูปแบบมีอยู่ที่ หน้าเอกสารประกอบ
ป้องกันไม่ให้เกิดขึ้นอีก
นิสัยไม่กี่อย่างช่วยป้องกันปัญหาซ้ำส่วนใหญ่ เก็บคีย์ใน password manager entry เดียวแล้วคัดลอกจากที่นั้น แทนที่จะคัดลอกจาก chat logs หรือ notes ที่ line breaks อาจแทรกเข้ามา จดค่าสามค่า (base URL, key, ชื่อโมเดล) เพื่อให้คุณสามารถป้อนใหม่ได้หลังจาก editor อัปเดต เนื่องจากการอัปเดตบางครั้งอาจรีเซ็ต overrides หลังจากอัปเดตทุกครั้ง ให้ส่งข้อความแชทสั้นๆ หนึ่งข้อความก่อนเริ่มงานจริง
ติดตาม balance header X-Balance-USD จะถูกส่งกลับในทุก response และคุณยังสามารถอ่านได้จาก GET /v1/balance เครดิตไม่หมดอายุ ดังนั้นการ top-up ขนาดเล็กที่ค้างในบัญชีจะไม่สูญหาย หากคุณใช้คีย์จากสคริปต์และ editor ให้ให้ job แบบ batch ยาวมี retry loop ที่รอห้าวินาทีเมื่อได้ 429 และหยุดหลังจากพยายามไม่กี่ครั้ง เพื่อไม่ให้สคริปต์แย่ง concurrency slots ของ editor
ตรวจสอบต้นทุนและสิ่งที่ควรอ่านต่อไป
coding chat request ที่มี file context 10,000 tokens และคำตอบ 700 tokens มีค่าใช้จ่าย 10,000 / 1,000,000 x $0.15 = $0.0015 สำหรับ input และ 700 / 1,000,000 x $0.50 = $0.00035 สำหรับ output รวมประมาณ $0.00185 อัตราคือ $0.15 ต่อ 1M input tokens และ $0.50 ต่อ 1M output tokens บทความเกี่ยวกับ ราคา Cursor API ครอบคลุมการประมาณการรายเดือน
หาก request ที่ล้มเหลวเป็น request ขนาดใหญ่ โปรดจำ window: prompt บวก completion ต้องอยู่ใน 100,000 tokens และ request body ถูกจำกัดที่ 8 MB การแนบ repository ทั้งหมดไปยัง chat อาจเกินทั้งสองค่านี้ ตัด context เหลือเฉพาะไฟล์ที่เกี่ยวข้องแล้วลองอีกครั้ง
คู่มือเพิ่มเติม
ถาม-ตอบ
ทำไม Cursor ถึงบอกว่าคีย์ API ของฉันไม่ถูกต้อง?
โดยปกติคีย์จะมีช่องว่างแปลกๆ หรือถูกคัดลอกมาไม่ครบ หรือ base URL ยังชี้ไปที่บริการอื่น ให้คัดลอกคีย์อีกครั้ง แล้วยืนยันว่า URL ที่กำหนดค่าใหม่คือ https://api.cursorapikey.com/v1.
ฉันต้องกรอกชื่อโมเดลใด?
ป้อน uncensored เป็นพิมพ์เล็ก นี่คือรหัสโมเดลเดียวที่ API มีให้บริการ
การเติมข้อความอัตโนมัติใช้คีย์ของฉันหรือไม่?
ไม่จำเป็นเสมอไป คุณสมบัติบางส่วนของ Cursor ใช้โมเดลของ Cursor โดยตรง และคีย์กำหนดเองจะใช้หลักๆ กับโหมดแชทและแก้ไขที่คุณเลือกโมเดล
คำขอที่ล้มเหลวมีการเรียกเก็บเงินหรือไม่?
ไม่ คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน ดังนั้นการลองใหม่ขณะแก้ไขข้อผิดพลาดจึงไม่มีค่าใช้จ่าย
เพียงกรอกแบบฟอร์มเดียวก็รับคีย์ได้
สร้างบัญชี คัดลอกคีย์ และเปลี่ยน URL พื้นฐาน นั่นคือการตั้งค่าทั้งหมด