快速开始

通过统一的 OpenAI 兼容接口访问平台已上架且支持的模型。仅需平台 API Key 与 Base URL，即可开始发起请求。

前置准备

1. 注册并登录平台账号。
2. 进入控制台创建 API Key，复制保存；密钥仅展示一次。
3. 确保账户余额充足并选择已开通的模型标识。

前往 API 密钥管理 →

首次请求

请求使用 POST /v1/chat/completions，请求头包含 Authorization: Bearer ...。

curl https://www.superluck.top/v1/chat/completions \
  -H "Authorization: Bearer sk-你的平台密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3.8-max","messages":[{"role":"user","content":"你好"}]}'

from openai import OpenAI
client = OpenAI(api_key="sk-你的平台密钥", base_url="https://www.superluck.top/v1")
result = client.chat.completions.create(
    model="qwen3.8-max",
    messages=[{"role": "user", "content": "你好"}]
)
print(result.choices[0].message.content)

将示例模型替换为你实际开通的模型 ID。SDK 需要先执行 pip install openai。

30 秒验证 Key

若接口返回 401，优先检查 Bearer 密钥是否完整；若返回余额不足，请先充值。不要在网页前端或公开仓库中暴露 API Key。

身份验证

API 地址

文本对话路径为 /chat/completions。视频、图像和音频使用各自的 API 协议，只有完成对应网关接入的端点才能调用。

小白术语表

文本对话 (LLM)

目前支持对接 OpenAI 兼容的聊天补全请求，流式请求传入 "stream":true。流式结算需要上游返回最终用量信息。

{
  "model": "qwen3.8-max",
  "messages": [{"role":"user","content":"你好"}],
  "stream": false
}

选择文本模型 →

视频生成

视频生成可能涉及异步任务与按秒计费，不应直接复用文本对话端点。请以具体模型的 API 页及平台实际接入状态为准。

图片生成

图片模型可能使用 /images/generations 或厂商专属异步接口。请先检查模型详情页中公布的端点。

语音与音频

语音识别、语音合成和实时音频的协议存在差异，需分别开通。

用量与计费

文本模型通常按输入与输出 Token 分开结算；实际费用按照平台模型价格和适用的阶梯计价规则计算。你可以在控制台查看每次请求的 Token 用量与费用流水。

错误码与常见问题