เปิด เราเตอร์ การผสานรวม ข้อผิดพลาดที่ควรหลีกเลี่ยง

ใช้ base_url ที่ผิด

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

นักพัฒนาจำนวนมากคัดลอกวางโค้ดที่มีอยู่โดยไม่อัปเดตตัวแปรนี้ หากคุณปล่อย URL ค่าเริ่มต้นไว้ คุณจะได้รับข้อผิดพลาด 404 หรือชนกับโมเดลที่ไม่ได้เป็น uncensored เสมอตรวจสอบการเชื่อมต่อโดยตรวจสอบ /v1/models endpoint. คุณควรเห็น model ID เฉพาะของเราแสดงอยู่ที่นั่น สิ่งนี้ยืนยันว่าการกำหนดเส้นทางถูกต้องก่อนที่จะส่งคำขอ completion ครั้งแรกของคุณ

ลืมที่จะตั้งค่า model id

แม้จะใช้ URL ฐานที่ถูกต้อง การละเว้น ID โมเดลจะทำให้ใช้โมเดลทั่วไปหรือรุ่นเก่าโดยค่าเริ่มต้น คุณต้องตั้งค่า model พารามิเตอร์นี้เพื่อ "uncensored" ในทุกการเรียกข้อมูล สิ่งนี้บอกเลเยอร์การจัดเส้นทางของเราเพื่อให้บริการโมเดล open-weight เฉพาะที่ปรับแต่งสำหรับเนื้อหาที่ไม่มีการจำกัด

หากไม่มีคำแนะนำโดยชัดเจนนี้อาจทำให้คุณได้รับโมเดลอื่นที่มีกฎการปรับแต่งพฤติกรรมต่างกัน โมเดลบางตัวปฏิเสธหัวข้อผู้ใหญ่ที่ถูกต้องตามกฎหมายโดยค่าเริ่มต้น ด้วยการบังคับใช้ uncensored ID, you guarantee the behavior you expect. Check your code for any hardcoded model names that might override your SDK defaults.

ignoring token limits and errors

การเกินหน้าต่างบริบท 100,000 tokens หรือจำกัดผลลัพธ์ 16,000 tokens จะทำให้คำขอล้มเหลวทันที API ของเราจำกัดผลลัพธ์สูงสุดที่ 16,000 tokens ต่อคำขอ หากคุณไม่ได้ตั้งค่า max_tokens, ค่าเริ่มต้นคือเพียง 2,048 tokens สิ่งนี้มักสั้นเกินไปสำหรับงาน complex reasoning

ข้อผิดพลาดและการปฏิเสธไม่ใช้เครดิตล่วงหน้าของคุณ อย่างไรก็ตาม คำขอที่ผิดรูปแบบที่ชนกับขีดจำกัดอัตราหรือเกินขนาดร่างกาย (8 MB) ยังคงนับรวมในโควตาของคุณ ตรวจสอบส่วนหัวของคำตอบของคุณสำหรับการใช้งานโทเคน ปรับการออกแบบพรอมต์ของคุณให้พอดีกับหน้าต่างบริบท สิ่งนี้ป้องกันการทำซ้ำที่มีค่าใช้จ่ายสูงและรับประกันการไหลของข้อมูลที่ราบรื่น

ความเข้าใจผิดเกี่ยวกับการบิลลิ่งแบบเติมเงิน

ยอดเงินในบัญชีของคุณผูกกับเครดิตแบบเติมเงิน ไม่ใช่การสมัครสมาชิกแบบรายเดือน เราคิดเงิน $0.15 ต่อ 1M โทเค็นอินพุต และ $0.50 ต่อ 1M โทเค็นเอาต์พุต ความผิดพลาดไม่คิดเงิน แต่การเสร็จสิ้นที่สำเร็จจะใช้เครดิต คุณต้องเติมเงินผ่านคริปโตเพื่อรักษาความพร้อมใช้งานของบริการ

เรารับชำระด้วย USDT (TRC20) หรือ USDC (Base) สำหรับการเติมเงิน ยอดเงินขั้นต่ำเริ่มต้นที่ $20 โบนัสใช้ได้ที่ระดับที่สูงขึ้น: +5% ตั้งแต่ $50, +10% ตั้งแต่ $100 และ +15% ตั้งแต่ $200 เครดิตของคุณจะไม่หมดอายุ ตรวจสอบให้แน่ใจว่ายอดเงินของคุณเป็นบวกก่อนรันชุดคำสั่งขนาดใหญ่ ตรวจสอบแดชบอร์ดเพื่อยืนยันยอดเงินปัจจุบันและธุรกรรมล่าสุด

การสับสนระหว่างการสตรีมมิ่งกับการตอบกลับมาตรฐาน

การสตรีมผ่าน SSE เปลี่ยนวิธีการ parse สตรีมคำตอบ คำตอบมาตรฐานจะส่งวัตถุ JSON เดียว การสตรีมจะส่งหลาย chunk คุณต้องจัดการกับ chunk สุดท้ายเพื่อรับสถิติการใช้ token ที่แม่นยำ

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

ข้อผิดพลาดในการกำหนดค่า tool_choice

ไม่ถูกต้อง tool_choice การตั้งค่าสามารถทำให้การเรียกฟังก์ชันทำงานไม่ถูกต้องตามที่ตั้งใจ คุณสามารถบังคับใช้เครื่องมือเฉพาะหรือปล่อยให้โมเดลตัดสินใจ การกำหนดค่าผิดพลาดมักส่งผลให้โมเดลละเว้นฟังก์ชันที่มีอยู่

ใช้ tool_choice เพื่อควบคุมว่าโมเดลจะเรียกใช้เครื่องมืออัตโนมัติหรือไม่ ตั้งค่าเป็น "auto" สำหรับความยืดหยุ่นหรือระบุ ID ของเครื่องมือสำหรับพฤติกรรมที่เข้มงวด ตรวจสอบให้แน่ใจว่าคำจำกัดความของฟังก์ชันของคุณตรงกับสคีมาที่คาดหวัง ซึ่งจะช่วยหลีกเลี่ยงข้อผิดพลาดรันไทม์เมื่อโมเดลพยายามเรียกใช้ฟังก์ชันที่ไม่มีอยู่จริง ทดสอบคำจำกัดความของเครื่องมือของคุณอย่างละเอียดก่อนนำไปใช้ในระบบผลิต

โหมด json_object หายไป

Without response_format: {"type": "json_object"}, โมเดลอาจส่งออก markdown หรือข้อความธรรมดา ซึ่งทำให้ parser ที่คาดหวัง JSON อย่างเคร่งครัดล้มเหลว เปิดใช้โหมด JSON เพื่อให้แน่ใจว่าผลลัพธ์สอดคล้องและสามารถ parse ได้

คุณสมบัตินี้จำเป็นสำหรับการผสานรวมกับระบบ downstream ที่ต้องการข้อมูลที่มีโครงสร้าง ช่วยลดภาระการประมวลผลหลังการแยกวิเคราะห์อย่างมีนัยสำคัญ ควรตรวจสอบ schema ของผลลัพธ์ในโค้ดไคลเอนต์ของคุณเสมอ สิ่งนี้ช่วยให้มีความแข็งแกร่งต่อการคาดเดาข้อมูลผิดพลาดของโมเดล occasional ใช้โหมดนี้เมื่อต้องการดึงเอนทิตีหรือสร้างไฟล์กำหนดค่า

ความประหลาดใจจาก rate limit

API ของเราอนุญาตให้ส่งคำขอได้ 300 คำขอต่อนาทีต่อคีย์ การเกินขีดจำกัดนี้จะส่งผลให้เกิดการตอบกลับ 429 Too Many Errors คำขอพร้อมกันจำกัดอยู่ที่ 8 คำขอต่อคีย์ โปรดตั้งค่าการส่งคำขอพร้อมกันของคุณให้เหมาะสม

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

ความล่าช้าในการเติมเงินคริปโต

ธุรกรรมคริปโตอาจใช้เวลาในการยืนยันบนบล็อกเชน เครดิตของคุณอาจไม่ปรากฏทันทีหลังจากส่งเงิน ใช้เครือข่ายที่ถูกต้อง: TRC20 สำหรับ USDT หรือ Base สำหรับ USDC การส่งไปยังเครือข่ายที่ผิดจะทำให้สูญเสียเงิน

เติมเงินเริ่มต้นที่ $20 ถึง $500 ตรวจสอบให้แน่ใจว่าคุณส่งจำนวนที่ถูกต้องหรือคำนวณค่าธรรมเนียมเครือข่าย ตรวจสอบ hash การทำธุรกรรมบน blockchain explorer หากเครดิตล่าช้า ให้ติดต่อฝ่ายสนับสนุนพร้อม ID การทำธุรกรรม อย่าเพิ่งสรุปว่าการชำระเงินล้มเหลวทันที ความอดทนในช่วงที่เครือข่ายแออัดเป็นกุญแจสำคัญสู่การทำงานที่ราบรื่น