快速开始

几分钟内开始使用 TokenAI API

三步快速接入

1注册账户并获取 API Key
2安装 OpenAI SDK 或直接使用 HTTP 请求
3将 base_url 修改为 https://api.tokenai.dev/v1

Base URL

text

https://api.tokenai.dev/v1

认证方式

使用 API Key 进行身份验证

所有 API 请求都需要在 HTTP Header 中携带 API Key 进行认证。你可以在控制台中创建和管理 API Key。

安全提示

请妥善保管你的 API Key，不要在客户端代码中暴露。建议使用环境变量存储。

请求示例

HTTP Header

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx

API 端点

完全兼容 OpenAI API 格式

POST/v1/chat/completions

创建聊天补全，支持多轮对话和流式输出。

请求参数

参数	类型	必填	说明
model	string	是	模型名称
messages	array	是	对话消息列表
stream	boolean	否	是否流式返回
temperature	number	否	温度参数 0-2
max_tokens	integer	否	最大生成 token 数

POST/v1/embeddings

生成文本向量嵌入，用于语义搜索和相似度计算。

GET/v1/models

获取可用模型列表。

模型列表

支持主流 AI 模型，按 Token 计费

模型	厂商	输入价格	输出价格	上下文
gpt-4o	OpenAI	¥0.015/1K	¥0.06/1K	128K
gpt-4o-mini	OpenAI	¥0.00015/1K	¥0.0006/1K	128K
gpt-4.1-mini	OpenAI	¥0.0004/1K	¥0.0016/1K	1M
claude-3.5-sonnet	Anthropic	¥0.003/1K	¥0.015/1K	200K
claude-3-opus	Anthropic	¥0.015/1K	¥0.075/1K	200K
qwen-plus	Alibaba	¥0.0008/1K	¥0.002/1K	128K
qwen-max	Alibaba	¥0.004/1K	¥0.012/1K	32K
deepseek-chat	DeepSeek	¥0.00014/1K	¥0.00028/1K	64K

* 价格单位为人民币/千 Token，实际价格以控制台为准

代码示例

多语言 SDK 集成示例

python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.tokenai.dev/v1"
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)

print(response.choices[0].message.content)

错误处理

HTTP 状态码和错误响应

状态码	类型	说明
400	Bad Request	请求参数错误，请检查请求体格式
401	Unauthorized	API Key 无效或已过期
402	Payment Required	账户余额不足，请充值
403	Forbidden	无权访问该资源
404	Not Found	请求的资源不存在
429	Rate Limited	请求频率超限，请稍后重试
500	Server Error	服务器内部错误，请联系支持

错误响应格式

JSON

{
  "error": {
    "message": "Invalid API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

SDK 安装

使用官方 OpenAI SDK 即可接入

Python

bash

pip install openai

Node.js

bash

npm install openai

需要帮助？

如果你在集成过程中遇到任何问题，可以通过以下方式联系我们：

邮件支持 GitHub Issues