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

ประเด็นสำคัญ
- Cursor ช่วยให้คุณทับ base URL และคีย์ของ OpenAI ได้ ดังนั้นเอนด์พอยต์ที่เข้ากันได้กับ OpenAI จึงสามารถให้บริการคำขอได้
- ใช้ base URL https://api.cursorapikey.com/v1 และโมเดล ID
uncensored - ทดสอบคีย์ด้วย curl ก่อนที่จะแก้ไข editor เพื่อให้คุณทราบว่าข้อผิดพลาดมาจากฝั่งใด
- พรอมต์ขนาด 20,000 โทเคนพร้อมคำตอบขนาด 1,000 โทเคนมีต้นทุน $0.0035
สิ่งที่คู่มือนี้ครอบคลุม
ผู้คนที่ค้นหาวิธีใช้ Cursor API มักหมายถึงหนึ่งในสองอย่าง คือพวกเขาต้องการเรียกบริการ Cursor บางอย่างจากโค้ด หรือไม่ก็ต้องการให้ editor Cursor ส่งคำขอโมเดลไปยังเอนด์พอยต์ที่พวกเขาเลือก คู่มือนี้เกี่ยวกับกรณีที่สอง เว็บไซต์นี้เป็น API ที่โฮสต์โดยอิสระซึ่งใช้โปรโตคอลการเสร็จสิ้นการสนทนาของ OpenAI ดังนั้น Cursor จึงสามารถพูดคุยกับมันได้เหมือนกับที่มันพูดคุยกับเซิร์ฟเวอร์สไตล์ OpenAI ใดๆ
โมเดลที่อยู่เบื้องหลังเป็นโมเดลแบบเปิดน้ำหนักเพียงตัวเดียว ดำเนินการโดยผู้ให้บริการอิสระและปรับแต่งเพื่อตอบโดยไม่มีการปฏิเสธเนื้อหาสำหรับการใช้งานผู้ใหญ่ที่ถูกต้องตามกฎหมาย ไม่ใช่โมเดล Cursor อย่างเป็นทางการ และไม่ใช่เราเตอร์ที่กระจายคำขอข้ามผู้ให้บริการหลายราย รองรับเฉพาะข้อความ สำหรับการเขียนโค้ดนั้นมักเพียงพอ: คุณส่งโค้ดและคำแนะนำ คุณจะได้รับโค้ดและคำอธิบายกลับคืนมา
คุณต้องมีสามสิ่ง: API key, base URL https://api.cursorapikey.com/v1 และ model ID uncensored ส่วนที่เหลือเป็นเรื่องของการหาช่องที่เหมาะสมใน editor
ขั้นตอนที่ 1: รับคีย์และตรวจสอบด้วย curl
สมัครสมาชิกด้วย Google หรืออีเมลและรหัสผ่าน จากนั้นเปิด หน้า API key บัญชีใหม่สามารถรับเครดิตทดลองใช้ $0.50 ได้ด้วยการคลิกเดียว ไม่ต้องใช้บัตรและใช้ได้เป็นเวลา 7 วัน คีย์ทดลองจำกัดคำขอพร้อมกัน 2 คำขอและ 60 คำขอต่อนาที ซึ่งเพียงพอสำหรับเซสชันแรกใน editor
ก่อนเปิด Cursor ให้ยืนยันว่าคีย์ใช้งานได้ รันคำสั่งนี้ในเทอร์มินัล โดยใส่คีย์ของคุณในตัวแปรสภาพแวดล้อม:
export API_KEY="paste-your-key-here"
curl https://api.cursorapikey.com/v1/models \
-H "Authorization: Bearer $API_KEY"
curl https://api.cursorapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Write a Python function that reverses a linked list."}
]
}'
การเรียกครั้งแรกจะแสดงรายการโมเดล การเรียกครั้งที่สองจะคืนค่า chat completion ตามปกติ หากทั้งสองอย่างสำเร็จ ความล้มเหลวอื่นๆ ในโปรแกรมแก้ไขเป็นปัญหาการตั้งค่า ไม่ใช่ปัญหาของคีย์ การแยกตรวจสอบนี้ช่วยประหยัดการคาดเดาได้มาก
ขั้นตอนที่ 2: ตั้งค่า base URL และคีย์ใน Cursor
เปิดการตั้งค่าของ Cursor และไปที่ส่วนโมเดล ชื่อเมนูและเลย์เอาต์อาจเปลี่ยนแปลงระหว่างเวอร์ชัน ดังนั้นให้ใช้ป้ายกำกับด้านล่างเป็นแนวทางและตรวจสอบเอกสารของ Cursor เองหากมีบางอย่างเปลี่ยนแปลงไป
- ค้นหาฟิลด์สำหรับคีย์ API ของ OpenAI และวางคีย์ของคุณจากเว็บไซต์นี้
- เปิดใช้งานตัวเลือกเพื่อแทนที่ base URL ของ OpenAI และป้อน
https://api.cursorapikey.com/v1เก็บ/v1ไว้ที่ท้ายและอย่าเพิ่ม/chat/completions; แอปไคลเอนต์จะเพิ่มพาธเอง - เพิ่มโมเดลแบบกำหนดเองและพิมพ์
uncensoredให้ถูกต้อง ตัวพิมพ์เล็กทั้งหมด - ใช้ปุ่มตรวจสอบหรือบันทึกหากโปรแกรมแก้ไขมีตัวเลือกนั้น จากนั้นเลือกโมเดลใหม่ในแผงการสนทนา
ส่งข้อความสั้นๆ เช่น "อธิบายฟังก์ชันนี้" พร้อมเปิดไฟล์อยู่ การตอบแบบสตรีมมิงแสดงว่าเส้นทางใช้งานได้ตั้งแต่ต้นจนจบ Cursor ส่งคำขอ เอนด์พอยต์สตรีมโทเคนกลับผ่าน SSE และโปรแกรมแก้ไขจะแสดงผลทันทีที่ได้รับ
ข้อควรระวังสองประการ คุณสมบัติ editor บางอย่าง เช่น การเติมแท็บแบบ inline อาจทำงานบนโมเดลที่ Cursor ควบคุมและอาจละเลยคีย์ของคุณ ดังนั้นตรวจสอบว่าคุณสมบัติใดใช้โมเดลที่กำหนดเองจริง ๆ และเนื่องจาก Cursor อาจกำหนดเส้นทางทราฟฟิกของคีย์ที่กำหนดเองผ่านเซิร์ฟเวอร์ของตัวเอง ให้ตรวจสอบเอกสารปัจจุบันหากต้องการทราบตำแหน่งที่โค้ดของคุณเดินทางไปอย่างแม่นยำ หน้า quickstart บนเว็บไซต์นี้ระบุด้าน API ของข้อตกลง
ทดสอบเอนด์พอยต์เดียวกันจากโค้ด
วิธีที่ง่ายที่สุดในการแยกปัญหาคือการเรียกเอนด์พอยต์ด้วย SDK ของ OpenAI อย่างเป็นทางการ หากใช้งานได้ แสดงว่าเอนด์พอยต์ปกติและปัญหาที่เหลืออยู่ในส่วนการตั้งค่าของโปรแกรมแก้ไข
from openai import OpenAI
client = OpenAI(
api_key="paste-your-key-here",
base_url="https://api.cursorapikey.com/v1",
)
stream = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a terse senior engineer."},
{"role": "user", "content": "Refactor this loop into a list comprehension: out = []\nfor x in xs:\n if x > 0:\n out.append(x * 2)"},
],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
สิ่งเดียวกันใน Node:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.API_KEY,
baseURL: "https://api.cursorapikey.com/v1",
});
const res = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a regex that matches ISO 8601 dates." }],
});
console.log(res.choices[0].message.content);
การตอบกลับแบบ streaming รวมถึงการใช้งานที่ส่วนท้าย ดังนั้นคุณสามารถบันทึกจำนวนโทเคนที่คำขอใช้ได้อย่างแม่นยำ การตอบกลับแต่ละรายการยังมี header X-Balance-USD ที่มีเครดิตคงเหลือของคุณ และ X-Request-Id ที่คุณสามารถอ้างอิงได้หากมีบางอย่างดูผิดปกติ
สิ่งที่ทำงานได้ในเวิร์กโฟลว์การเขียนโค้ด
API รองรับ streaming, โหมด JSON และการเรียกใช้ฟังก์ชัน (tools, tool_choice, tool_calls แบบสตรีม และผลลัพธ์ส่งกลับเป็น role: "tool") การตั้งค่า sampling เช่น temperature, top_p, stop, seed และค่า penalty จะถูกส่งผ่าน หน้าต่างบริบทคือ 100,000 โทเคน ซึ่งใช้ร่วมกันระหว่างพรอมต์และการสร้างข้อความ และ max_tokens เป็นตัวเลือก
100,000 โทเคนนี้เป็นงบประมาณที่เหลือเฟือสำหรับโค้ด ไฟล์แหล่งที่มาที่มีไม่กี่ร้อยบรรทัดมีเพียงไม่กี่พันโทเคน ดังนั้นคุณสามารถรวมไฟล์หลายไฟล์พร้อมคำแนะนำที่ยาวและยังคงเหลือพื้นที่สำหรับคำตอบ ขนาดสูงสุดของ body คำขอคือ 8 MB ซึ่งคุณจะไม่ถึงขีดจำกัดนี้ด้วยข้อความ
นิสัยบางอย่างที่ทำให้โมเดลแบบกำหนดเองใช้งานง่ายในโปรแกรมแก้ไข:
- ใช้ค่า
temperatureต่ำสำหรับการแก้ไขโค้ด ค่าประมาณ 0.2 จะให้ผลลัพธ์ที่เสถียรกว่า; เพิ่มค่านี้เฉพาะเมื่อต้องการระดมความคิด - แนบเฉพาะไฟล์ที่สำคัญเท่านั้น ทุกโทเคนที่คุณส่งจะถูกเรียกเก็บเป็นอินพุต และการสนทนาทั้งหมดจะถูกส่งใหม่ในแต่ละรอบ
- ขอ diff หรือฟังก์ชันที่เปลี่ยนแปลง ไม่ใช่ไฟล์ทั้งหมด เมื่อไฟล์มีขนาดใหญ่ โทเคนเอาต์พุตมีค่าใช้จ่ายมากกว่าโทเคนอินพุต
- ใช้โมเดลสำหรับงานที่การปฏิเสธเป็นอุปสรรค เช่น การเขียน proof-of-concept ของ exploit สำหรับแล็บของคุณเอง การวิเคราะห์ตัวอย่างมัลแวร์ที่คุณได้รับอนุญาตให้ศึกษา หรือการสร้างข้อมูลทดสอบที่เลียนแบบเนื้อหาจริงที่ยุ่งเหยิง ทั้งหมดนี้ต้องถูกกฎหมาย
ขีดจำกัดแข็งข้อเดียวที่ควรย้ำ: ไม่มีเนื้อหาทางเพศที่เกี่ยวข้องกับผู้เยาว์ ภายใต้เงื่อนไขใดก็ตาม
แก้ไขข้อผิดพลาดที่พบบ่อย
| อาการ | สาเหตุที่เป็นไปได้ | การแก้ไข |
|---|---|---|
| 401 หรือ "คีย์ไม่ถูกต้อง" | วางคีย์พร้อมช่องว่าง หรือคีย์เก่า | คัดลอกใหม่จากหน้าคีย์; ทดสอบด้วย curl |
| 404 หรือ "ไม่พบโมเดล" | พิมพ์ชื่อโมเดลไม่ถูกต้อง | ใช้ uncensored ตัวพิมพ์เล็ก โดยไม่มีส่วนต่อท้าย |
| 404 บน path | Base URL รวม /chat/completions | จบ Base URL ที่ /v1 |
429 พร้อม concurrency | คำขอพร้อมกันมากเกินไป | รอให้ stream เสร็จสิ้น; คีย์เต็มอนุญาตได้ 8 คำขอ คีย์ทดลองอนุญาตได้ 2 คำขอ |
429 พร้อม rate_limited | คำขอมากกว่า 300 คำขอต่อนาที (60 สำหรับคีย์ทดลอง) | ลดความเร็ว หรือลองใหม่หลังจากหยุดพัก |
429 พร้อม Retry-After: 5 | โอเวอร์โหลดชั่วคราว | ลองใหม่หลังจากห้าวินาที |
คำขอแบบสตรีมมิงจะครอบครองช่อง concurrency จนกว่าสตรีมจะสิ้นสุด หากคุณเริ่มการสนทนาหลายรายการใน Cursor และปล่อยให้มันสร้างผลลัพธ์ คุณอาจถึงขีดจำกัด concurrency บนคีย์ทดลองได้เร็ว คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน ดังนั้นการลองใหม่จึงไม่เสียค่าใช้จ่ายเพิ่ม
ต้นทุนของเซสชันการเขียนโค้ด
ราคาอยู่ที่ $0.15 ต่อโทเคนอินพุต 1M และ $0.50 ต่อโทเคนเอาต์พุต 1M ซึ่งหักจากเครดิตแบบเติมเงินล่วงหน้าโดยไม่ต้องสมัครสมาชิก คำขอ editor ปกติมีพรอมต์ขนาดใหญ่ (ไฟล์ของคุณ) และคำตอบสั้น ๆ ใช้โทเคนอินพุต 20,000 และโทเคนเอาต์พุต 1,000:
- Input: 20,000 x $0.15 / 1,000,000 = $0.0030
- Output: 1,000 x $0.50 / 1,000,000 = $0.0005
- รวม: $0.0035 ต่อคำขอ
ที่ 100 คำขอในวันทำงานคือ $0.35 เครดิตทดลองใช้ $0.50 ครอบคลุมคำขอประมาณ 140 คำขอเช่นนี้ หลังหมดทดลองคุณสามารถเติมเงินจำนวนเต็มใดก็ได้ตั้งแต่ $20 ถึง $500 พร้อมเครดิตโบนัส +5% เมื่อเติม $50, +10% เมื่อเติม $100 และ +15% เมื่อเติม $200 จ่ายด้วยคริปโต (USDT บน TRC20, USDC บน Base) เครดิตไม่หมดอายุ ดังนั้นการเติมเงินที่คุณใช้ช้าไม่สูญเปล่า หน้า ราคา มีตารางราคาเต็ม และหน้า ทางเลือกแทน Cursor และ Copilot อธิบายว่าสิ่งนี้จัดอยู่ในตำแหน่งใดเมื่อเทียบกับ editor แบบสมัครสมาชิก
พรอมต์ไม่ถูกนำไปใช้ในการฝึกโมเดล
คู่มือเพิ่มเติม
ถาม-ตอบ
สิ่งนี้ทำงานกับ agent ของ Cursor และการเรียกใช้ฟังก์ชันได้หรือไม่
API รองรับ function calling พร้อม tools, tool_choice และ tool_calls แบบสตรีม ว่าฟีเจอร์ Cursor ใดใช้โมเดลที่กำหนดเองของคุณ ขึ้นอยู่กับ editor ดังนั้นให้ทดสอบแต่ละฟีเจอร์หลังการตั้งค่า
ฉันต้องกรอกชื่อโมเดลใด?
กรอก uncensored เป็นตัวพิมพ์เล็ก เป็นโมเดล ID เดียว และ GET /v1/models จะแสดงรายการนี้
นี่คือ API Cursor อย่างเป็นทางการหรือไม่?
ไม่ มันเป็น API ที่เข้ากันได้กับ OpenAI ที่เป็นอิสระซึ่งอยู่หน้าโมเดลแบบเปิดน้ำหนักหนึ่งตัว Cursor เพียงแค่ให้คุณชี้การตั้งค่า OpenAI ไปที่ endpoint อื่น
ฉันต้องใช้บัตรเพื่อลองใช้หรือไม่?
ไม่ เครดิตทดลองใช้ฟรี $0.50 สามารถรับได้ด้วยการคลิกหนึ่งครั้งบนหน้า API key หลังสมัครสมาชิก ไม่ต้องใช้บัตร และใช้ได้เป็นเวลา 7 วัน
คีย์ของคุณอยู่ห่างแค่แบบฟอร์มเดียว
สร้างบัญชี คัดลอกคีย์ และเปลี่ยน base URL นั่นคือการตั้งค่าทั้งหมด