API 文档 — OpenAI 兼容接口

快速开始

FluxAPI 是 Tkone 对外的统一大模型调用接口，完全兼容 OpenAI API 协议。任何支持 OpenAI SDK / API 规范的客户端、框架与应用都可以直接使用。

OpenAI 兼容：改 Base URL + API Key 两处配置即可迁移。
多模型聚合：一个 Key 调用模型广场上线的全部模型。
透明计费：按 Token 用量计费，模型广场明码标价，日志逐笔可查。

步骤	操作	位置
①	注册账号并完成登录	注册页
②	创建应用，获取 API Key（sk- 开头）	控制台 → 应用管理
③	确认可用模型与价格	模型广场 / 价格
④	用 Base URL + API Key 发起调用	任意 OpenAI 兼容环境

第一个请求

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

from openai import OpenAI

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

response = client.chat.completions.create(
    model="anthropic/claude-fable-5.1",
    messages=[{"role": "user", "content": "你好"}],
    stream=True
)
            

import OpenAI from "openai";

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

const stream = await client.chat.completions.create({
  model: "anthropic/claude-fable-5.1",
  messages: [{ role: "user", content: "你好" }],
  stream: true,
});
            

BASE URL · https://tkonegeo.com/v1

鉴权

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

HEADER

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxx

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

模型接口

Base URL 为 https://tkonegeo.com/v1，协议为 OpenAI API 兼容，JSON 请求/响应，流式为 SSE。

GET/v1/models

列出当前 API Key 可用的所有模型。

cURL

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

GET/v1/models/{model}

获取指定模型的详细信息。

参数名	类型	必填	说明
`model`	string	是	模型 ID，例如 `anthropic/claude-fable-5.1`

对话接口

POST/v1/chat/completions

Chat Completions 接口，兼容 OpenAI 格式，支持流式响应（SSE）。

参数名	类型	必填	说明
`model`	string	是	模型 ID
`messages`	array	是	消息数组 `[{role, content}]`
`stream`	bool	否	是否流式响应，默认 `false`
`temperature`	float	否	采样温度 0–2
`max_tokens`	int	否	最大生成 Token 数
`top_p`	float	否	核采样概率
`frequency_penalty`	float	否	频率惩罚 -2 到 2
`presence_penalty`	float	否	存在惩罚 -2 到 2

流式请求

from openai import OpenAI

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

stream = client.chat.completions.create(
    model="anthropic/claude-fable-5.1",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "用三句话解释什么是 Token。"},
    ],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")
            

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

STREAMING · SSE

Legacy 补全与编辑

POST/v1/completions

文本补全接口（Legacy）。参数：model、prompt、stream、max_tokens、temperature。

POST/v1/edits

文本编辑接口，根据指令修改输入文本。参数：model、input、instruction、temperature、top_p。

向量接口

POST/v1/embeddings

生成文本的向量嵌入。

参数名	类型	必填	说明
`model`	string	是	模型 ID
`input`	string \| array	是	输入文本或文本数组
`encoding_format`	string	否	`float` 或 `base64`

cURL

curl https://tkonegeo.com/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxx" \
  -d '{"model": "<model>", "input": "Tkone"}'

图像接口

POST/v1/images/generations

根据提示词生成图像。

参数名	类型	必填	说明
`model`	string	是	模型 ID
`prompt`	string	是	图像描述提示词
`n`	int	否	生成数量，默认 1
`size`	string	否	图像尺寸，如 1024x1024
`quality`	string	否	`standard` 或 `hd`
`response_format`	string	否	`url` 或 `b64_json`

cURL

curl https://tkonegeo.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxx" \
  -d '{"model": "<model>", "prompt": "一座绿白配色的未来 AI 工厂", "n": 1, "size": "1024x1024"}'

语音接口

POST/v1/audio/transcriptions

语音转文本（需 multipart/form-data 上传音频文件）。

参数名	类型	必填	说明
`file`	file	是	音频文件
`model`	string	是	模型 ID
`language`	string	否	音频语言（ISO-639-1）
`prompt`	string	否	引导文本
`response_format`	string	否	`json` / `text` / `srt` / `verbose_json` / `vtt`
`temperature`	float	否	采样温度

POST/v1/audio/translations

将音频翻译为英文文本。参数与转写接口类似：file、model、prompt、response_format、temperature。

POST/v1/audio/speech

文本转语音。参数：model、input、voice、response_format、speed。

上传音频时请使用 multipart/form-data，不要手动设置 Content-Type: application/json。

内容审核

POST/v1/moderations

检查文本是否违反内容安全策略。

参数名	类型	必填	说明
`input`	string \| array	是	待检查的文本
`model`	string	否	审核模型 ID

cURL

curl https://tkonegeo.com/v1/moderations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxx" \
  -d '{"input": "需要审核的文本"}'

响应结构

返回 OpenAI 标准格式，用量在 usage 字段。把 prompt_tokens 与 completion_tokens 入库，即可做自己的成本分析。

RESPONSE / JSON

{
  "id": "chatcmpl-xxx",
  "model": "anthropic/claude-fable-5.1",
  "choices": [{ "message": { "role": "assistant", "content": "..." } }],
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 42,
    "total_tokens": 57
  }
}

USAGE IS ALWAYS RETURNED

第三方客户端也可手动填写：Base URL = https://tkonegeo.com/v1，API Key = 你的应用 Key。

模型与价格

模型广场展示所有可用模型的输入/输出单价，单位 CNY / 1M tokens；视频、图像模型按秒或按张计价。价格来自平台模型广场，Tkone 不额外隐藏系数。

MODELS

模型广场

208 个模型，按国内/海外、厂商、模态与能力筛选。

进入模型广场

PRICING

价格与计算器

10 个旗舰模型的价格表与月度成本计算器，按 CNY 估算。

查看价格

公开数据接口

模型广场数据可公开读取，无需鉴权：

PUBLIC

GET https://tkonegeo.com/api/marketplace/models?page=1&page_size=60
# 返回 total、facets 与 items；price.input / price.output 单位为 CNY / 1M tokens

计费规则

本次扣费 = 输入 tokens × 输入单价 + 输出 tokens × 输出单价。输出单价通常高于输入单价；具体价格以模型广场为准。

视频模型按秒计价，图像模型按张计价，其他模型按 Token 计价。使用前请在模型广场确认计价单位。

充值与对账

充值

入口：登录控制台 → 充值中心。
支持在线支付与兑换码充值，支付成功后额度实时到账。
具体支付方式与到账说明以充值页展示为准。

对账

控制台 → 日志：每笔调用记录时间、模型、输入/输出 tokens、扣除额度。
日志可与模型广场价格、账单逐笔核对。
建议为每个项目创建独立 API Key，便于归因与额度控制。

应用管理

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

设置	说明
额度上限	该应用累计最多消耗的额度，防失控
有效期	过期自动失效
模型范围	限定该应用只能调用哪些模型
状态	启用 / 禁用，禁用后 Key 立即失效

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

错误码

HTTP 状态码	说明	处理
200	请求成功	—
400	请求参数错误	检查请求参数
401	API Key 无效或已禁用	检查 Key 状态与有效期
403	无权使用模型	检查应用的模型范围
404	模型不存在或无可用渠道	确认模型名称正确
429	额度不足或触发限流	充值或降低并发稍后重试
500	上游渠道波动	稍后重试，持续失败联系平台支持

错误响应格式

ERROR / JSON

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

常见问题

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

一个 Key、一个 Base URL 即可调用模型广场的全部模型；计费、日志与用量看板由 Tkone 统一提供。你不需要为每个厂商单独开户、维护多套 SDK 与账单。

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

技术上可以，但不建议。更好的是为每个项目或每个人创建独立应用 Key，分别设置额度上限与模型范围，便于用量归因、隔离与撤销。

充值后额度没到账？

先刷新控制台充值页与用量看板；在线支付通常实时到账。若仍未到账，请保留支付订单号并联系平台支持。

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

在模型广场查看输入/输出单价，在价格页用计算器按你的月均 Token 用量估算。先小流量对比 2–3 个模型的效果与成本，再决定主力模型。

可以使用 OpenAI 官方 SDK 吗？

可以。Python、Node.js、Java 等官方 SDK 都能直接使用，只需把 Base URL 改为 https://tkonegeo.com/v1，API Key 换成你的应用 Key。

模型价格在哪里看？

模型广场展示全部 208 个模型的价格与能力；价格页展示 10 个旗舰模型的参考价与成本计算器。最终价格以模型广场和控制台账单为准。

API 文档接入 208 个模型

快速开始

第一个请求

鉴权

模型接口

对话接口

流式请求

Legacy 补全与编辑

向量接口

图像接口

语音接口

内容审核

响应结构

模型与价格

模型广场

价格与计算器

公开数据接口

计费规则

充值与对账

充值

对账

应用管理

错误码

错误响应格式

常见问题

API 文档
接入 208 个模型