API使用文档

本文档给 Tenway AI 平台最终用户使用，目标是让用户尽快完成注册、充值、创建 API Key，并在自己的客户端或代码里调用国内大模型。

1. 登录平台

打开 Tenway AI 平台首页，注册或登录账号。

登录后重点看这几个位置：

余额：查看账户剩余额度。
令牌/API Key：创建和管理调用密钥。
模型/价格：查看可用模型和计费规则。
日志/用量：查看每次请求的消耗、状态和错误信息。

2. 充值和余额

调用模型前需要账户有可用余额。

余额会在每次 API 调用后自动扣减。不同模型、不同输入输出长度、不同功能类型，消耗会不同。

建议新用户先小额充值并完成一次测试调用，确认客户端配置正确后再正式使用。

3. 创建 API Key

进入“令牌”或“API Key”页面，创建一个新的密钥。

建议配置：

名称：写清用途，例如 my-app-production、cursor-test。
额度限制：测试密钥可以设置较小额度，避免误调用。
过期时间：临时测试建议设置过期时间，正式业务可按内部安全要求设置。

API Key 创建后请妥善保存。不要发到微信群、截图、公开仓库或前端代码里。

4. 接口地址

Tenway AI 提供统一的聊天补全接口，客户端只需要配置平台 Base URL 和 API Key。

常用 Base URL：

https://tenwayclaw.com/v1

请求时使用 Bearer Token 鉴权：

Authorization: Bearer 你的_API_Key

5. 快速测试

把下面的 YOUR_API_KEY 替换成你自己的 API Key。

curl https://tenwayclaw.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      { "role": "user", "content": "你好，请用一句话介绍 Tenway AI。" }
    ]
  }'

如果返回了模型回复，说明配置成功。

6. 在客户端里使用

大多数支持自定义 API 地址的客户端，只需要填写两项：

Base URL: https://tenwayclaw.com/v1
API Key: 你的_API_Key

如果客户端需要填写模型名，请到平台模型列表复制对应模型名称。

常见客户端配置思路：

Chatbox、Cherry Studio、NextChat：选择自定义 API/兼容接口，填写 Base URL 和 API Key。
Cursor、Code 工具：在自定义模型供应商中填写 Base URL 和 API Key。
自研系统：按客户端 SDK 的 baseURL/base_url 配置方式接入。

7. 模型权限、筛选和选择

7.1 可见范围

北京站按照用户等级隔离模型目录：

游客和普通用户：只显示国内模型及 Seedance 视频模型。
SVIP 用户：在普通用户模型基础上，显示已授权的海外模型。
管理员：用于运维验收，可查看全部已启用模型。

可见性由服务端控制，不只是前端隐藏。普通用户请求模型价格接口时也不会收到海外模型、厂商或对应分组信息。

7.2 在模型广场筛选

模型广场左侧提供三层筛选：

供应商专区：选择“腾辉专区-G”或 Seedance 专区。
模型分组：展开“腾辉专区-G”，按密钥对应的子分组筛选。
模型厂商：按 DeepSeek、智谱 GLM、Moonshot/Kimi、MiniMax、字节跳动等厂商筛选。

还可以在顶部搜索框直接输入模型名。厂商筛选和分组筛选可以同时使用，例如先选择国内大模型子分组，再点击“智谱 GLM”。

7.3 当前已验收的国内模型

以下国内文本模型已在 2026-07-15 通过北京生产环境真实 API 请求验收：

| 模型 | 厂商 | 推荐用途 | 调用端点 |

|---|---|---|---|

Seedance 专区另提供两个视频模型：

doubao-seedance-2-0-fast-260128
doubao-seedance-2-0-260128

模型目录会随上游可用性调整。请以模型广场和当前 API Key 所属分组实际返回的模型为准。

7.4 查询当前密钥可用模型

不同 API Key 可能属于不同子分组。创建密钥时选择的分组决定该密钥可以调用哪些模型。

curl https://tenwayclaw.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

建议客户端只配置该接口返回的模型名，不要手工猜测模型名称。

7.5 选择建议

首次联调：优先使用 deepseek-v4-flash，请求快、成本较低。
复杂推理和代码：使用 deepseek-v4-pro、glm-5.1 或 glm-5.2。
中文长文档：使用 kimi-k2.5、kimi-k2.6 或 MiniMax-M2.5。
视频生成：使用 Seedance Fast 完成低成本联调，再根据质量要求切换标准版。
对成本敏感：先在模型广场比较输入价和输出价，再给测试密钥设置额度上限。

7.6 国内模型请求示例

下面的请求体适用于上表中的 8 个国内文本模型，只需要替换 model。

curl https://tenwayclaw.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.2",
    "messages": [
      {"role": "system", "content": "你是一个准确、简洁的中文助手。"},
      {"role": "user", "content": "用三点说明 API 网关的作用。"}
    ],
    "stream": false,
    "max_tokens": 512
  }'

流式输出：

curl -N https://tenwayclaw.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [{"role": "user", "content": "分析微服务拆分的三个主要风险。"}],
    "stream": true,
    "max_tokens": 1024
  }'

成功响应至少包含 choices；部分推理模型还会返回 reasoning_content。业务代码不要依赖固定的 id 或 created 值。

7.7 上线验收结果

2026-07-15 的北京生产环境验收包含 19 个上游子分组、124 个唯一候选模型和 397 个“分组-模型”组合：

331 个组合通过真实请求。
109 个唯一模型至少存在一个可用分组。
失败组合已经从客户可见能力中停用。
当前公开的 8 个国内文本模型全部通过真实请求。
所有测试密钥均为临时密钥，测试结束后已删除。

如果后续出现 429、502 或 503，通常是上游临时限流或负载问题；不要立即高并发重试，建议使用指数退避并记录响应中的请求编号。

8. 功能配置说明

常见参数如下。

model：模型名称。必须填写平台支持的模型名。

messages：对话内容。一般包含用户输入，也可以包含 system 指令。

temperature：控制创造性。数值越低越稳定，越高越发散。普通问答可用 0.3-0.7。

max_tokens：限制最大输出长度。设置过大可能增加费用。

stream：是否流式输出。聊天产品建议开启，后台批处理可以关闭。

tools：工具调用配置。只有支持工具调用的模型才可使用。

response_format：结构化输出配置。需要 JSON 输出时可使用，但要确认模型支持。

图片输入：选择支持视觉的模型，并按客户端要求上传图片或传入图片 URL/base64。

9. 计费说明

Tenway AI 按模型使用量计费。不同模型价格不同，通常参考模型厂商官方刊例价，并结合平台实际服务成本展示。

一般会按下面维度计算：

输入 tokens：你发送给模型的内容。
输出 tokens：模型生成的内容。
图片/视觉输入：部分模型会按图片大小、数量或折算 tokens 计费。
长上下文：输入越长，消耗越高。
工具调用：工具调用本身可能增加输入输出 tokens。

简单理解：

一次请求费用 = 输入费用 + 输出费用 + 可能的图片/特殊能力费用

实际扣费以平台账单、用量日志和模型价格页为准。

10. 控制成本建议

测试阶段使用轻量模型。
给测试 API Key 设置额度限制。
不要把完整日志、超长文档反复塞进上下文。
能摘要就先摘要，再让模型处理摘要结果。
对固定格式任务设置 max_tokens。
定期查看用量日志，发现异常及时停用密钥。

11. 常见问题

API Key 泄露了怎么办？

立即在平台禁用或删除该 API Key，然后创建新的 API Key。

为什么余额扣得比预期快？

通常是因为输入内容太长、输出太长、使用了高价模型，或客户端开启了多轮上下文。请检查用量日志。

为什么模型调用失败？

常见原因包括余额不足、API Key 错误、模型名写错、客户端 Base URL 填错、请求参数不被模型支持。

Base URL 要不要带 `/v1`？

建议填写：

https://tenwayclaw.com/v1

如果某些客户端会自动拼接 /v1，则按客户端提示填写，避免重复成 /v1/v1。

可以在前端网页里直接放 API Key 吗？

不建议。API Key 应放在服务端环境变量或后端配置里，不要暴露给浏览器端用户。

12. 推荐新用户流程

登录平台。
充值少量余额。
创建一个测试 API Key。
在客户端填写 Base URL 和 API Key。
选择一个低价模型发起测试。
查看用量日志确认扣费。
测试无误后，再接入正式业务。

13. Seedance 2.0 视频生成

Seedance 2.0 使用异步视频任务接口。流程是先提交任务，拿到 task_id，再轮询任务状态，完成后下载视频文件。

接口地址：

https://www.tenwayclaw.com/v1/videos

可用模型：

doubao-seedance-2-0-fast-260128：Seedance 2.0 Fast，适合优先联调。
doubao-seedance-2-0-260128：Seedance 2.0 标准版。

提交视频任务

curl -X POST https://www.tenwayclaw.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "prompt": "蓝绿色科技感几何画面缓慢推进，光效流动，画面稳定，5秒短视频。",
    "seconds": "5",
    "duration": 5,
    "size": "480p",
    "metadata": {
      "resolution": "480p",
      "ratio": "16:9",
      "duration": 5,
      "generate_audio": false,
      "watermark": false
    }
  }'

成功后会返回任务编号：

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "video",
  "model": "doubao-seedance-2-0-fast-260128",
  "status": "queued",
  "progress": 0
}

请保存 id 或 task_id，查询和下载都要用这个编号。

查询任务状态

curl https://www.tenwayclaw.com/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

常见状态：

queued：已提交，等待调度。
in_progress：生成中。
completed：已完成，可以下载。
failed：任务失败，请查看返回的 error.message。

下载视频

curl -L https://www.tenwayclaw.com/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o seedance.mp4

下载成功时响应内容为 video/mp4。建议业务侧及时保存生成结果，不要长期依赖上游临时下载链接。

使用参考素材

如果已经把素材上传到平台素材库，可以在任务里传入 asset://<asset_id>。也可以传入公网可访问的图片、视频或音频 URL。

curl -X POST https://www.tenwayclaw.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "prompt": "参考图中的主体缓慢运动，镜头轻微推进，画面稳定。",
    "duration": 5,
    "metadata": {
      "content": [
        {
          "type": "image_url",
          "role": "reference_image",
          "image_url": {
            "url": "asset://asset-xxxxxxxx"
          }
        }
      ],
      "resolution": "480p",
      "ratio": "16:9",
      "generate_audio": false,
      "watermark": false
    }
  }'

素材 role 使用火山官方取值：

reference_image：普通参考图。
first_frame：首帧图。
last_frame：尾帧图。
reference_video：参考视频。
reference_audio：参考音频。

不要传 role: "reference"，该值会被上游拒绝。

计费口径

Seedance 2.0 两个模型按平台模型广场展示价格计费。提交任务时会先预扣，任务完成后按上游返回的实际用量结算，多退少补。

如需最小成本联调，建议先使用 doubao-seedance-2-0-fast-260128、480p、5s、关闭音频和水印。

API使用文档

API使用文档

1. 登录平台

2. 充值和余额

3. 创建 API Key

4. 接口地址

5. 快速测试

6. 在客户端里使用

7. 模型权限、筛选和选择

7.1 可见范围

7.2 在模型广场筛选

7.3 当前已验收的国内模型

7.4 查询当前密钥可用模型

7.5 选择建议

7.6 国内模型请求示例

7.7 上线验收结果

8. 功能配置说明

9. 计费说明

10. 控制成本建议

11. 常见问题

API Key 泄露了怎么办？

为什么余额扣得比预期快？

为什么模型调用失败？

Base URL 要不要带 /v1？

可以在前端网页里直接放 API Key 吗？

12. 推荐新用户流程

13. Seedance 2.0 视频生成

提交视频任务

查询任务状态

下载视频

使用参考素材

计费口径

Base URL 要不要带 `/v1`？