模型与路由
用你在 6090ti 控制台创建的 API Key,查询模型 ID,再按所用工具选择接口格式。本页说明模型与路由的关系,并提供鉴权、首次调用、SDK、流式输出与错误排查示例。
接入前请确认:下文列出的是各类接口的使用方法,不代表每个模型都已开通这些能力。示例尚未逐项完成 6090ti 实际调用验证;请以当前 Key 的权限、模型所支持的接口及实际调用结果为准。
阅读顺序:准备账户与 Key → 选择接口与鉴权 → 查询模型与理解路由 → OpenAI 调用/Claude 调用 → 客户端接入 → 排查错误。
- 官网:www.6090ti.com
- 用户控制台:进入控制台
- 模型 API 网关:
https://api.6090ti.com - 客服邮箱:6090tihelp@6090ti.com
QQ用户群:1109931264
1. 开始前准备
- 进入控制台,注册账户并完成邮箱验证。
- 查看账户余额。需要充值时,使用控制台当前提供的充值入口,并在付款前核对支付金额和到账额度。
- 在控制台左侧菜单「API 密钥」页面创建自己的 Key,复制并妥善保存。
- 查询可用模型,选择与客户端接口格式匹配的模型 ID。
API Key 用于调用模型;邮箱和登录密码用于登录控制台。不要把登录密码填入客户端的 API Key 输入框。
钱包额度和模型价格使用 USD 展示;充值付款使用 CNY,具体到账额度以订单显示为准。调用记录、Token 用量和消费可在控制台「使用记录」中查看。
示例中的占位文字
下文示例直接把 Key 写在命令和代码里。使用前,把 <你的 Key> 换成你在控制台创建的 Key,把 <对话模型名> 这类模型占位换成实际模型名(查询方法见第 3 节)。命令在你自己的电脑或服务器运行。
带有真实 Key 的命令和代码不要提交到代码仓库、截图或发给他人。
2. 选择正确的接口格式
| 使用方式 | SDK/客户端 Base URL | 完整请求路径 | 适用场景 |
|---|---|---|---|
| OpenAI Chat Completions | https://api.6090ti.com/v1 |
POST /v1/chat/completions |
对话程序及支持该格式的客户端 |
| OpenAI Responses | https://api.6090ti.com/v1 |
POST /v1/responses |
Codex 及使用 Responses 的应用 |
| Anthropic Messages | https://api.6090ti.com |
POST /v1/messages |
Claude Code、Claude 模型原生格式调用 |
接口格式由客户端和所选模型共同决定。模型出现在列表中,不代表它能使用表内所有接口;请按模型实际开通的方式调用。
Base URL 和完整请求地址是两种填法。 SDK 通常会追加方法路径,因此不要把 /chat/completions 填进 SDK 的 Base URL。客户端若有「完整 URL」开关,则按该开关的要求填写,避免出现 /v1/v1 或重复的方法路径。
请求头
OpenAI 格式:
Authorization: Bearer <你的 Key>
Content-Type: application/json
Anthropic 格式:
x-api-key: <你的 Key>
anthropic-version: 2023-06-01
Content-Type: application/json
把 Key 放在请求头或客户端专用的密钥设置中,不要放在网址参数里。
3. 查询可用模型
请求 GET https://api.6090ti.com/v1/models,查看当前 Key 可见的模型 ID。
Windows PowerShell:
$headers = @{ Authorization = "Bearer <你的 Key>" }
$models = Invoke-RestMethod -Method Get -Uri "https://api.6090ti.com/v1/models" -Headers $headers
$models | ConvertTo-Json -Depth 20
macOS/Linux:
curl --fail-with-body "https://api.6090ti.com/v1/models" \
-H "Authorization: Bearer <你的 Key>"
从返回的模型项中复制 id。示例中的 <对话模型名>、<Responses 模型名> 和 <Claude 模型名> 都是占位文字,需要替换为对应接口实际可用的模型 ID。
模型列表用于确认名称;价格页用于查看价格。实际调用还受 Key 权限、余额及接口支持情况约束。
模型 ID 应该填什么?
在请求的 model 字段或客户端的模型输入框中,填写当前 Key 查询结果里的精确 id。保留大小写、连字符、小数点和版本后缀,不用页面上的中文显示名代替 ID,也不要自行拼接厂商前缀。
控制台「模型名称」中的列表方便查找和复制,是平台维护的展示名单。它与使用你自己的 Key 请求 /v1/models 得到的结果用途不同;出现在展示名单中,不等于该 Key 已获准调用。模型查询成功,也不等于所有接口、工具调用、图片或缓存能力都已验证可用。
6090ti 怎样处理模型路由?
- 你选择模型和接口。客户端携带 API Key,将请求发送到
api.6090ti.com对应的接口路径。 - 网关按配置处理请求。请求受 Key 权限、已配置的模型范围、余额和接口支持情况约束;上游账号与路由配置由平台维护,用户不需要填写上游账号或设置路由规则。
- 先验证一次调用。用较短输入请求所选模型,核对返回内容和控制台使用记录,再验证流式输出、工具调用或图片等需要的功能。
同一把 Key 能否调用多个厂商的模型,取决于平台为它开通的范围。更换模型时,需要同时确认工具与接口是否匹配;同一把 Key 不代表所有模型都能使用同一个接口。不要把模型 ID 写成 auto、路由名称或任意别名,除非平台明确提供了这个精确 ID。
本页按你明确指定模型的方式接入。自动选择其他模型、失败后切换厂商,以及第三方平台的 Fast 模式、速度与计费倍率,均不作为本页的默认能力或承诺。
更换模型前核对四项
| 核对项 | 操作 |
|---|---|
| 模型名称 | 使用当前 Key 查询模型,复制精确 ID;不要直接沿用其他平台的模型表。 |
| 接口格式 | 按第 2 节选择客户端支持且模型已开通的接口。Claude 优先用 Messages,Responses 模型须确认支持 Responses。 |
| 价格与权限 | 查看模型价格及控制台;模型可见不等于余额充足,也不能据此推断缓存、图片等项目的价格。 |
| 实际结果 | 先验证一条短请求,再检查所需功能和使用记录。出错时核对错误正文、模型 ID 与路径;超时后先查记录,再决定是否重试。 |
4. OpenAI 格式调用
4.1 第一次请求:Chat Completions
在当前目录新建 request.json,内容如下,替换模型 ID 后保存:
{
"model": "<对话模型名>",
"messages": [
{"role": "user", "content": "Reply with OK only."}
]
}
Windows PowerShell:
$headers = @{ Authorization = "Bearer <你的 Key>" }
$body = Get-Content -LiteralPath ".\request.json" -Raw -Encoding UTF8
$result = Invoke-RestMethod -Method Post -Uri "https://api.6090ti.com/v1/chat/completions" -Headers $headers -ContentType "application/json; charset=utf-8" -Body ([Text.Encoding]::UTF8.GetBytes($body))
$result.choices[0].message.content
macOS/Linux:
curl --fail-with-body "https://api.6090ti.com/v1/chat/completions" \
-H "Authorization: Bearer <你的 Key>" \
-H "Content-Type: application/json" \
--data-binary @request.json
普通文本回答位于 choices[0].message.content。成功时返回内容类似下面(节选,数字仅为示例):
{
"object": "chat.completion",
"model": "<对话模型名>",
"choices": [
{"index": 0, "message": {"role": "assistant", "content": "OK"}, "finish_reason": "stop"}
],
"usage": {"prompt_tokens": 12, "completion_tokens": 1, "total_tokens": 13}
}
收到回复后,可到控制台「使用记录」查看本次调用。
4.2 Python SDK
先安装 SDK。Windows 使用 py -m pip install openai,macOS/Linux 使用 python3 -m pip install openai。建议在自己的虚拟环境中安装。
保存为 quickstart.py:
from openai import OpenAI
client = OpenAI(
api_key="<你的 Key>",
base_url="https://api.6090ti.com/v1",
timeout=120.0,
max_retries=0,
)
reply = client.chat.completions.create(
model="<对话模型名>",
messages=[{"role": "user", "content": "Reply with OK only."}],
)
print(reply.choices[0].message.content)
Windows 运行 py quickstart.py;macOS/Linux 运行 python3 quickstart.py。
示例中的超时是客户端等待设置,不代表服务端承诺的最长执行时间。首次排查关闭 SDK 自动重试,便于识别每次请求。
4.3 Responses API
使用上一节已经创建的 client,把请求部分换成:
reply = client.responses.create(
model="<Responses 模型名>",
input="Reply with OK only.",
)
print(reply.output_text)
Responses 使用 input,Chat Completions 使用 messages。读取原始 JSON 时,Responses 的结果在 output 数组中;output_text 是 SDK 提供的便捷读取方式。OpenAI 文本生成文档
4.4 Node.js SDK
在自己的项目目录运行 npm install openai。保存以下内容为 quickstart.mjs:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "<你的 Key>",
baseURL: "https://api.6090ti.com/v1",
timeout: 120000,
maxRetries: 0,
});
const reply = await client.responses.create({
model: "<Responses 模型名>",
input: "Reply with OK only.",
});
console.log(reply.output_text);
Windows、macOS 和 Linux 都运行 node quickstart.mjs。如果需要 Chat Completions,将请求部分换成:
const reply = await client.chat.completions.create({
model: "<对话模型名>",
messages: [{ role: "user", content: "Reply with OK only." }],
});
console.log(reply.choices[0].message.content);
4.5 流式输出
流式输出会逐步返回生成内容。Python 中沿用前面的 OpenAI client:
events = client.chat.completions.create(
model="<对话模型名>",
messages=[{"role": "user", "content": "Write a four-line poem."}],
stream=True,
)
for event in events:
if event.choices:
text = event.choices[0].delta.content
if text:
print(text, end="", flush=True)
print()
直接读取 SSE 时,Chat Completions 通常通过 data: 行发送增量,以 data: [DONE] 结束。Responses 使用自己的事件类型,例如 response.output_text.delta;需同时处理完成、失败及未完整结束的状态,不能只因收到 HTTP 200 就判定生成成功。
5. Anthropic 原生格式
Claude Code 和使用 Anthropic 格式的应用填写根地址:https://api.6090ti.com。
Claude 模型优先使用本节的原生格式(/v1/messages)。 用 OpenAI 兼容格式调用 Claude 时,提示缓存、思考等能力可能无法使用,费用也可能更高,只适合简单对话。Claude Code 等 Agent 工具必须按 Anthropic 格式配置。
5.1 第一次请求
在当前目录新建 claude-request.json,内容如下,替换模型 ID 后保存:
{
"model": "<Claude 模型名>",
"max_tokens": 512,
"messages": [
{"role": "user", "content": "Reply with OK only."}
]
}
Windows PowerShell:
$headers = @{ "x-api-key" = "<你的 Key>"; "anthropic-version" = "2023-06-01" }
$body = Get-Content -LiteralPath ".\claude-request.json" -Raw -Encoding UTF8
$result = Invoke-RestMethod -Method Post -Uri "https://api.6090ti.com/v1/messages" -Headers $headers -ContentType "application/json; charset=utf-8" -Body ([Text.Encoding]::UTF8.GetBytes($body))
$result.content | Where-Object { $_.type -eq "text" } | ForEach-Object { $_.text }
macOS/Linux:
curl --fail-with-body "https://api.6090ti.com/v1/messages" \
-H "x-api-key: <你的 Key>" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
--data-binary @claude-request.json
成功时返回内容类似下面(节选,数字仅为示例):
{
"type": "message",
"role": "assistant",
"model": "<Claude 模型名>",
"content": [{"type": "text", "text": "OK"}],
"stop_reason": "end_turn",
"usage": {"input_tokens": 14, "output_tokens": 4}
}
文本位于 content 数组中 type 为 text 的块。
5.2 Python SDK
Windows 安装:py -m pip install anthropic。macOS/Linux 安装:python3 -m pip install anthropic。
保存为 claude_example.py:
from anthropic import Anthropic
client = Anthropic(
api_key="<你的 Key>",
base_url="https://api.6090ti.com",
timeout=120.0,
max_retries=0,
)
reply = client.messages.create(
model="<Claude 模型名>",
max_tokens=512,
messages=[{"role": "user", "content": "Reply with OK only."}],
)
for block in reply.content:
if block.type == "text":
print(block.text)
Windows 运行 py claude_example.py;macOS/Linux 运行 python3 claude_example.py。max_tokens 是本次输出上限,按所选模型要求调整。
5.3 流式输出
命令行调用时,在 claude-request.json 中加入 "stream": true,curl 命令加上 -N 以便即时显示。响应为 SSE 事件流,依次为 message_start、content_block_start、若干 content_block_delta、content_block_stop、message_delta、message_stop。
Python 中,将上面的 reply 请求和输出部分换成:
with client.messages.stream(
model="<Claude 模型名>",
max_tokens=512,
messages=[{"role": "user", "content": "Write a four-line poem."}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
print()
原始 HTTP 请求需携带 anthropic-version: 2023-06-01;官方 SDK 会处理相应请求头。客户端需要处理流内错误,不能把连接结束一概当作成功。Anthropic 流式调用文档
5.4 提示缓存
Claude 的提示缓存需要调用方显式开启:在要重复使用的内容末尾加上 "cache_control": {"type": "ephemeral"}。不加就不会缓存,控制台的缓存读取和写入都会是 0。常见位置是较长的固定系统提示词、工具列表的最后一项和最新一条消息。
把下面内容保存为 cache-request.json,将 <较长且固定的系统提示词> 换成你自己的长系统提示词:
{
"model": "<Claude 模型名>",
"max_tokens": 512,
"system": [
{"type": "text", "text": "<较长且固定的系统提示词>", "cache_control": {"type": "ephemeral"}}
],
"messages": [
{"role": "user", "content": "Reply with OK only."}
]
}
用 5.1 节的命令发送两次,把文件名 claude-request.json 换成 cache-request.json。返回的 usage 中,cache_creation_input_tokens 是缓存写入,cache_read_input_tokens 是缓存读取;第一次通常只有写入,短时间内的第二次应出现读取。
注意两点:缓存按前缀匹配,打了标记的位置之前的内容(系统提示词、工具、历史消息)每次都要保持一致,改动任何一处,其后的缓存都会失效;内容太短、未达到所选模型的最小缓存长度时不会缓存。Python SDK 在 system 参数中传入同样的结构即可。缓存写入、读取的价格以价格页和控制台显示为准。Anthropic 提示缓存文档
6. 在客户端中接入
各客户端的配置步骤见接入教程,每个工具一页:
- Codex 命令行
- Codex 桌面版
- Claude Code
- Claude Desktop
- CC Switch
- OpenCode
- OpenClaw
- Cline
- Cherry Studio
- WorkBuddy
- TRAE
- DeepSeek Harness
7. 常见问题
401:认证失败
检查 Key 是否完整、是否多出空格、是否已停用,以及请求是否真正携带鉴权头。确认使用的是 6090ti Key,不是登录密码或其他平台的 Key。
再核对鉴权头与接口格式是否对应:Anthropic 格式用 x-api-key,OpenAI 格式用 Authorization: Bearer。错误信息中的常见代码:INVALID_API_KEY 表示 Key 不正确,API_KEY_DISABLED 表示 Key 已停用。另外注意地址写法:OpenAI SDK 的 Base URL 带 /v1,Anthropic SDK 不带。
400:请求参数不正确
检查请求体是否符合所用接口格式,模型是否支持当前参数。先用本文最小示例排查,再逐项增加工具、图片、思考强度等可选参数。
403:余额不足或权限问题
以错误体中的代码区分原因:INSUFFICIENT_BALANCE 表示账户余额不足,到控制台充值后重试;API_KEY_EXPIRED 表示 Key 已过期,需新建 Key;其他代码按提示核对 Key 权限或模型限制。不要仅通过改模型名称反复重试。
404:地址或模型找不到
检查是否填错完整请求 URL、是否出现 /v1/v1,以及模型 ID 是否与列表一致。不要把官网或 /dashboard/ 地址当 API 网关。
429:请求受限
先检查是否短时间重复请求、并发过高,或 Key 额度已用完(错误代码 API_KEY_QUOTA_EXHAUSTED)。返回 Retry-After 时按提示等待;自动重试应限制次数并逐步增加等待时间。
一直等待,或中途断开
先用短请求检查连通性。大模型在思考阶段首字延迟数秒到数十秒属正常,不代表请求失败。较长生成建议使用流式输出,并把客户端超时调大。连接中断不等于请求没有执行;先查看控制台记录,再决定是否重发,避免重复任务或消费。
能问答,但工具或图片不可用
普通文本连通只说明基础调用正常。检查模型的工具/视觉能力、所选接口和客户端适配方式,再分别测试相关功能。
用 OpenAI 格式调 Claude:报错、变贵或效果差
Claude 模型请使用 Anthropic 原生格式(/v1/messages)调用,见第 5 节。OpenAI 兼容格式调用 Claude 可能丢失提示缓存、思考等能力,只适合简单对话。
为什么缓存用量是 0?
Claude 的提示缓存需要在请求中显式加 cache_control 标记,不加就不会缓存,写法见第 5.4 节。用 OpenAI 兼容格式调用 Claude 通常不会自动开启缓存;内容太短、未达到模型最小缓存长度,或每次请求的系统提示词、工具列表有变化,也不会命中缓存。其他模型的缓存规则以对应模型为准。缓存写入、读取和普通输入的价格以实际计价规则为准。
如何查看消费?
进入控制台查看使用记录、Token 用量、消费和余额。钱包变动与订单到账按控制台记录核对,模型接口返回的 usage 不等于完整的金额账单。
Key 泄露怎么办?
立即在控制台停用或删除泄露的 Key,创建替代 Key,并更新使用它的程序。退出登录或修改登录密码不能代替撤销 Key。不要把完整 Key 放在网页前端、公开仓库、截图或问题反馈里。
联系客服
发送邮件至 6090tihelp@6090ti.com,附上客户端与版本、模型 ID、接口路径、发生时间和时区、请求 ID(如有),以及脱敏后的错误信息。不要发送完整 Key、密码或验证码。Telegram、QQ 等其他联系方式见客服联系方式与问题反馈指南。
QQ用户群:1109931264