OneThingAI API 接入 帮助指南
OnethingAI助手
发布于:2026-05-11
Claude Opus 4.7 接入帮助文档(OneThingAI)
本文适合第一次使用 API 的同学。只需要会复制粘贴,按步骤操作,就可以用上
claude-opus-4-7 模型。说明:OneThingAI 控制台详情页通常需要登录后查看。本文中的API 地址、API Key、价格请以你在 OneThingAI 控制台页面看到的内容为准。
1. 这个模型是什么
claude-opus-4-7 是 Anthropic Claude Opus 4.7 的 API 模型名,例如:文本生成、图片模型等等它的特点是上下文很长,适合一次性放入较多资料。官方资料显示 Claude Opus 4.7 支持 1M token 上下文窗口,最大输出可到 128k tokens。
2. 使用前要准备什么
需要准备 3 个东西:
名称 | 从哪里拿 | 用来做什么 |
|---|---|---|
API Key | OneThingAI 控制台/账户管理/API Key 密钥 | 证明是你在调用接口 |
API 地址 / Base URL | 模型详情页里复制 | 告诉程序请求发到哪里 |
模型名称 | 模型详情页 | 本文使用 claude-opus-4-7 |
请注意!!API Key 很重要,不要发给别人,也不要直接放到公开代码仓库里。
3. 最简单的理解
你可以把 API 调用理解成一次“远程聊天”:
- 你的程序把问题发给 OneThingAI。
- OneThingAI 帮你调用 Claude Opus 4.7。
- 模型生成回答。
- OneThingAI 把回答返回给你的程序。
要填的核心参数只有:
api_key:你的密钥base_url:OneThingAI 页面上的 API 地址model:claude-opus-4-7messages:你要问的问题
4. 快速开始:Python 示例
第一步:安装 Python SDK
在终端运行:
pip install openai第二步:设置 API Key
推荐把密钥放到环境变量里,不要直接写死在代码中。
Windows PowerShell:
$env:ONETHINGAI_API_KEY="你的 API Key"macOS / Linux:
export ONETHINGAI_API_KEY="你的 API Key"第三步:复制并运行代码
把下面代码里的
https://这里替换成OneThingAI页面上的API地址 改成模型详情页显示的 API 地址。import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ONETHINGAI_API_KEY"],
base_url="https://这里替换成OneThingAI页面上的API地址"
)
response = client.chat.completions.create(
model="claude-opus-4-7",
messages=[
{"role": "system", "content": "你是一个耐心、清楚的中文助手。"},
{"role": "user", "content": "请用小白能听懂的话解释一下 API 是什么。"}
]
)
print(response.choices[0].message.content)如果能看到模型回答,说明接入成功。
5. 快速开始:JavaScript / Node.js 示例
第一步:安装 SDK
npm install openai第二步:设置 API Key
Windows PowerShell:
$env:ONETHINGAI_API_KEY="你的 API Key"macOS / Linux:
export ONETHINGAI_API_KEY="你的 API Key"第三步:运行代码
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.ONETHINGAI_API_KEY,
baseURL: "https://这里替换成OneThingAI页面上的API地址"
});
const response = await client.chat.completions.create({
model: "claude-opus-4-7",
messages: [
{ role: "system", content: "你是一个耐心、清楚的中文助手。" },
{ role: "user", content: "请用小白能听懂的话解释一下 API 是什么。" }
]
});
console.log(response.choices[0].message.content);6. 流式输出示例
流式输出就是“边生成边显示”,适合聊天页面,否则用户要等完整回答生成完才看到内容。
Python 示例:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ONETHINGAI_API_KEY"],
base_url="https://这里替换成OneThingAI页面上的API地址"
)
stream = client.chat.completions.create(
model="claude-opus-4-7",
messages=[
{"role": "user", "content": "写一份 5 点的学习计划。"}
],
stream=True
)
for chunk in stream:
delta = chunk.choices[0].delta.content
if delta:
print(delta, end="")7. 常用参数说明
参数 | 必填 | 解释 |
|---|---|---|
model | 是 | 使用哪个模型,这里填OnethingAI平台对应的名称 claude-opus-4-7 |
messages | 是 | 你和模型的对话内容 |
temperature | 否 | 越高越发散,越低越稳定。常用 0.2 到 0.8 |
max_tokens | 否 | 限制最多输出多少内容 |
stream | 否 | 是否边生成边返回 |
推荐初始配置:
{
"model": "claude-opus-4-7",
"temperature": 0.7,
"stream": false
}需要稳定的任务,可以把
temperature 调低,例如 0.2。如果你做的是文案、创意、起标题,可以调高一点,例如
0.8。8. 提示词怎么写更容易得到好结果
不要只写:
帮我写一个方案建议写得更具体:
请帮我写一份小红书账号运营方案。
背景:我是做 AI 工具教学的。
目标用户:零基础办公人群。
要求:
1. 用中文输出
2. 分成定位、内容栏目、发布频率、转化方式 4 部分
3. 语言简单,适合新手执行好提示词一般包含:
- 背景:你在做什么
- 目标:你想得到什么
- 格式:要表格、清单、代码还是文档
- 限制:字数、语气、受众、不要什么
9. 常见报错与解决方法
报错现象 | 常见原因 | 解决方法 |
|---|---|---|
401 / Unauthorized | API Key 错了或没传 | 检查 Authorization 或环境变量 |
404 / model not found | 模型名写错 | 确认是 claude-opus-4-7 |
429 / rate limit | 调用太频繁或余额不足 | 降低并发、稍后重试、检查额度 |
400 / bad request | 参数格式不对 | 检查 messages 是否是数组 |
请求很慢 | 问题太长或输出太长 | 缩短输入,限制 max_tokens |
10. 费用怎么理解
API 通常按 token 计费。你可以简单理解为:
- 输入 token:你发给模型的内容
- 输出 token:模型回复给你的内容
- 内容越长,消耗越多
具体单价请以 OneThingAI 模型详情页显示为准。
11. 可直接复用的“示例”
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ONETHINGAI_API_KEY"],
base_url="https://这里替换成OneThingAI页面上的API地址"
)
def ask_customer_service(question):
response = client.chat.completions.create(
model="claude-opus-4-7",
temperature=0.3,
messages=[
{
"role": "system",
"content": (
"你是一个中文客服助手。回答要简洁、礼貌、准确。"
"如果信息不足,要先说明需要用户补充什么。"
)
},
{"role": "user", "content": question}
]
)
return response.choices[0].message.content
print(ask_customer_service("你们的 API Key 在哪里创建?"))接入这个模型,本质上就是:在 OneThingAI 拿到密钥和接口地址,然后在代码里填入
API Key、Base URL 和 claude-opus-4-7,就可以像发消息一样调用 Claude Opus 4.7。参考资料
- Anthropic Claude Opus 4.7 官方说明:https://platform.claude.com/docs/en/about-claude/models/whats-new-claude-4-7
- Anthropic Claude Opus 页面:https://www.anthropic.com/claude/opus
- OneThingAI 帮助中心 API 文档:💻API文档