跳到正文
← 返回接入教程

模型与路由

用你在 6090ti 控制台创建的 API Key,查询模型 ID,再按所用工具选择接口格式。本页说明模型与路由的关系,并提供鉴权、首次调用、SDK、流式输出与错误排查示例。

接入前请确认:下文列出的是各类接口的使用方法,不代表每个模型都已开通这些能力。示例尚未逐项完成 6090ti 实际调用验证;请以当前 Key 的权限、模型所支持的接口及实际调用结果为准。

阅读顺序:准备账户与 Key → 选择接口与鉴权 → 查询模型与理解路由 → OpenAI 调用/Claude 调用 → 客户端接入 → 排查错误。

1. 开始前准备

  1. 进入控制台,注册账户并完成邮箱验证。
  2. 查看账户余额。需要充值时,使用控制台当前提供的充值入口,并在付款前核对支付金额和到账额度。
  3. 在控制台左侧菜单「API 密钥」页面创建自己的 Key,复制并妥善保存。
  4. 查询可用模型,选择与客户端接口格式匹配的模型 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 怎样处理模型路由?

  1. 你选择模型和接口。客户端携带 API Key,将请求发送到 api.6090ti.com 对应的接口路径。
  2. 网关按配置处理请求。请求受 Key 权限、已配置的模型范围、余额和接口支持情况约束;上游账号与路由配置由平台维护,用户不需要填写上游账号或设置路由规则。
  3. 先验证一次调用。用较短输入请求所选模型,核对返回内容和控制台使用记录,再验证流式输出、工具调用或图片等需要的功能。

同一把 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. 在客户端中接入

各客户端的配置步骤见接入教程,每个工具一页:

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