第一个 API 请求

第一个 API 请求

本文用最简单的方式，帮你完成第一次 API 调用。

准备工作

• 已完成注册并充值
• 已创建 API Key（令牌）

方式一：curl（无需安装任何依赖）

打开终端，执行以下命令：

curl https://api.rootflowai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "用一句话介绍你自己"}]
  }'

将 sk-xxxxxxxxxxxxxxxx 替换为你的真实令牌。

方式二：Python

安装 openai 包：

pip install openai

运行代码：

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxxxxxxxx",
    base_url="https://api.rootflowai.com/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[
        {"role": "user", "content": "用一句话介绍你自己"}
    ]
)

print(response.choices[0].message.content)

方式三：Node.js

安装 openai 包：

npm install openai

运行代码：

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'sk-xxxxxxxxxxxxxxxx',
  baseURL: 'https://api.rootflowai.com/v1',
})

const response = await client.chat.completions.create({
  model: 'claude-sonnet-4-6',
  messages: [{ role: 'user', content: '用一句话介绍你自己' }],
})

console.log(response.choices[0].message.content)

流式输出（Streaming）

支持 SSE 流式响应，适合对话场景：

stream = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "讲一个小故事"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

常见错误

| 错误码 | 原因 | 解决方法 | |--------|------|----------| | 401 | API Key 无效或格式错误 | 检查令牌是否正确，注意 Bearer 前缀 | | 402 | 账户余额不足 | 前往控制台充值 | | 429 | 请求频率过高 | 适当降低请求频率 | | 500 | 服务端错误 | 稍后重试，或联系支持 |