什么是 API?为什么需要 API?
API(Application Programming Interface,应用程序编程接口)是软件之间通信的标准方式。简单来说,当你的程序需要使用 AI 能力时,就通过 API 向 AI 服务发送请求,AI 处理后返回结果。
你不需要自己训练 AI 模型,只需要:
- 注册一个 AI API 服务账号;
- 获取一个 API Key(相当于你的身份证);
- 在代码中发送请求,获取 AI 的回答。
如果你想了解更多关于 AI API 中转站的概念,可以阅读 什么是 AI API 中转站?
第一步:注册 Clawonetoken 账号
- 访问 api.clawonetoken.com/register;
- 填写用户名、密码,点击注册;
- 登录后,系统会赠送一定额度供你免费体验。
第二步:创建 API Key
- 登录后,点击左侧「令牌管理」;
- 点击「创建令牌」按钮;
- 填写名称(如"我的第一个 Key"),其他设置保持默认;
- 点击确认,复制生成的 Key(格式:
sk-xxxxxxxxxxxxxxxx)。
⚠️ 注意:API Key 只显示一次,请立即保存到安全的地方。如果丢失,需要重新创建。
第三步:发出你的第一个 AI 请求
方式 A:使用 curl(无需安装任何软件)
打开终端(Mac/Linux)或命令提示符(Windows),输入:
curl https://api.clawonetoken.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 你的API_Key" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{"role": "user", "content": "你好,请用一句话介绍你自己"}
]
}'
方式 B:使用 Python
# 先安装依赖:pip install openai
from openai import OpenAI
client = OpenAI(
api_key="你的API_Key",
base_url="https://api.clawonetoken.com/v1"
)
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[
{"role": "user", "content": "你好,请用一句话介绍你自己"}
]
)
print(response.choices[0].message.content)
方式 C:使用 JavaScript(Node.js)
// 先安装依赖:npm install openai
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "你的API_Key",
baseURL: "https://api.clawonetoken.com/v1",
});
const response = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [{ role: "user", content: "你好,请用一句话介绍你自己" }],
});
console.log(response.choices[0].message.content);
理解 API 请求的结构
每次 API 请求包含以下关键参数:
- model:指定使用哪个 AI 模型(如
gpt-4o-mini、deepseek-ai/DeepSeek-V3); - messages:对话历史,包含 role(角色)和 content(内容);
- role 有三种:
system(系统指令)、user(用户)、assistant(AI 回复); - max_tokens:限制 AI 回复的最大长度;
- temperature:控制回复的随机性(0=确定性,1=创意性)。
如何构建多轮对话?
from openai import OpenAI
client = OpenAI(
api_key="你的API_Key",
base_url="https://api.clawonetoken.com/v1"
)
# 维护对话历史
messages = [
{"role": "system", "content": "你是一个友好的助手,用简洁的中文回答问题。"}
]
while True:
user_input = input("你:")
if user_input.lower() in ["退出", "quit", "exit"]:
break
messages.append({"role": "user", "content": user_input})
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=messages
)
ai_reply = response.choices[0].message.content
messages.append({"role": "assistant", "content": ai_reply})
print(f"AI:{ai_reply}")
下一步学习建议
掌握基础调用后,你可以进一步学习:
- Python 调用 Claude API 完整指南 — 流式输出、异步调用等进阶用法
- 主流大模型横向对比 — 了解不同模型的特点,选择最适合你场景的模型
- API 价格对比 — 控制成本,找到最划算的调用方案
- 在 Cursor 中配置 AI API — 提升编程效率
