Xác thực và địa chỉ

Gửi khóa API trong header yêu cầu. Không đặt khóa trong URL, JavaScript frontend, cấu hình công khai hoặc nhật ký ứng dụng thông thường.

Tương thích OpenAI và Responses

Authorization: Bearer sk-your-key
Content-Type: application/json

Sau Bearer phải có đúng một dấu cách. Chỉ thay sk-your-key. URL cơ sở là:

https://sprelaytoken.com/v1

Claude Messages

x-api-key: sk-your-key
anthropic-version: 2023-06-01
content-type: application/json

x-api-key chứa khóa không có tiền tố Bearer. anthropic-version chọn phiên bản giao thức. Claude SDK dùng URL cơ sở gốc sau và tự nối /v1/messages:

https://sprelaytoken.com

Gemini Native

x-goog-api-key: sk-your-key
Content-Type: application/json

Mô hình nằm trong đường dẫn yêu cầu gốc:

https://sprelaytoken.com/v1beta/models/{model}:generateContent

Biến môi trường

macOS / Linux

# Chỉ thay giá trị mẫu; các lệnh sau sẽ đọc biến này.
export SPRELAY_API_KEY="sk-your-key"

Windows PowerShell

# Giá trị này là tạm thời và chỉ áp dụng cho phiên PowerShell hiện tại.
$env:SPRELAY_API_KEY = "sk-your-key"

.env (không commit)

# .env dùng KEY=VALUE, không có export và không có khoảng trắng quanh dấu bằng.
SPRELAY_API_KEY=sk-your-key

Thêm .env vào .gitignore. Chỉ commit tệp .env.example trống.

Lỗi URL thường gặp

URL kết quả	Nguyên nhân
.../v1/v1/chat/completions	Cả ứng dụng và cấu hình đều nối /v1
.../chat/completions/chat/completions	Endpoint đầy đủ được nhập vào trường Base URL
Đường dẫn Claude với JSON OpenAI	Endpoint và nội dung yêu cầu dùng hai giao thức khác nhau
Gemini SDK gửi Bearer header ngoài dự kiến	SDK yêu cầu tùy chọn API key hoặc x-goog-api-key