开发者接入

产品简介

TKOneGEO 的统一大模型调用接口，完全兼容 OpenAI API 协议——改两行代码（Base URL + API Key）即可无缝接入。

• OpenAI 兼容：任何支持 OpenAI SDK / API 规范的客户端、框架、应用都能直接使用
• 多模型聚合：一个 Key 调用平台上线的全部模型（对话、图像、语音、向量等）
• 透明计费：按 token 用量计费，价格页明码标价，日志页逐笔可查

快速开始

第一次请求示例

curl https://tkonegeo.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxx" \
  -d '{
    "model": "deepseek-r1",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://tkonegeo.com/v1",
    api_key="sk-xxxx",
)

stream = client.chat.completions.create(
    model="deepseek-r1",
    messages=[{"role": "user", "content": "Hello!"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://tkonegeo.com/v1",
  apiKey: "sk-xxxx",
});

const stream = await client.chat.completions.create({
  model: "deepseek-r1",
  messages: [{ role: "user", content: "Hello!" }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

鉴权

所有网关接口通过 HTTP Header 携带 API Key 鉴权。请在「应用管理」中创建应用后获取 Key。

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxx

注意：请勿将 API Key 提交到公开代码仓库或分享给他人。如 Key 泄露，请立即在应用管理中禁用或重新生成。

接口文档

Base URL 为 {站点地址}/v1，协议为 OpenAI API 兼容，JSON 请求 / 响应，流式为 SSE。本站点为 https://tkonegeo.com/v1。

模型接口

curl https://tkonegeo.com/v1/models \
  -H "Authorization: Bearer sk-xxxx"

curl https://tkonegeo.com/v1/models/deepseek-r1 \
  -H "Authorization: Bearer sk-xxxx"

对话接口

curl https://tkonegeo.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxx" \
  -d '{
    "model": "deepseek-r1",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": true
  }'

from openai import OpenAI

client = OpenAI(base_url="https://tkonegeo.com/v1", api_key="sk-xxxx")
resp = client.chat.completions.create(
    model="deepseek-r1",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

curl https://tkonegeo.com/v1/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxx" \
  -d '{"model":"deepseek-r1","prompt":"Hello"}'

curl https://tkonegeo.com/v1/edits \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxx" \
  -d '{"model":"deepseek-r1","instruction":"把语气改得更正式"}'

向量接口

curl https://tkonegeo.com/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxx" \
  -d '{"model":"text-embedding-3-small","input":"Hello"}'

图像接口

curl https://tkonegeo.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxx" \
  -d '{"model":"dall-e-3","prompt":"a green glass city","size":"1024x1024"}'

语音接口

curl https://tkonegeo.com/v1/audio/transcriptions \
  -H "Authorization: Bearer sk-xxxx" \
  -F "file=@audio.mp3" \
  -F "model=whisper-1"

curl https://tkonegeo.com/v1/audio/speech \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxx" \
  -d '{"model":"tts-1","input":"你好","voice":"alloy"}'

内容审核

响应结构

返回 OpenAI 标准格式，用量在 usage 字段：

{
  "id": "chatcmpl-xxx",
  "model": "deepseek-chat",
  "choices": [{ "message": { "role": "assistant", "content": "..." } }],
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 42,
    "total_tokens": 57
  }
}

第三方客户端接入

也可在任何客户端中手动填写：Base URL = {站点地址}/v1，API Key = 你的应用 Key。

不想写代码？控制台内置「模型体验」页可直接测试。

模型与价格

价格查询

• 模型广场：所有可用模型的输入/输出单价，单位 元 / 1K tokens，实时来自系统倍率配置
• 公开接口：GET /api/pricing 返回模型清单与倍率（无需鉴权）
• 模型可用性：GET /v1/models（按你的应用与分组过滤）

计费规则

• 本次扣费 = ( 输入 tokens × 模型倍率 + 输出 tokens × 模型倍率 × 补全倍率 ) × 分组倍率
• 换算基准：1 模型倍率 = $0.002/1K tokens ≈ ¥0.014/1K（即 ¥14/百万 tokens）
• 输出单价 = 输入单价 × 补全倍率（生成比理解更贵）
• 分组倍率按账户所在分组生效（default 分组 = 1.0）

充值与对账

充值

• 入口：控制台 → 充值中心（在线支付：支付宝 / 微信 / 易支付，支付成功实时到账）
• 额度换算：到账 quota = 充值金额 ÷ 充值价格 × 500,000
• 也可使用兑换码充值

对账

控制台 → 日志：每笔调用记录时间、模型、输入/输出 tokens、扣除 quota，可与账单核对。

应用管理

应用管理页支持对每个应用 Key 独立设置：

多项目 / 多人使用建议：一人一应用、一项目一应用，单独设额度上限，便于隔离与撤销。

错误码

错误响应格式（OpenAI 兼容）：

{
  "error": {
    "message": "错误描述",
    "type": "invalid_request_error",
    "code": "401"
  }
}

常见问题

和直接调模型官方 API 有什么区别？

协议完全一致（OpenAI 兼容），区别只在 Base URL 和 Key，以及本平台的统一计费与多模型聚合。价格由平台定价，见模型广场。

一个 Key 可以多人/多项目共用吗？

可以，但建议分应用管理：额度隔离、日志可区分、泄露时单独撤销。

充值后额度没到账？

在线支付到账依赖支付平台异步回调，需站点公网可达；等待 1~2 分钟仍未到账，在订单中核对支付状态，联系管理员处理。

怎么知道某个模型划不划算？

模型广场输出价 ≈ 输入价 × 补全倍率；长回复场景优先看输出价。

可以使用 OpenAI 官方 SDK 吗？

可以。将 base_url 设为本站点地址，api_key 设为你的 TKOneGEO API Key 即可。