文档中心

快速集成 AI 能力，让开发更简单

简介

ttonkapi 提供统一的 AI 模型 API 接口，完全兼容 OpenAI 格式。 您可以直接使用现有的 OpenAI SDK 和工具，无需任何修改。

💡 提示：我们的 API 与 OpenAI 完全兼容，只需修改 Base URL 即可无缝切换。

Base URL: https://ttonkapi.com/v1

快速入门

5 分钟快速集成 AI 能力到您的应用中

  1. 获取 API Key

    注册账号后，在 控制台 创建 API Key

  2. 安装 SDK

    使用 OpenAI 官方 SDK 或任何兼容的客户端

    # Python
pip install openai

# Node.js
npm install openai
  3. 初始化客户端

    配置 Base URL 和 API Key

    from openai import OpenAI

client = OpenAI(
    api_key="ttonk_sk_xxx",
    base_url="https://ttonkapi.com/v1"
)
  4. 发送请求

    调用任意支持的模型

    response = client.chat.completions.create(
    model="qwen-plus",
    messages=[
        {"role": "user", "content": "你好！"}
    ]
)

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

认证方式

所有 API 请求都需要在 Header 中包含 Bearer Token 进行认证

Authorization: Bearer ttonk_sk_xxxxxxxxxxxx
⚠️ 安全提醒：请勿将 API Key 提交到公开代码仓库或在前端代码中暴露。

POST对话补全

创建对话补全请求，支持多轮对话

请求参数

参数 类型 说明 必填
model string 模型名称，如 qwen-plus 是
messages array 对话消息列表 是
max_tokens integer 最大生成 tokens 数 否
temperature number 随机性 (0-2) 否

请求示例

curl https://ttonkapi.com/v1/chat/completions \
  -H "Authorization: Bearer ttonk_sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-plus",
    "messages": [
      {"role": "user", "content": "你好！"}
    ],
    "max_tokens": 1000
  }'

响应示例

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1234567890,
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "你好！有什么我可以帮助你的吗？"
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}

GET模型列表

获取所有可用的模型列表

curl https://ttonkapi.com/v1/models \
  -H "Authorization: Bearer ttonk_sk_xxx"

错误处理

API 使用标准 HTTP 状态码表示错误类型

状态码 说明 解决方案
400 请求参数错误 检查请求参数格式
401 认证失败 检查 API Key 是否正确
402 余额不足 请充值后重试
429 请求频率超限 降低请求频率
500 服务器错误 联系技术支持

频率限制

不同套餐有不同的频率限制

套餐 QPM (次/分钟) RPM (tokens/分钟)
免费试用 10 10,000
标准版 60 100,000
专业版 300 500,000
企业版 1000+ 自定义

常见问题

如何获取 API Key？

登录后进入控制台，在"API Keys"页面创建和管理您的密钥。

支持哪些模型？

目前支持通义千问（qwen-turbo/plus/max）、DeepSeek、MiniMax 等主流模型。详见 API 市场。

如何充值？

在控制台"充值与账单"页面选择充值金额，支持 PayPal、支付宝等多种支付方式。

积分会过期吗？

充值获得的积分永久有效，未使用的积分不会过期。

💬 在线客服