5 分钟发出第一个请求
从选择模型到匹配密钥并收到第一条回复，完成一次可复用的最小调用。
本页使用 PowerShell 7 演示一次最小的 OpenAI Chat Completions 请求。完成后，你会得到三个可复用信息：API 密钥、当前分组可用的完整模型 ID，以及可以填入第三方工具的 OpenAI 兼容地址。
安全提示：API 密钥等同于调用凭据。示例只把密钥放在当前终端的环境变量中，不要把真实密钥粘贴到公开 issue、截图、前端代码或 Git 仓库。
时间安排
| 时间 | 目标 |
|---|---|
| 0–1 分钟 | 选择模型和协议 |
| 1–2 分钟 | 选择或创建匹配密钥 |
| 2–3 分钟 | 复制配置，确认完整模型 ID |
| 3–4 分钟 | 发送最小文本请求 |
| 4–5 分钟 | 查看回复和调用日志 |
第 1 步：选择模型与匹配密钥
打开统一配置引导，先选择想使用的模型，再选择 OpenAI Chat Completions 协议：
- 选择已有的匹配密钥；没有密钥时在当前页面展开快捷创建。
- 从支持所选模型的分组中选择，密钥默认使用分组名称，也可以改成容易记住的名称；同名允许保留。
- 初次验证可以保留默认额度，但“无限额度”只表示密钥本身没有单独上限，调用仍需账号有可用钱包或订阅额度。
- 确认密钥处于启用状态、未过期，且没有把当前电脑排除在 IP 白名单之外。
创建后复制完整密钥。若怀疑密钥泄露，立即在列表中停用或删除，再创建新密钥。
第 2 步：在当前终端准备凭据
在 PowerShell 7 中运行以下命令。Read-Host -AsSecureString 输入时不会回显密钥。
$env:TODOOAI_BASE_URL = "https://toodooai.com"
$secret = Read-Host "输入 Toodoo AI API 密钥" -AsSecureString
$env:TODOOAI_API_KEY = [System.Net.NetworkCredential]::new("", $secret).Password
$headers = @{ Authorization = "Bearer $env:TODOOAI_API_KEY" }这些环境变量只对当前终端及其子进程生效。关闭窗口后需要重新设置，不要把真实值写进项目的 .env 并提交到仓库。
第 3 步：查询完整模型 ID
配置引导已经显示所选模型的完整 ID，包括渠道前缀。也可以请求模型列表，确认当前密钥能够访问该模型：
$models = Invoke-RestMethod `
-Uri "$env:TODOOAI_BASE_URL/v1/models" `
-Headers $headers
$models.data | Select-Object id选择一个确实出现在列表中的 id，然后保存到环境变量：
$env:TODOOAI_MODEL = Read-Host "粘贴完整模型 ID"完整保留模型 ID 中的渠道前缀、大小写和斜杠。例如 provider/model 是一个整体，不要自行截取为 model。如果列表为空或返回错误，先查看错误码与排障。
第 4 步：发送最小请求
$body = @{
model = $env:TODOOAI_MODEL
messages = @(
@{ role = "user"; content = "请用一句话介绍你自己。" }
)
stream = $false
} | ConvertTo-Json -Depth 5
$result = Invoke-RestMethod `
-Method Post `
-Uri "$env:TODOOAI_BASE_URL/v1/chat/completions" `
-Headers $headers `
-ContentType "application/json; charset=utf-8" `
-Body ([System.Text.Encoding]::UTF8.GetBytes($body))
$result.choices[0].message.content预期结果是终端打印一段模型回复。这个请求只验证基础文本调用；图片、工具调用、思考模式、Responses 或长上下文能力，都要在目标模型和客户端中分别确认。
第 5 步：验证日志
打开 日志功能，将时间范围缩小到刚才的请求，重点核对：
- 请求是否到达平台；
- 使用的密钥提示、分组和完整模型 ID 是否正确；
- 状态码、消耗和请求标识是否与客户端反馈一致。
日志没有记录时，优先检查 DNS、代理、TLS、Base URL 和客户端超时；日志有记录但请求失败时，再检查分组、模型权限、额度和请求参数。