วิธีใช้คีย์ API GitHub Copilot กับ Cursor API

ความเข้าใจเรื่องความเข้ากันได้ของคีย์ API

เมื่อผู้พัฒนาอ้างถึง github copilot api key พวกเขามักหมายถึงโทเคนที่สร้างภายในระบบนิเวศ Microsoft GitHub คีย์นี้ยืนยันคำขอไปยังเซิร์ฟเวอร์ของ Microsoft ซึ่งรันโมเดลเช่น GPT-4o หรือรูปแบบพิเศษที่ปรับให้เหมาะสมสำหรับการเขียนโค้ด แม้โมเดลเหล่านี้จะทรงพลัง แต่ก็มีตัวกรองเนื้อหาและขีดจำกัดอัตราที่ผูกกับบัญชี Microsoft ของคุณ

ในทางตรงกันข้าม Cursor API ทำงานเป็นบริการอิสระ ไม่พึ่งพาโครงสร้างพื้นฐานของ Microsoft แทนที่จะให้บริการโมเดลภาษาขนาดใหญ่แบบเปิดน้ำหนักเพียงตัวเดียวที่ปรับให้เหมาะสมสำหรับบริบทการเขียนโค้ด โมเดลนี้ถูกออกแบบมาเพื่อตอบโดยไม่มีการปฏิเสธเนื้อหาสำหรับการใช้งานผู้ใหญ่ที่ถูกต้องตามกฎหมาย ทำให้เป็นทางเลือกที่แตกต่างสำหรับนักพัฒนาที่พบว่าตัวกรองมาตรฐานจำกัดเกินไป

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

การกำหนดค่าสภาพแวดล้อมของคุณ

เพื่อใช้ Cursor API คุณต้องสร้างคีย์ก่อน ลงทะเบียนในหน้า Get API key ด้วยอีเมลและรหัสผ่านเพียงอย่างเดียว ไม่ต้องใช้บัตรเครดิตสำหรับเครดิตทดลองใช้เริ่มต้น เมื่อลงทะเบียนแล้ว คีย์ของคุณจะแสดงทันที เก็บคีย์นี้ไว้ในตัวแปรสภาพแวดล้อมของคุณอย่างปลอดภัย โดยทั่วไปคือ OPENAI_API_KEY หรือตัวแปรที่กำหนดเองตามความต้องการของเอเจนต์ของคุณ

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

ตรวจสอบให้แน่ใจว่าสภาพแวดล้อมของคุณถูกกำหนดค่าเพื่อส่งคำขอไปยัง URL พื้นฐานใหม่นี้ รหัสโมเดลที่คุณต้องระบุในคำขอของคุณคือ uncensored สิ่งนี้บอก API ว่าต้องการเรียกใช้โมเดลเฉพาะใด เป็นโมเดลแบบเปิดน้ำหนักที่รันบนเซิร์ฟเวอร์ GPU ของเรา ซึ่งแตกต่างจาก GPT, Claude หรือ Gemini

การเปลี่ยน URL พื้นฐาน

การเปลี่ยนจาก คีย์ API ของ GitHub Copilot ไปยัง Cursor API ส่วนใหญ่เกี่ยวข้องกับการเปลี่ยน URL พื้นฐานในการกำหนดค่าไคลเอนต์ของคุณ หากใช้ SDK ทางการของ OpenAI สำหรับ Python หรือ Node.js การเปลี่ยนแปลงนี้ทำได้เพียงบรรทัดเดียว ตัวอย่างเช่น ใน Python คุณจะต้องเริ่มต้นไคลเอนต์ด้วย URL พื้นฐานใหม่และคีย์ API ใหม่ของคุณ

การเปลี่ยนแปลงนี้จะเปลี่ยนเส้นทางคำขอของคุณจากเซิร์ฟเวอร์ของ Microsoft มาสู่โครงสร้างพื้นฐานของเรา ประโยชน์รวมถึงการเข้าถึงหน้าต่างบริบท 100,000 โทเคนและโมเดลที่ปรับให้เหมาะสมเพื่อลดการปฏิเสธ คุณสามารถตรวจสอบการเชื่อมต่อได้โดยตรวจสอบเอนด์พอยต์ /v1/models ซึ่งควรแสดงโมเดลที่มีอยู่ รวมถึง uncensored

การแลกเปลี่ยน: แม้ไวยากรณ์จะเหมือนกัน แต่คุณจ่ายตามโทเคนแทนที่จะจ่ายผ่านสมาชิก Microsoft ราคาของเราโปร่งใส: $0.25 ต่อ 1M input tokens และ $1.00 ต่อ 1M output tokens ไม่มีค่าธรรมเนียมรายเดือน มีเพียงเครดิตแบบเติมเงินล่วงหน้าที่ใช้งานได้จริงตามการใช้งานจริงและไม่มีวันหมดอายุ โมเดลนี้เหมาะสำหรับงานที่มีปริมาณแปรผัน โดยไม่ต้องผูกมัดกับค่าใช้จ่ายรายเดือน

การทดสอบการเชื่อมต่อของคุณ

ก่อนผสาน API เข้ากับเวิร์กโฟลว์หลักของคุณ การตรวจสอบว่าสภาพแวดล้อมของคุณสามารถสื่อสารกับ Cursor API ได้เป็นสิ่งสำคัญ คุณสามารถทำได้ด้วยคำสั่ง cURL อย่างง่ายหรือสคริปต์สั้นๆ การทดสอบนี้ยืนยันว่าคีย์ของคุณถูกต้องและ URL พื้นฐานถูกต้อง

ตัวอย่างคำขอ cURL:

ส่งคำขอ POST ไปยัง https://api.cursorapikey.com/v1/chat/completions โดยตั้งค่าโมเดลเป็น uncensored รวมพรอมต์อย่างง่ายในอาร์เรย์ messages การตอบกลับที่สำเร็จจะส่งคืนผลลัพธ์ในฟิลด์ choices[0].message.content

หากคุณได้รับข้อผิดพลาด 401 คีย์ API ของคุณไม่ถูกต้อง หากคุณได้รับข้อผิดพลาด 429 คุณได้เกินขีดจำกัดอัตรา 300 คำขอต่อนาทีต่อคีย์ คุณสามารถสร้างคีย์ใหม่ได้ทุกเมื่อเพื่อยกเลิกคีย์เก่า การทดสอบนี้ยืนยันว่าฟังก์ชันพื้นฐานข้อความเข้า-ข้อความออกทำงานตามที่คาดไว้

การจัดการการตอบกลับแบบสตรีมมิง

สำหรับเอเจนต์เขียนโค้ด การตอบกลับแบบสตรีมมิงมีความสำคัญอย่างยิ่งเพื่อให้ผู้ใช้ได้รับประสบการณ์ที่ลื่นไหล Cursor API รองรับ Server-Sent Events (SSE) สำหรับการสตรีมมิง สิ่งนี้ช่วยให้คุณรับโทเคนเมื่อถูกสร้าง แทนที่จะรอการตอบกลับทั้งหมด

เมื่อใช้ OpenAI SDK คุณสามารถเปิดใช้งานสตรีมมิงได้โดยการตั้งค่าพารามิเตอร์ stream เป็น true SDK จะส่งข้อมูลเป็นชิ้นส่วนเมื่อข้อมูลมาถึง สิ่งนี้มีประโยชน์อย่างยิ่งสำหรับการสร้างโค้ดยาว ซึ่งคุณต้องการแสดงความคืบหน้าให้ผู้ใช้หรือส่งโทเคนไปยังโปรแกรมแก้ไขสด

การสตรีมไม่เปลี่ยนโมเดลหรือความสามารถพื้นฐาน โมเดล uncensored ยังคงใช้หน้าต่างบริบท 100,000 โทเคนและโครงสร้างราคาเดิม การสตรีมเป็นฟีเจอร์ฝั่งไคลเอนต์ที่ลดความล่าช้าที่ผู้ใช้รู้สึก โดยไม่กระทบพฤติกรรมของโมเดล

การผสานการเรียกใช้เครื่องมือ

ผู้ช่วยเขียนโค้ด AI รุ่นใหม่พึ่งพาการเรียกใช้เครื่องมือ (function calling) อย่างหนักเพื่อโต้ตอบกับโลกภายนอก เช่น การรันคำสั่ง shell หรือเข้าถึงไฟล์ Cursor API รองรับสิ่งนี้ผ่านรูปแบบมาตรฐานที่เข้ากันได้กับ OpenAI

กำหนดเครื่องมือในคำขอผ่านพารามิเตอร์ tools โมเดลจะตอบกลับด้วยอาร์เรย์ tool_calls หากต้องการใช้เครื่องมือ แอปของคุณต้องเรียกใช้เครื่องมือและส่งผลลัพธ์กลับไปยัง API ในข้อความถัดไป

กระบวนการนี้เหมือนกับวิธีที่คุณจะใช้ คีย์ API ของ GitHub Copilot กับโมเดลของ Microsoft ข้อได้เปรียบที่นี่คือความสอดคล้อง หากคุณมีโค้ดที่มีอยู่สำหรับการเรียกใช้เครื่องมือ คุณอาจสามารถนำกลับมาใช้ใหม่ได้ด้วยการปรับแต่งเพียงเล็กน้อย เพียงตรวจสอบให้แน่ใจว่าคำจำกัดความเครื่องมือของคุณตรงกับสคีมาที่คาดหวังสำหรับโมเดล uncensored

การตรวจสอบการใช้งาน

เนื่องจากคุณจ่ายต่อโทเคน การตรวจสอบการใช้งานของคุณจึงสำคัญเพื่อหลีกเลี่ยงต้นทุนที่ไม่คาดคิด Cursor API ให้แดชบอร์ดที่คุณสามารถดูยอดคงเหลือเครดิตและประวัติการใช้งานของคุณ คุณสามารถดูว่าคุณใช้โทเคนไปกี่โทเคนและเหลือเครดิตเท่าไหร่

ข้อจำกัดสำคัญที่ต้องระวัง:

• ขีดจำกัดอัตรา: 300 คำขอต่อนาทีต่อคีย์
• ขนาดของ body ในคำขอ: สูงสุด 8 MB ต่อคำขอ
• หน้าต่างบริบท: 100,000 โทเคนรวม (อินพุต + เอาต์พุต)

หากคุณเกินขีดจำกัดอัตรา คุณจะรับข้อผิดพลาด 429 คุณสามารถตรวจสอบการใช้งานของคุณแบบเรียลไทม์เพื่อให้แน่ใจว่าคุณอยู่ภายในขอบเขตเหล่านี้ นอกจากนี้ คุณสามารถสร้างคีย์ API ใหม่ได้หากคุณสงสัยว่ามีการละเมิด ซึ่งจะทำให้คีย์เก่ายกเลิกทันที

การแก้ไขปัญหาทั่วไป

แม้จะมี API ที่แข็งแกร่ง แต่ปัญหาอาจเกิดขึ้นได้ นี่คือปัญหาทั่วไปบางประการและวิธีแก้ไข

401 Unauthorized: ตรวจสอบคีย์ API ของคุณ ตรวจสอบให้แน่ใจว่าคัดลอกอย่างถูกต้องและไม่มีช่องว่างนำหน้าหรือตามหลัง หากสร้างคีย์ใหม่ โปรดใช้คีย์ใหม่

429 Too Many Requests: คุณได้เกินขีดจำกัด 300 คำขอต่อนาทีแล้ว ให้ใช้การหน่วงแบบทวีคูณในไคลเอนต์ของคุณหรือลดความถี่ของคำขอ

400 Bad Request: บ่งชี้ JSON ผิดรูปแบบหรือขาดฟิลด์ที่จำเป็น ตรวจสอบว่าอาร์เรย์ messages ถูกต้องและมีฟิลด์ role และ content ตรวจสอบชื่อโมเดลเป็น uncensored

การบล็อกเนื้อหา: แม้โมเดลจะไม่มีการเซ็นเซอร์ แต่โมเดลจะบล็อกเนื้อหาทางเพศที่เกี่ยวข้องกับบุคคลที่ยังไม่บรรลุนิติภาวะ หากคำขอของคุณถูกบล็อก อาจเป็นเพราะขีดจำกัดเฉพาะนี้