Kết nối và sử dụng

Khi lời gọi thất bại hoặc hội thoại gián đoạn, trước hết xác minh ba điều bằng yêu cầu tối thiểu: xác thực, đường dẫn điểm cuối và khả dụng mô hình.

Không kết nối được nền tảng?

Kiểm tra:

• Khóa API được cấu hình đúng, không có khoảng trắng hay xuống dòng thừa.
• URL cơ sở đúng và không chứa đường dẫn lặp.
• Đường dẫn điểm cuối khớp giao thức máy khách, như đường dẫn tương thích OpenAI cho máy khách OpenAI.
• Mạng cục bộ, proxy công ty, tường lửa, DNS hoặc kiểm tra HTTPS có chặn yêu cầu không.
• Khóa API có hết hạn, bị xóa hay thuộc tài khoản hạn chế không.

Với lời gọi tương thích OpenAI, thử yêu cầu tối thiểu không truyền luồng:

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
  }'

Nếu yêu cầu tối thiểu thất bại, vấn đề thường ở mạng, xác thực, cấu hình đường dẫn, quyền mô hình hoặc trạng thái tài khoản.

Đã chọn mô hình nhưng không phản hồi hoặc báo lỗi?

Nguyên nhân thường gặp:

• ID mô hình sai hoặc không khớp danh sách mô hình nền tảng.
• Mô hình đã chọn tạm không khả dụng hoặc không được phép cho khóa API.
• Định dạng yêu cầu không hợp lệ, như sai tên trường, lồng cấp hoặc kiểu.
• Tài khoản thiếu số dư, ngữ cảnh quá dài, đầu ra quá dài hoặc dịch vụ hết thời gian chờ.
• Máy khách bên thứ ba không xử lý đúng truyền luồng hoặc phản hồi lỗi.

Sao chép đúng ID mô hình từ bảng điều khiển hoặc danh sách mô hình, thử thân yêu cầu tối thiểu, rồi thêm lại ngữ cảnh và tham số dần dần.

Nếu trò chuyện báo lỗi hoặc mất kết nối thì sao?

Xác định lỗi ở đâu:

• Trước khi bắt đầu yêu cầu: kiểm tra xác thực, đường dẫn, mô hình và tham số.
• Trong lúc truyền luồng: kiểm tra thời gian chờ máy khách, chuỗi proxy và phân tích SSE.
• Với ngữ cảnh dài hoặc đầu ra dài: kiểm tra kích thước yêu cầu, giới hạn đầu ra và thời gian chờ dịch vụ.

Cách xử lý khuyến nghị:

1. Đọc các trường lỗi cụ thể.
2. Tạm chuyển sang không truyền luồng để phân biệt lỗi mô hình với lỗi phân tích luồng.
3. Thêm thử lại với thời gian chờ tăng dần cho 429, mạng không ổn định và một số lỗi 5xx.
4. Đính kèm ngữ cảnh cần thiết khi thử lại thay vì giả định có trạng thái hội thoại phía máy chủ.
5. Ghi X-Request-ID nếu vấn đề tiếp diễn.