三项配置
Base URLhttps://api1688.net/v1
API Key用户控制台创建
modeldeepseek-v4-flash
协议OpenAI Compatible
工具接入教程
Claude Code、Cline、Cursor、ChatBox、Cherry Studio 的配置核心一致:Base URL、API Key、model。
Claude Code
使用 Anthropic-compatible 入口时,Base URL 填 APIMAX API 地址,API Key 填用户控制台创建的 Key。
https://api1688.net/v1
Cline
选择 OpenAI Compatible / OpenAI API,Base URL 使用 APIMAX,模型名填控制台模型卡片。
https://api1688.net/v1
Cursor
在自定义 OpenAI 地址里填写 Base URL,API Key 使用用户控制台创建的 Key。
https://api1688.net/v1
ChatBox
供应商选择 OpenAI,自定义 API Host 为 APIMAX Base URL,模型名按价格页填写。
https://api1688.net/v1
Cherry Studio
新增 OpenAI Compatible 服务,填 Base URL、API Key,并同步模型列表或手动填模型。
https://api1688.net/v1
curl 示例
curl https://api1688.net/v1/chat/completions \
-H "Authorization: Bearer 你的_API_Key" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"你好"}]}'
模型目录 API
| 接口 | 鉴权 | 用途 |
|---|---|---|
GET https://api1688.net/public/models.json | 无需 Key | 公开模型名、人民币价格、能力标签、可用端点。 |
GET https://api1688.net/v1/models | Bearer API Key | OpenAI-compatible 模型列表,适合 SDK 和已登录用户。 |
GET https://api1688.net/openapi.json | 无需 Key | 机器可读 OpenAPI 3.1 文档。 |
curl https://api1688.net/public/models.json
curl https://api1688.net/v1/models \
-H "Authorization: Bearer 你的_API_Key"
Python 示例
from openai import OpenAI
client = OpenAI(api_key="你的_API_Key", base_url="https://api1688.net/v1")
resp = client.chat.completions.create(
model="deepseek-v4-flash",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
常见错误
| 状态 | 含义 | 处理方式 |
|---|---|---|
| 401 | API Key 无效 | 检查 Key 是否复制完整。 |
| 402 | 余额不足 | 充值或联系管理员确认订单。 |
| 403 | Key 被停用或模型不匹配 | 检查 Key 绑定模型。 |
| 429 | 请求过快 | 降低并发或稍后重试。 |
| 500/502 | 上游异常 | 稍后重试,或联系管理员检查上游。 |