Kết nối API và IDE mà không phải mò cấu hình.
Bắt đầu bằng một API key và một base URL, sau đó mở hướng dẫn dành riêng cho IDE bạn dùng.
Thông tin dùng chung
Base URL
https://api.premiumshop.tech/v1API key
sk_shop_....<secret>Model mẫu
gpt-5.6-lunaBắt đầu nhanh
Tạo API key
Mỗi app nên có key riêng. Secret đầy đủ có dạng sk_shop_....<secret> và chỉ hiển thị một lần.
Chọn model
Gọi GET /v1/models hoặc xem trang Model AI để sao chép đúng mã model đang hoạt động.
Gọi API
Dùng chuẩn OpenAI-compatible với Authorization: Bearer sk_shop_....<secret>.
Gọi thử chat completions
curl https://api.premiumshop.tech/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk_shop_....<secret>" \
-d '{"model":"gpt-5.6-luna","reasoning_effort":"max","messages":[{"role":"user","content":"hello"}]}'Ví dụ SDK
Dùng OpenAI SDK quen thuộc, đổi `base_url` / `baseURL` sang Premium Shop.
Python
import httpx
from openai import OpenAI
client = OpenAI(
api_key="sk_shop_....<secret>",
base_url="https://api.premiumshop.tech/v1",
http_client=httpx.Client(trust_env=False),
)
response = client.chat.completions.create(
model="gpt-5.6-luna",
reasoning_effort="max",
messages=[{"role": "user", "content": "hello"}],
)
print(response.choices[0].message.content)Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.PREMIUMSHOP_API_KEY,
baseURL: "https://api.premiumshop.tech/v1",
});
const response = await client.chat.completions.create({
model: "gpt-5.6-luna",
reasoning_effort: "max",
messages: [{ role: "user", content: "hello" }],
});
console.log(response.choices[0]?.message?.content);Model, reasoning_effort và hệ số token
Có thể gọi ID chuẩn cx/... hoặc alias không tiền tố cx/. Hỗ trợ reasoning_effort low / medium / high / xhigh / max; backend dùng combo 9router do admin cấu hình. Non-max dùng combo mặc định, max dùng combo -max.
GPT 5.6 Luna
cx/gpt-5.6-luna
alias: gpt-5.6-luna
Non-max: 1x · gpt5.6-luna
Max: 2x · gpt5.6-luna-max
GPT 5.6 Terra
cx/gpt-5.6-terra
alias: gpt-5.6-terra
Non-max: 1.5x · gpt5.6-terra
Max: 2x · gpt5.6-terra-max
GPT 5.6 Sol
cx/gpt-5.6-sol
alias: gpt-5.6-sol
Non-max: 2x · gpt5.6-sol
Max: 2.5x · gpt5.6-sol-max
Tạo file môi trường tự động
Script chỉ tạo file env hỗ trợ trong thư mục ~/.premiumshop; không cài CLI và không tự sửa shell profile. Nạp file được tạo trước khi chạy công cụ.
Claude Code
Tạo env cho Claude Code: ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN và ANTHROPIC_BASE_URL.
Linux / macOS
curl -fsSL https://premiumshop.tech/install/claude/setup.sh | bashWindows PowerShell
irm https://premiumshop.tech/install/claude/setup.ps1 | iexCodex CLI
Tạo env OpenAI-compatible cho Codex CLI: OPENAI_API_KEY và OPENAI_BASE_URL.
Linux / macOS
curl -fsSL https://premiumshop.tech/install/codex/setup.sh | bashWindows PowerShell
irm https://premiumshop.tech/install/codex/setup.ps1 | iexOpenAI-compatible
Tạo env chung cho SDK/tool dùng chuẩn OpenAI-compatible.
Linux / macOS
curl -fsSL https://premiumshop.tech/install/openai/setup.sh | bashWindows PowerShell
irm https://premiumshop.tech/install/openai/setup.ps1 | iexChọn IDE để xem hướng dẫn cấu hình
Mỗi công cụ có một trang riêng với bước cài, cấu hình, ví dụ và cách xử lý lỗi thường gặp.
01
Claude Code
AI coding assistant chạy trong terminal, phù hợp khi muốn sửa code trực tiếp trong repo.
02
Claude Cowork / Desktop
Kết nối Claude Cowork hoặc Claude Desktop qua Third-Party Inference Gateway.
03
Codex CLI
OpenAI coding assistant trong terminal, dùng cấu hình OpenAI-compatible.
04
Cursor IDE
Cấu hình Cursor dùng Premium Shop làm OpenAI-compatible backend.
05
Cline
VS Code extension hỗ trợ sửa nhiều file, terminal, browser và MCP.
06
Continue
AI coding assistant mã nguồn mở cho VS Code và JetBrains.
07
Windsurf
IDE hỗ trợ AI với Cascade và cấu hình OpenAI-compatible tùy chỉnh.
08
Zed
Editor hiệu năng cao viết bằng Rust, có AI assistant tích hợp.
09
Kilo Code
VS Code AI coding extension, phát triển từ Cline với UX cải tiến.
10
Aider
AI pair programming trong terminal, hỗ trợ Git, multi-file editing và commit.
11
OpenClaw
AI coding assistant mã nguồn mở với giao diện quản lý và kết nối OpenAI-compatible.
Lỗi API thường gặp
401 Missing/Invalid API keyKiểm tra header Authorization, key bắt đầu bằng sk_shop_ và key chưa bị thu hồi.
Model not found / 403Gọi GET /v1/models rồi dùng đúng model id được bật trong gói.
Insufficient quotaMua gói chính hoặc thêm token bổ sung. Token bổ sung không thay đổi tốc độ gọi của gói chính.
Sai endpointBase URL là https://api.premiumshop.tech/v1; chat endpoint đầy đủ là https://api.premiumshop.tech/v1/chat/completions.
Bảo mật
Mỗi ứng dụng dùng key riêng; thu hồi ngay khi key bị lộ.
Hướng dẫn riêng
Mỗi IDE có hướng dẫn cấu hình ngắn, dễ chia sẻ với đội của bạn.
Model
Luôn lấy mã model mới nhất từ GET /v1/models.