快速开始

本文带你完成 注册账号 → 创建 API Key → 发出第一个请求 的完整流程。

第 1 步：注册并登录

1. 打开平台官网，点击 注册。
2. 填写邮箱与密码完成注册（部分平台支持第三方 OAuth 快捷登录）。
3. 根据平台开放策略，新账号可能获赠一定的免费体验额度，以控制台显示为准。

第 2 步：创建 API Key

1. 登录后进入控制台 「令牌 / API Key」 页面。
2. 点击 创建令牌，按要求填写名称，并按需设置额度上限、过期时间与可用模型范围（均可留空使用默认值）。
3. 创建成功后，页面会仅展示一次完整的以 sk- 开头的密钥明文，请立即复制并妥善保存；关闭页面后将无法再次查看完整明文，只能删除后重新创建。

密钥安全

• API Key 等同于账号凭证：请勿将其提交到公开仓库、截图分享或发到群聊中。
• 建议为每个应用 / 环境单独创建 Key，并设置额度上限，方便隔离与止损。
• 一旦发现泄露，立即在控制台删除该 Key 并重新创建。

第 3 步：确认 API 地址

在控制台 「API 配置 / 系统信息」 页面查看你账号专属的 API 域名。OpenAI 格式客户端的 Base URL 形如：

https://confluia.com/v1

本文所有示例均使用该地址作为占位符，请替换为你的真实地址。

第 4 步：发出第一个请求

使用 curl

curl https://confluia.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      { "role": "user", "content": "请用一句话介绍你自己" }
    ]
  }'

正常返回示例：

{
  "id": "chatcmpl-xxxxxxxx",
  "object": "chat.completion",
  "created": 1690000000,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好，我是一个 AI 助手，可以帮你解答问题、编写代码、创作内容……"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 13,
    "completion_tokens": 28,
    "total_tokens": 41
  }
}

使用 Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://confluia.com/v1",  # 替换为你的 API 地址
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "请用一句话介绍你自己"}],
)

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

使用 Node.js（OpenAI SDK）

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的密钥",
  baseURL: "https://confluia.com/v1", // 替换为你的 API 地址
});

const resp = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "请用一句话介绍你自己" }],
});

console.log(resp.choices[0].message.content);

第 5 步：查看用量与消费

请求成功后：

• 「日志 / 用量」 页面：按请求查看模型、Token 用量与本次扣除的额度；
• 「钱包 / 余额」 页面：查看当前余额与充值入口。

下一步

• 需要流式输出、工具调用、多模态输入？见对话补全与接入指南。
• 需要生成图片、语音或视频？见图像生成、语音接口、视频生成。
• 想了解计费规则？见计费与额度。
• 遇到问题？见常见问题与错误码与限流。