Hướng dẫn cho nhà phát triển

Sprelay cung cấp nhiều giao thức trên cùng một tên miền. Hãy giữ SDK hoặc định dạng yêu cầu mà dự án đang dùng, sau đó chỉ thay URL cơ sở, khóa API và ID mô hình.

Giao thức	Trường hợp sử dụng	Hướng dẫn
Chat Completions	OpenAI SDK và ứng dụng trò chuyện hiện có	Chat Completions
Responses	Agent hiện đại và Codex	Responses
Claude Messages	Anthropic SDK và Claude Code	Claude Messages
Gemini Native	Cấu trúc nội dung gốc của Gemini	Gemini Native
Tạo hình ảnh	Yêu cầu hình ảnh gpt-image-2	Tạo hình ảnh

URL cơ sở

Trường hợp	URL
OpenAI SDK, Chat và Responses	https://sprelaytoken.com/v1
Claude SDK	https://sprelaytoken.com
Gemini SDK gốc	https://sprelaytoken.com
Endpoint Chat đầy đủ	https://sprelaytoken.com/v1/chat/completions
Endpoint hình ảnh đầy đủ	https://sprelaytoken.com/v1/images/generations

Thứ tự xác minh đề xuất

GET /v1/models
  -> yêu cầu tối thiểu không dùng luồng
  -> yêu cầu dạng luồng
  -> gọi công cụ
  -> payload production và chính sách thử lại

Các mũi tên thể hiện thứ tự phụ thuộc: không gỡ lỗi công cụ hoặc thử lại khi yêu cầu văn bản tối thiểu vẫn chưa thành công. Hãy đọc hướng dẫn lỗi API trước khi thêm cơ chế thử lại tự động.

Lưu bí mật trong biến môi trường, đặt thời gian chờ rõ ràng và ghi thời gian, mô hình, trạng thái cùng mã yêu cầu mà không ghi toàn bộ khóa hoặc lời nhắc nhạy cảm. Tham chiếu API ở chế độ chỉ đọc và chỉ chứa endpoint chuyển tiếp công khai đã xác nhận.