ทำความเข้าใจ URL ฐาน
URL พื้นฐานกำหนดตำแหน่งที่ไคลเอนต์ของคุณส่งคำขอ ความไม่ตรงกันที่นี่จะทำให้การเชื่อมต่อล้มเหลวทันทีหรือได้รับคำตอบจากโมเดลที่คาดเดาไม่ได้ นักพัฒนาหลายคนเชื่อว่า URL มาตรฐานของ OpenAI ใช้ได้กับทุกที่ แต่ผู้ให้บริการแบบไร้การเซ็นเซอร์มักใช้เอนดพอยต์ที่แตกต่างกันเพื่อจัดเส้นทางจราจรไปยังกลุ่มโมเดลเฉพาะ
ตรวจสอบว่าค่ากำหนดของคุณชี้ไปที่ https://api.openrouterabliteratedmodels.com/v1 สำหรับบริการของเรา หากคุณใช้ผู้รวมข้อมูลบุคคลที่สาม ตรวจสอบให้แน่ใจว่า URL พื้นฐานตรงกับเอกสารประกอบของพวกเขาอย่างถูกต้อง URL ที่ไม่ถูกต้องมักนำไปสู่ข้อผิดพลาด 404 หรือการตอบกลับจากโมเดลเริ่มต้นแทนที่จะเป็นรูปแบบ uncensored ที่ตั้งใจ
- ตรวจสอบตัวแปรสภาพแวดล้อมของคุณสำหรับ
BASE_URLหรือAPI_HOST. - ตรวจสอบว่าเส้นทางรวมถึง
/v1เพื่อให้เข้ากันได้กับมาตรฐาน - ทดสอบการเชื่อมต่อด้วยการขอรายการโมเดลแบบง่ายก่อนการใช้งานหนัก
การจัดการอัตราจำกัด (Rate Limits)
อัตราจำกัดการเรียกข้อมูล (Rate limits) จำกัดจำนวนคำขอที่คุณสามารถส่งได้ภายในระยะเวลาที่กำหนด API ของเราบังคับใช้ขีดจำกัด 300 คำขอต่อนาทีต่อคีย์ การเกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาด HTTP 429 ซึ่งบล็อกคำขอเพิ่มเติมชั่วคราวจนกว่าระยะเวลาจะรีเซ็ต
นอกจากนี้ มีขีดจำกัดคำขอพร้อมกันคือ 8 คำขอต่อคีย์ในครั้งเดียวกัน หากคุณส่งคำขอพร้อมกันมากกว่า 8 คำขอ คำขอส่วนเกินจะถูกจัดคิวหรือล้มเหลวขึ้นอยู่กับไลบรารีไคลเอนต์ของคุณ ตรวจสอบความพร้อมใช้งานของแอปพลิเคชันเพื่อหลีกเลี่ยงการชนกับขีดจำกัดเหล่านี้ ใช้กลยุทธ์การรีทรีใหม่แบบเอกซ์โพเนนเชียลในโค้ดของคุณเพื่อจัดการข้อผิดพลาด 429 อย่างสง่างามโดยไม่ส่งข้อความรบกวนเซิร์ฟเวอร์
จำไว้ว่าแต่ละคีย์นั้นเฉพาะสำหรับบัญชีของคุณ การแชร์คีย์ข้ามบริการหลายแห่งสามารถทำให้คุณถึงขีดจำกัดเหล่านี้ได้เร็วขึ้น สร้างคีย์ใหม่หากคุณต้องการกลุ่มขีดจำกัดอัตราแยกกันสำหรับส่วนต่างๆ ของแอปพลิเคชัน
การตอบสนองแบบสตรีมเทียบกับไม่สตรีม
การตอบกลับแบบสตรีมส่งข้อมูลแบบเพิ่มทีละน้อยขณะกำลังสร้างโทเค็น ในขณะที่ไม่มีการสตรีมจะรอคำตอบเต็มรูปแบบ การสตรีมจำเป็นสำหรับประสบการณ์ผู้ใช้แบบเรียลไทม์ แต่ต้องการการจัดการ Server-Sent Events (SSE) อย่างระมัดระวัง
เมื่อสตรีม ชิ้นส่วนสุดท้ายจะประกอบด้วยสถิติการใช้โทเค็น หากคุณหยุดประมวลผลก่อนหน้า คุณอาจพลาดข้อมูลนี้ ตรวจสอบให้แน่ใจว่าไคลเอนต์ของคุณแยกวิเคราะห์ข้อความ SSE สุดท้ายเพื่อดึงจำนวนโทเค็นอินพุตและเอาท์พุตได้อย่างแม่นยำ การตอบสนองแบบไม่สตรีมนั้นเรียบง่ายกว่าแต่อาจทำให้เกิดความหน่วงสูงสำหรับเอาท์พุตที่ยาว
เลือกโหมดสตรีมมิ่งสำหรับอินเทอร์เฟซแชทที่ผู้ใช้เห็นข้อความปรากฏทีละตัวอักษร ใช้โหมดไม่สตรีมมิ่งสำหรับการประมวลผลแบบแบตช์ หรือเมื่อคุณต้องการคำตอบครบถ้วนก่อนดำเนินการต่อ API ของเรารองรับทั้งสองโหมดผ่าน stream พารามิเตอร์นี้ในบอดีคำขอ
ข้อผิดพลาดโหมด JSON
โหมด JSON รับประกันว่าโมเดลจะส่งออก JSON ที่ถูกต้อง ซึ่งสำคัญมากสำหรับการผสานรวมเชิงโปรแกรม ข้อผิดพลาดที่นี่มักเกิดจาก headers ที่ไม่ถูกต้องหรือความไม่ตรงกันของ schema API ต้องการ response_format: {"type": "json_object"} เพื่อบังคับใช้เอาต์พุต JSON อย่างเข้มงวด
หากคุณได้รับ JSON ที่ไม่ถูกต้อง ให้ตรวจสอบคำจำกัดความของสคีมาของคุณ โมเดลอาจรวมบล็อกโค้ดมาร์กดาวน์หรือข้อความอธิบายไว้ภายนอกโครงสร้าง JSON ใช้ตัวแยกวิเคราะห์ที่แข็งแกร่งที่สามารถลบเครื่องหมายมาร์กดาวน์หรือตรวจสอบความถูกต้องของเอาต์พุตตามสคีมาที่คาดหวังของคุณ หลีกเลี่ยงสคีมาที่ซับซ้อนเกินไปซึ่งอาจทำให้โมเดลสับสน
ทดสอบด้วยโครงสร้างง่ายๆ ก่อน ค่อยๆ เพิ่มความซับซ้อนเพื่อระบุจุดที่โมเดลมีปัญหา ตรวจสอบการตั้งค่าอุณหภูมิของคุณให้เหมาะสม เนื่องจากอุณหภูมิที่สูงขึ้นอาจเพิ่มความสุ่มและลดความถูกต้องของ JSON
การคำนวณจำนวนโทเค็นผิดพลาด
จำนวนโทเค็นกำหนดการเรียกเก็บเงินและการใช้งานหน้าต่างบริบท การคำนวณผิดพลาดอาจนำไปสู่ค่าใช้จ่ายที่ไม่คาดคิดหรือข้อมูลตอบกลับที่ถูกตัดทอน API ของเราเรียกเก็บเงิน $0.15 ต่อ 1M โทเค็นอินพุตและ $0.50 ต่อ 1M โทเค็นเอาต์พุต
ใช้ไลบรารีตัวแบ่งคำ (tokenizer) ที่เชื่อถือได้ซึ่งตรงกับระบบการแบ่งคำของโมเดล โมเดลที่แตกต่างกันอาจแบ่งช่องว่างหรือเครื่องหมายวรรคตอนต่างกัน ส่งผลให้จำนวนโทเค็นที่นับในเครื่องของคุณไม่ตรงกับ API ควรพึ่งพาการใช้โทเค็นที่ส่งกลับมาในการตอบกลับเสมอสำหรับการเรียกเก็บเงินที่แม่นยำ
ติดตามหน้าต่างบริบทของคุณซึ่งมีขนาดรวม 100,000 โทเค็น การเกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาด ให้ตัดข้อความหรือบทสรุปเก่าออกเพื่อให้อยู่ในขอบเขต ตรวจสอบการใช้โทเค็นของคุณตลอดเวลาเพื่อปรับโครงสร้างพรอมต์ให้เหมาะสมและลดต้นทุน
ความล่าช้าในการชำระเงินคริปโต
การเติมเงินด้วยคริปโตผ่าน USDT (TRC20) หรือ USDC (Base) จะดำเนินการทันทีในระบบของเรา อย่างไรก็ตาม ความแออัดของเครือข่ายอาจทำให้เกิดความล่าช้าเล็กน้อยในการยืนยัน โปรดตรวจสอบให้แน่ใจว่าคุณส่งจำนวนเงินและเครือข่ายที่ถูกต้องเพื่อหลีกเลี่ยงการสูญเสีย
การเติมเงินอยู่ในช่วง $20 ถึง $500 ในจำนวนเต็ม เครดิตโบนัสจะถูกนำไปใช้โดยอัตโนมัติ: +5% จาก $50, +10% จาก $100 และ +15% จาก $200 ตรวจสอบ hash ของธุรกรรมเพื่อยืนยันการชำระเงิน หากเครดิตไม่ปรากฏภายในไม่กี่นาที ให้ตรวจสอบผู้สำรวจบล็อกเชนเพื่อดูสถานะของธุรกรรม
เครดิตไม่หมดอายุ ดังนั้นจึงไม่มีความเร่งด่วนในการใช้งานทันที ความผิดพลาดเช่นการเรียกเก็บเงินซ้ำจะแก้ไขผ่านหน้า Support เก็บบันทึกธุรกรรมของคุณไว้เพื่ออ้างอิงหากมีปัญหาเกิดขึ้น
การกำหนดค่า ID โมเดล
รหัสโมเดลระบุเวอร์ชันของโมเดล uncensored ที่คุณกำลังใช้งาน สำหรับบริการของเรา รหัสโมเดลคือ uncensored. การใช้รหัสที่ไม่ถูกต้องอาจทำให้เกิดข้อผิดพลาดหรือพฤติกรรมที่ไม่คาดคิด
ตรวจสอบให้แน่ใจว่าคำขอของคุณระบุ model: "uncensored" ใน body ของคำขอ ID นี้ชี้ไปที่โมเดล open-weight เฉพาะของเราที่ปรับแต่งสำหรับคำตอบที่ไม่มีการจำกัด มันไม่ใช่ตัวระบุทั่วไป แต่เป็นจุดชี้เฉพาะไปยังโฮสต์ของเรา
ตรวจสอบเอกสารของไลบรารีไคลเอนต์ของคุณเพื่อดูวิธีตั้งค่ารหัสโมเดล ไลบรารีบางตัวใช้ model ช่อง ในขณะที่อื่นๆ อาจใช้พารามิเตอร์อื่น ความสอดคล้องในการใช้ ID โมเดลตลอดทั้งแอปพลิเคชันของคุณช่วยป้องกันความสับสนและรับประกันว่าคุณจะเรียกใช้โมเดล uncensored ที่ตั้งใจเสมอ
การเกินขีดจำกัดหน้าต่างบริบท
หน้าต่างบริบทจำกัดจำนวนโทเคนรวมที่คุณสามารถส่งในคำขอเดียว API ของเรารองรับหน้าต่างขนาด 100,000 โทเคน ซึ่งรวมถึงคำสั่งและการสร้างผลลัพธ์ การเกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาด
เพื่อจัดการ context ให้ใช้กลยุทธ์ sliding window ลบข้อความเก่าหรือสรุปข้อความเหล่านั้นเพื่อปลดปล่อยพื้นที่ ตรวจสอบจำนวน token ของ input ของคุณเพื่อให้แน่ใจว่าอยู่ในขีดจำกัด 100,000 token หากเกินขีดจำกัด API จะปฏิเสธคำขอ
ใช้ max_tokens พารามิเตอร์สำหรับควบคุมความยาวของผลลัพธ์ ผลลัพธ์สูงสุดต่อคำขอคือ 16,000 tokens การตั้งค่าพารามิเตอร์นี้ช่วยป้องกันการใช้งาน tokens เกินจำเป็นและรักษาขนาด responses ให้เหมาะสมกับแอปพลิเคชันของคุณ
นโยบายสนับสนุนและการคืนเงิน
เครดิตจะไม่ถูกคืนเมื่อถูกใช้งานไปแล้ว แต่เครดิตนี้ไม่มีวันหมดอายุ หากคุณพบปัญหาเกี่ยวกับการชำระเงินหรือบริการ โปรดติดต่อ Support ผ่านหน้าที่กำหนดไว้ ข้อผิดพลาดเช่นการคิดเงินซ้ำจะถูกแก้ไขโดยทีม Support
สำหรับปัญหาทางเทคนิค ให้ตรวจสอบเอกสารก่อน API ของเราใช้งานง่าย แต่อาจมีกรณีขอบเขตที่เกิดขึ้นได้ โปรดระบุคีย์ API และรายละเอียดคำขอเมื่อขอความช่วยเหลือ เวลาในการตอบกลับจะแตกต่างกันไป แต่เราพยายามแก้ไขปัญหาอย่างรวดเร็ว
จำไว้ว่าเครดิตเป็นการชำระล่วงหน้า คุณจ่ายตามสิ่งที่ใช้ โดยข้อผิดพลาดและการปฏิเสธนั้นฟรี โมเดลนี้รับประกันความโปร่งใสในการเรียกเก็บเงิน ใช้หน้าการสนับสนุนสำหรับข้อผิดพลาดหรือคำถามเกี่ยวกับบัญชีของคุณ
