API 概览

LuminaToken 提供统一的 API 接入层，当前文档主要覆盖两种调用格式：

1. OpenAI 格式
2. Anthropic 格式

无论你使用哪一种，核心目标都一样：通过统一地址和统一 API Key 接入模型能力。

接口能力概览

项目	说明
接口根地址	https://api.luminatoken.cc/v1
支持格式	OpenAI、Anthropic
认证信息	使用 LuminaToken 控制台创建的 API Key
控制台地址	https://luminatoken.cc

什么时候用哪种格式

OpenAI 格式

适合：

• OpenAI SDK
• OpenAI 兼容工具
• 习惯 Authorization: Bearer 认证方式的脚本或服务

Anthropic 格式

适合：

• Claude 风格 SDK 或工具
• 习惯 x-api-key 认证方式的客户端

快速开始

建议按下面的顺序完成接入：

1. 在 https://luminatoken.cc 注册并登录。
2. 创建 API Key。
3. 充值并确认余额可用。
4. 选择 OpenAI 或 Anthropic 格式。
5. 使用 https://api.luminatoken.cc/v1 作为接口根地址发起第一次请求。

Python 示例

OpenAI 格式

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)

Anthropic 格式

import anthropic

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

response = client.messages.create(
    model="claude-3-7-sonnet-latest",
    max_tokens=256,
    messages=[
        {"role": "user", "content": "请用一句话介绍 LuminaToken。"}
    ],
)

print(response.content[0].text)

调用建议

先从最小请求开始

先只发一个简单问题，确认认证、地址和模型名称都正确，再进入复杂业务调用。

用不同 Key 区分环境

建议把本地开发、测试环境和生产环境拆开管理。

记录失败请求上下文

排障时，至少保留：

• 请求时间
• 使用的接口格式
• 模型名称
• 错误码或报错原文

延伸阅读

• 想看 OpenAI 风格请求细节，请阅读 OpenAI 格式。
• 想看 Claude 风格请求细节，请阅读 Anthropic 格式。