การเชื่อมต่อและการใช้งาน | เอกสาร API

เมื่อการเรียกล้มเหลวหรือบทสนทนาขาดการเชื่อมต่อ ให้ตรวจสามเรื่องด้วยคำขอขั้นต่ำก่อน: การยืนยันตัวตน เส้นทางเอนด์พอยต์ และความพร้อมโมเดล

เชื่อมต่อแพลตฟอร์มไม่ได้?

ตรวจสอบ:

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

สำหรับการเรียกที่เข้ากันได้กับ OpenAI ให้ทดสอบด้วยคำขอขั้นต่ำแบบไม่สตรีม:

bash

curl https://api.apihop.ai/openai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      { "role": "user", "content": "Reply with OK only." }
    ],
    "stream": false
  }'

หากคำขอขั้นต่ำล้มเหลว ปัญหามักอยู่ที่เครือข่าย การยืนยันตัวตน การตั้งค่าเส้นทาง สิทธิ์โมเดล หรือสถานะบัญชี

เลือกโมเดลแล้วแต่ไม่ตอบกลับหรือเกิดข้อผิดพลาด?

สาเหตุทั่วไป:

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

คัดลอก ID โมเดลตรงจากคอนโซลหรือรายการโมเดล ทดสอบด้วยเนื้อหาคำขอขั้นต่ำ แล้วค่อยเพิ่มบริบทและพารามิเตอร์

ทำอย่างไรเมื่อแชตผิดพลาดหรือหลุด?

ระบุจุดที่ล้มเหลว:

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

การจัดการที่แนะนำ:

อ่านฟิลด์ข้อผิดพลาดเฉพาะ
สลับเป็นไม่สตรีมชั่วคราวเพื่อแยกความล้มเหลวโมเดลจากข้อผิดพลาดการแยกสตรีม
เพิ่มการลองใหม่แบบหน่วงเวลาสำหรับ 429 เครือข่ายไม่เสถียร และข้อผิดพลาด 5xx บางประเภท
แนบบริบทที่จำเป็นเมื่อลองใหม่ อย่าสมมติว่ามีสถานะบทสนทนาฝั่งเซิร์ฟเวอร์
บันทึก X-Request-ID หากปัญหายังอยู่