Quick Start Universal LLM Gateway
Tạo API key, lấy model được cấp quyền và gửi request đầu tiên.
Sau khi subscription được kích hoạt, mở Setup Wizard để tạo API key. Secret đầy đủ chỉ hiển thị ở lần tạo hoặc rotate; hãy lưu ngay trong secret manager hoặc biến môi trường.
Luôn gọi GET /v1/models trước khi hard-code model. Kết quả đã được lọc theo API key, subscription, plan, capability và route đang khả dụng.
Điểm cần nhớ
- Đặt API_KEY trong environment, không commit vào source code.
- Dùng Base URL được công bố trong Setup Wizard.
- Gọi GET /v1/models rồi chọn public model ID.
- Chọn stream=false để nhận JSON hoặc stream=true để nhận SSE tăng dần đến marker [DONE].
- Lưu x-routing-request-id để tra cứu routing trace khi cần hỗ trợ.
Request mẫu
curl --request POST 'https://api.xpncore.com/v1/chat/completions' \
--max-time 35 \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "MODEL_ID_FROM_GET_V1_MODELS",
"messages": [
{
"role": "user",
"content": "Hello from the gateway"
}
],
"temperature": 0.7,
"max_tokens": 512,
"stream": false
}'