TH ▾
รับคีย์ API

cursorapikey.com/คู่มือ

วิธีใช้คีย์ API ของ Cursor กับเอนด์พอยต์แบบกำหนดเอง

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

อัปเดต

โปรแกรมแก้ไขโค้ดแบบไอโซเมตริกเชื่อมต่อกับกล่องเซิร์ฟเวอร์ด้วยสายไฟส่องสว่าง แสดงถึงเอนด์พอยต์ API แบบกำหนดเอง

ประเด็นสำคัญ

  • 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 เองหากมีบางอย่างเปลี่ยนแปลงไป

  1. ค้นหาฟิลด์สำหรับคีย์ API ของ OpenAI และวางคีย์ของคุณจากเว็บไซต์นี้
  2. เปิดใช้งานตัวเลือกเพื่อแทนที่ base URL ของ OpenAI และป้อน https://api.cursorapikey.com/v1 เก็บ /v1 ไว้ที่ท้ายและอย่าเพิ่ม /chat/completions; แอปไคลเอนต์จะเพิ่มพาธเอง
  3. เพิ่มโมเดลแบบกำหนดเองและพิมพ์ uncensored ให้ถูกต้อง ตัวพิมพ์เล็กทั้งหมด
  4. ใช้ปุ่มตรวจสอบหรือบันทึกหากโปรแกรมแก้ไขมีตัวเลือกนั้น จากนั้นเลือกโมเดลใหม่ในแผงการสนทนา

ส่งข้อความสั้นๆ เช่น "อธิบายฟังก์ชันนี้" พร้อมเปิดไฟล์อยู่ การตอบแบบสตรีมมิงแสดงว่าเส้นทางใช้งานได้ตั้งแต่ต้นจนจบ 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 บน pathBase 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 แบบสมัครสมาชิก

พรอมต์ไม่ถูกนำไปใช้ในการฝึกโมเดล

01

ถาม-ตอบ

สิ่งนี้ทำงานกับ 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 นั่นคือการตั้งค่าทั้งหมด