OneThingAI API 调用指南

OnethingAI助手

发布于：2026-05-11

演示“拿到 API Key、Base URL、Model ID 之后，怎么真的把模型调起来”。

1. 推荐工具总览

工具	优点
Hoppscotch	浏览器打开就能用，不用安装
Apifox	中文友好，集合接口调试、文档、Mock、测试
Postman	知名度最高，资料最多，生态成熟
Bruno	本地优先、开源、适合把接口集合进仓库
Insomnia	界面简洁，适合 REST / GraphQL
Thunder Client	在 VS Code 里直接调接口
curl	系统通用、文档里最容易复制
Swagger UI / OpenAPI	文档和调试结合

2. 最推荐的

用 Hoppscotch 演示 OneThingAI 调用

打开 Hoppscotch：

https://hoppscotch.io/

第一步：选择请求方式

选择：

POST

第二步：填写请求地址

填写 OneThingAI 模型详情页里的接口地址，例如：

https://这里替换成OneThingAI页面上的API地址

第三步：填写 Headers（鉴权头）

添加两个 Header：

Key	Value
`Authorization`	`Bearer 你的APIKey`
`Content-Type`	`application/json`

第四步：填写 Body

Body 选择 JSON，然后填写（参考框选部分，注意！）：

{
 "model": "这里替换成模型详情页里的Model ID",
 "messages": [
 {
 "role": "user",
 "content": "请用小白能听懂的话解释一下 API 是什么。"
 }
 ]
}

第五步：点击 Send

如果返回里能看到模型生成的文字，说明调用成功。
失败:(安装浏览器扩展，并看到识别出版本)

4. 用 Apifox / Postman 演示

Apifox 和 Postman 的操作思路基本一样。

第一步：新建请求

新建一个 HTTP 请求，方法选择：

POST

第二步：填写 URL

填写模型详情页提供的 API 地址。

第三步：设置 Authorization

可以选择 Bearer Token，然后填入：

你的 API Key

也可以手动在 Headers 里添加：

Authorization: Bearer 你的APIKey

第四步：设置 Body

Body 选择：

raw / JSON

填写：

{
 "model": "这里替换成模型详情页里的Model ID",
 "messages": [
 {
 "role": "system",
 "content": "你是一个耐心、清楚的中文助手。"
 },
 {
 "role": "user",
 "content": "请帮我写一段 100 字以内的产品介绍。"
 }
 ],
 "temperature": 0.7
}

第五步：保存为模板

建议把请求命名为：

OneThingAI - 通用聊天模型调用

以后换模型时，只需要改：

URL / Base URL
Model ID
提示词内容

5. 用 curl 演示

curl 是最通用的方式，适合放到文档里给开发者复制。

curl -X POST "https://这里替换成OneThingAI页面上的API地址" \
 -H "Authorization: Bearer 你的APIKey" \
 -H "Content-Type: application/json" \
 -d '{
 "model": "这里替换成模型详情页里的Model ID",
 "messages": [
 {
 "role": "user",
 "content": "请用一句话介绍 OneThingAI 模型 API。"
 }
 ]
 }'

Windows PowerShell 可以用下面写法：

curl.exe -X POST "https://这里替换成OneThingAI页面上的API地址" `
 -H "Authorization: Bearer 你的APIKey" `
 -H "Content-Type: application/json" `
 -d "{\"model\":\"这里替换成模型详情页里的Model ID\",\"messages\":[{\"role\":\"user\",\"content\":\"请用一句话介绍 OneThingAI 模型 API。\"}]}"

提交反馈