OpenAI 格式

本页介绍如何通过 OpenAI 兼容方式调用 LuminaToken。

接口地址

OpenAI 兼容根地址：

https://api.luminatoken.cc/v1

常见接口会挂在该地址之下，例如：

• https://api.luminatoken.cc/v1/chat/completions

认证方式

使用标准 Bearer Token 认证：

Authorization: Bearer YOUR_API_KEY

其中 YOUR_API_KEY 为你在 LuminaToken 控制台创建的 Key。

Chat Completions 请求示例

{
  "model": "gpt-4.1",
  "messages": [
    {
      "role": "system",
      "content": "你是一个简洁的中文助手。"
    },
    {
      "role": "user",
      "content": "请用一句话介绍 LuminaToken。"
    }
  ],
  "temperature": 0.7
}

Chat Completions 响应示例

{
  "id": "chatcmpl-example",
  "object": "chat.completion",
  "created": 1746844800,
  "model": "gpt-4.1",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "LuminaToken 是一个帮助开发者统一接入 AI 模型与工具的平台。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 23,
    "completion_tokens": 18,
    "total_tokens": 41
  }
}

Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.luminatoken.cc/v1",
)

response = client.chat.completions.create(
    model="gpt-4.1",
    messages=[
        {"role": "system", "content": "你是一个简洁的中文助手。"},
        {"role": "user", "content": "请用一句话介绍 LuminaToken。"},
    ],
)

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

cURL 示例

curl https://api.luminatoken.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4.1",
    "messages": [
      {"role": "system", "content": "你是一个简洁的中文助手。"},
      {"role": "user", "content": "请用一句话介绍 LuminaToken。"}
    ]
  }'

Node.js 示例

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: "https://api.luminatoken.cc/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-4.1",
  messages: [
    { role: "system", content: "你是一个简洁的中文助手。" },
    { role: "user", content: "请用一句话介绍 LuminaToken。" },
  ],
});

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

调用注意事项

地址必须包含 /v1

很多 OpenAI 兼容客户端默认要求版本化根路径，因此推荐固定使用：

https://api.luminatoken.cc/v1

认证失败时先看 Bearer Token

最常见的问题是：

• API Key 复制不完整
• Header 名称写错
• Key 已失效或被删除

模型名以实际可用为准

示例中的模型名称仅用于演示调用结构。请根据你当前账号可用模型进行替换。

下一步

• 如果你使用 Claude 风格客户端，请继续阅读 Anthropic 格式。
• 如果你正在配置 Codex，可回看 Codex 概览。