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 调用理解成一次“远程聊天”:
  1. 你的程序把问题发给 OneThingAI。
  2. OneThingAI 帮你调用 Claude Opus 4.7。
  3. 模型生成回答。
  4. OneThingAI 把回答返回给你的程序。
要填的核心参数只有:
  • api_key:你的密钥
  • base_url:OneThingAI 页面上的 API 地址
  • modelclaude-opus-4-7
  • messages:你要问的问题

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.20.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 KeyBase URLclaude-opus-4-7,就可以像发消息一样调用 Claude Opus 4.7。

参考资料

提交反馈