首次 API 调用

用 curl 向 Fluxlane 发送第一个 Chat Completions 请求，读懂返回结果，并排除首次调用最常见的错误。

开始之前

确认已完成准备工作：拿到 API Key，并确认了要调用的模型名。

发送请求

先把 API Key 写入环境变量，避免明文出现在命令和代码里：

bash

export FLUXLANE_API_KEY="sk-你的令牌"

然后发送一个最简单的对话请求，把 模型名称 换成你确认过的模型 ID：

bash

curl https://run.fluxlane.ai/v1/chat/completions \
  -H "Authorization: Bearer $FLUXLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"模型名称","messages":[{"role":"user","content":"你好"}]}'

读懂返回结果

请求成功时返回 HTTP 200，响应体为 OpenAI Chat Completions 格式（以下为结构示意，字段值以实际返回为准）：

json

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "模型名称",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "你好！有什么可以帮你？" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 9, "completion_tokens": 10, "total_tokens": 19 }
}

字段	含义
choices[0].message.content	模型的回复内容
usage	本次请求消耗的 Token，扣费明细可在控制台「使用日志」中核对

首次调用常见错误

状态码	常见原因	处理
401	API Key 错误、过期或已禁用	检查 Authorization 请求头，必要时重新生成密钥
400	模型名或参数错误	对照 GET /v1/models 核对模型名
403	模型、分组或 IP 无权限，或额度不足	检查密钥限制与账户余额
404	地址写错	核对地址写法

完整的状态码说明见 HTTP 状态与平台错误码。

下一步

• 在代码中调用：SDK 示例：Python / Node.js
• 逐字输出回复：流式响应
• 了解完整参数：Chat Completions