Tài liệu API

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/v1

API key

sk_shop_....<secret>

Model mẫu

gpt-5.6-luna

Bắ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"}]}'
Không đặt API key trong frontend bundle, mobile app, URL, repository hoặc log.

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);
GPT 5.6 Luna/Terra/Sol

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

Cấu hình tự động

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 | bash

Windows PowerShell

irm https://premiumshop.tech/install/claude/setup.ps1 | iex

Codex 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 | bash

Windows PowerShell

irm https://premiumshop.tech/install/codex/setup.ps1 | iex

OpenAI-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 | bash

Windows PowerShell

irm https://premiumshop.tech/install/openai/setup.ps1 | iex
Kết nối IDE

Chọ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.

Xem tất cả IDE

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.

Terminal-first coding, refactor nhiều file, hỏi nhanh về repo.
Xem hướng dẫn

02

Claude Cowork / Desktop

Kết nối Claude Cowork hoặc Claude Desktop qua Third-Party Inference Gateway.

Dùng giao diện desktop Claude với gateway riêng.
Xem hướng dẫn

03

Codex CLI

OpenAI coding assistant trong terminal, dùng cấu hình OpenAI-compatible.

Agent coding trong terminal, repo tasks, prompt nhanh.
Xem hướng dẫn

04

Cursor IDE

Cấu hình Cursor dùng Premium Shop làm OpenAI-compatible backend.

Chat, inline edit, composer và autocomplete trong Cursor.
Xem hướng dẫn

05

Cline

VS Code extension hỗ trợ sửa nhiều file, terminal, browser và MCP.

Tác vụ coding có tool use và chỉnh sửa dự án trong VS Code.
Xem hướng dẫn

06

Continue

AI coding assistant mã nguồn mở cho VS Code và JetBrains.

Chat, inline edit và autocomplete trong IDE quen thuộc.
Xem hướng dẫn

07

Windsurf

IDE hỗ trợ AI với Cascade và cấu hình OpenAI-compatible tùy chỉnh.

Cascade Chat, command mode, refactor theo luồng trong IDE.
Xem hướng dẫn

08

Zed

Editor hiệu năng cao viết bằng Rust, có AI assistant tích hợp.

Editor nhanh, AI assistant gọn, cấu hình qua settings JSON.
Xem hướng dẫn

09

Kilo Code

VS Code AI coding extension, phát triển từ Cline với UX cải tiến.

Chat Mode, Auto Mode, sửa code có context @file/@folder.
Xem hướng dẫn

10

Aider

AI pair programming trong terminal, hỗ trợ Git, multi-file editing và commit.

Sửa code trong terminal với diff/commit rõ ràng.
Xem hướng dẫn

11

OpenClaw

AI coding assistant mã nguồn mở với giao diện quản lý và kết nối OpenAI-compatible.

Gateway, giao diện quản lý và coding assistant mã nguồn mở.
Xem hướng dẫn
Xử lý lỗi

Lỗi API thường gặp

401 Missing/Invalid API key

Kiểm tra header Authorization, key bắt đầu bằng sk_shop_ và key chưa bị thu hồi.

Model not found / 403

Gọi GET /v1/models rồi dùng đúng model id được bật trong gói.

Insufficient quota

Mua 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 endpoint

Base 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.