Lightnight文档中心

LIGHTNIGHT / DOCUMENTATION

从这里连接你的 AI 服务

一个清楚的地址,一把属于本站的 Key。先完成首次调用,再把模型接入你习惯使用的工具。

本站地址:https://ai.lightnight.cc

账号、余额与 API Key 独立。请使用本站创建的 Key;其他站点的 Key 不能直接代用。

可以使用哪些服务

本站提供文本、生图、社媒数据服务;不提供视频或分销服务。

推荐接入顺序

  1. 注册并登录本站,在控制台创建 Key。
  2. 从模型广场或模型目录复制完整模型 ID。
  3. 先查询模型目录,再做一次小规模调用。
  4. 在使用记录核对状态、模型和扣费,然后接入正式应用。

需要帮助时,保存请求编号与发生时间,通过本站工单或 647182093@qq.com 联系我们。

开始使用

快速开始

先验证地址与密钥,再发起一次简短对话。下面的命令在你自己的终端执行。

1. 准备 Key 和模型

进入密钥管理创建 Key,选择需要的分组。实际模型调用需要足够余额,查询模型目录不生成内容。

将 Key 保存在本地环境变量 LIGHTNIGHT_API_KEY。cURL 示例使用 Bash 语法;Windows PowerShell 可使用 curl.exe,变量写为 $env:LIGHTNIGHT_API_KEY,并调整续行语法。

2. 查询可用模型

curl https://ai.lightnight.cc/v1/models \
  -H "Authorization: Bearer $LIGHTNIGHT_API_KEY"

响应中 data[].id 是完整模型 ID。目录由当前 Key 的权限决定,不能只根据模型展示名称填写。

3. 发起一次对话

下面以 gpt-6.1-sol 为例;若你的目录中没有它,请替换为实际可用的文本模型。

curl https://ai.lightnight.cc/v1/chat/completions \
  -H "Authorization: Bearer $LIGHTNIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"请用一句话介绍自己。"}],"stream":false}'

读取 choices[0].message.content,再到使用记录核对结果和金额。

Python 示例

import json
import os
import urllib.request

payload = {
    "model": "gpt-6.1-sol",
    "messages": [{"role": "user", "content": "你好,请简短回复。"}],
    "stream": False,
}
request = urllib.request.Request(
    "https://ai.lightnight.cc/v1/chat/completions",
    data=json.dumps(payload).encode("utf-8"),
    headers={
        "Authorization": "Bearer " + os.environ["LIGHTNIGHT_API_KEY"],
        "Content-Type": "application/json",
    },
    method="POST",
)
with urllib.request.urlopen(request, timeout=120) as response:
    result = json.load(response)
print(result["choices"][0]["message"]["content"])

120 秒是示例客户端的等待时间,不代表服务端每条链路或每个模型保证在此时间内结束。

开始使用

创建与管理 Key

Key 验证调用身份,也决定你可以使用的模型分组。

创建步骤

  1. 登录本站,打开控制台 → 密钥管理。
  2. 创建密钥,填写便于区分用途的名称。
  3. 选择所需分组,核对有效期、额度和 IP 限制等设置。
  4. 保存密钥,在应用或客户端中配置。

请求头

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Claude Messages 也可使用 x-api-key,详见协议示例。同一请求只使用一种 Key 认证头。

分组与权限

通用密钥可按优先级选择多个已支持分组。不同分组对应不同价格,模型广场的分组单价已经包含倍率,不需要再自行乘一次。使用 GET /v1/models 核对当前 Key 可用模型。

日常管理

开始使用

模型、分组与计费

价格以控制台当前展示和实际使用记录为准,本文不固定展示可能变动的单价。

在哪里查看

模型广场展示模型 ID、分组和当前价格;GET /v1/models 用于程序读取 Key 可见的模型目录。相似名称不代表相同参数、协议或计费方式。

先看计费单位

服务核对事项
文本模型输入、输出、缓存等项目,以对应模型与分组报价为准。
图片模型核对单次或规格价格、模型及张数,不要套用文本模型价格。
社媒数据先读取功能报价,实际查询按结果结算;分页每页独立计费。

核对实际扣费

在使用记录查看状态和金额。客户端没有收到响应,不代表服务端没有处理;遇到超时或断连,先保留请求编号并核对记录,再决定是否重试。

本站余额独立。账号迁移以实际公告与办理规则为准,不要默认其他站点的余额已转入。

大模型 API

接口总览

按客户端选择协议。兼容协议表示采用对应请求与响应格式,不代表所有模型支持所有参数。

统一请求地址

站点地址        https://ai.lightnight.cc
OpenAI Base URL https://ai.lightnight.cc/v1
Claude Base URL https://ai.lightnight.cc
接口方法与路径用途
模型目录GET /v1/models当前 Key 可见的模型
Chat CompletionsPOST /v1/chat/completionsmessages 对话格式
ResponsesPOST /v1/responsesinput 输入,Codex 使用此协议
Claude MessagesPOST /v1/messagesClaude 协议客户端
图片生成POST /v1/images/generations使用图片模型
参考图编辑POST /v1/images/edits支持编辑的 GPT 图片模型
社媒数据/v1/social-data/…目录、报价、查询及状态恢复

请求限制

常规 JSON 请求体上限 32 MiB,历史对话与 Base64 等编码内容也计入。具体服务可有更小限制,详见对应接口。Key、站点和模型通道可能有频率或并发限制,出现 429 时应降低并发并退避重试。

接入前检查

大模型 API

Chat Completions

POST https://ai.lightnight.cc/v1/chat/completions

适用于常规聊天客户端及 messages 格式的应用。

请求体示例

{
  "model": "gpt-6.1-sol",
  "messages": [{"role": "user", "content": "用三句话解释什么是 API。"}],
  "stream": false
}
字段必填说明
model是当前 Key 可用的文本模型 ID
messages是对话数组;历史消息由调用方按需携带
stream否true 使用 SSE;false 返回完整响应

读取结果

普通回复通常在 choices[0].message.content。工具调用还需处理对应字段,不能把所有响应当作纯文本。下面仅是简化的结构示例:

{
  "id": "EXAMPLE_RESPONSE_ID",
  "object": "chat.completion",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "API 是应用之间约定的数据交互接口。"},
    "finish_reason": "stop"
  }]
}

扩展参数

temperature、输出长度、工具调用、多模态输入等取决于模型。遇到参数错误,先验证最小请求,再逐项添加参数。

大模型 API

Responses

POST https://ai.lightnight.cc/v1/responses

适合 Responses 协议应用,包括本站的 Codex 接入方式。

请求体示例

{
  "model": "gpt-6.1-sol",
  "input": "请解释这段代码的作用:print(1 + 1)",
  "store": false,
  "stream": false
}

input 可按模型支持范围使用文本或结构化输入。示例使用 store: false,应用自行管理需要携带的上下文。

读取输出

原始 JSON 的文本位于 output 数组中的消息内容,读取 output[].content[] 中类型为 output_text 的 text。不要假设第一项必定是文本消息;部分 SDK 提供 output_text 便利属性。

流式与上下文

设置 stream: true 后,按流式事件处理增量与结束状态。不能只凭 HTTP 200 判定生成成功。

历史响应引用等服务端状态可能依赖原处理通道。不要混用不同协议、客户端会话或通道返回的状态 ID。

大模型 API

Claude Messages

POST https://ai.lightnight.cc/v1/messages

认证与版本头

x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01
Content-Type: application/json

也支持 Bearer 认证,同一请求只选择一种 Key 认证头。

请求体示例

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 256,
  "messages": [{"role": "user", "content": "你好,请简短介绍自己。"}],
  "stream": false
}

替换为本站实际可用的 Claude 模型。max_tokens 是输出上限;系统提示使用 Messages 协议的 system 字段,不要照搬其他协议布局。

读取结果

按 content 数组中的类型处理内容,文本块读取 text;工具调用块需按协议补充工具结果。Claude Code 配置见客户端指南。

大模型 API

流式响应

连接建立、收到一段文本和完整生成结束,是不同状态。

发起 SSE 调用

JSON 中设置 stream: true。cURL 使用 -N 避免输出缓冲。

curl -N https://ai.lightnight.cc/v1/responses \
  -H "Authorization: Bearer $LIGHTNIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6.1-sol","input":"你好","store":false,"stream":true}'

判断完成状态

协议需要处理
Chat Completionsdata 增量块、finish_reason 与流结束标记
Responses文本增量事件,以及 completed、failed 或 incomplete 等结束状态
Claude Messages消息与内容块增量、停止原因及 message_stop

SSE 事件边界不同于网络读取块边界。解析器应缓冲不完整事件,不能将每次网络读取直接当成完整 JSON。

中途断开

保留已收到内容并提示生成未完成,不要将新调用结果无提示地拼到原回复末尾。断连不等于未计费,先保存请求编号、核对记录,再决定是否重试。

客户端配置

Codex

使用本站 Responses 接口,从本地环境变量读取 Key。

合并配置

先备份 config.toml,在当前 Codex 实际使用的配置目录中合并以下配置,不要覆盖其他项目设置。模型 ID 以本站目录为准。

model = "gpt-6.1-sol"
model_provider = "lightnight"

[model_providers.lightnight]
name = "Lightnight"
base_url = "https://ai.lightnight.cc/v1"
wire_api = "responses"
env_key = "LIGHTNIGHT_API_KEY"
requires_openai_auth = false
supports_websockets = false

设置 Key 并重启

通过受保护的本地配置设置 LIGHTNIGHT_API_KEY。启动 Codex 的进程必须能够读取该变量;在终端临时设置变量,不一定会被已经打开的桌面客户端继承。

重新启动客户端,核对 provider、模型和地址。发送一个简短问题,并在本站使用记录确认。

排查配置

本站提供手动配置说明,暂不提供自动配置安装脚本。

客户端配置

Claude Code

使用本站 Messages 接口,这里的 Base URL 填站点根地址。

设置环境变量

ANTHROPIC_BASE_URL=https://ai.lightnight.cc
ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
ANTHROPIC_MODEL=claude-sonnet-4-6

替换实际 Key 与可用模型 ID。Base URL 不附加 /v1,客户端会补 Messages 路径;避免同时保留其他服务的 ANTHROPIC_API_KEY,造成认证来源不清。

验证接入

  1. 重启 Claude Code,让环境变量生效。
  2. 运行 /status,核对当前配置与模型。
  3. 发送简短问题,在本站使用记录确认。

若客户端另外设置了快速模型或子任务模型,也应使用本站可用 ID。

客户端配置

Chatbox / Cherry Studio

添加自定义 OpenAI 兼容服务。主机地址与 Base URL 的字段名称会随客户端版本变化。

Chatbox

在模型服务设置中添加自定义 OpenAI 兼容服务。若分别提供 API Host 与 API Path,按下表填写:

字段内容
API Hosthttps://ai.lightnight.cc
API Path/v1/chat/completions
API Key本站 Key
模型 ID从本站目录复制,例如 gpt-6.1-sol

Cherry Studio

添加自定义 OpenAI 兼容服务,填写本站 Key。若字段要求 OpenAI Base URL,填 https://ai.lightnight.cc/v1;若当前版本自动追加 /v1,只填根地址。最终请求应为:

https://ai.lightnight.cc/v1/chat/completions

添加实际可用的模型 ID,保存后选中模型发送简短消息,以本站使用记录验证。

附加功能

文本聊天连通不代表客户端全部功能已适配。联网、知识库、向量检索和图片工具可能使用不同接口,请分别核对。

客户端配置

CC Switch

配置管理工具负责切换客户端设置;地址、Key 和模型使用本站提供的值。

添加自定义服务

  1. 选择需要配置的应用,例如 Codex 或 Claude Code。
  2. 添加自定义服务,命名为 Lightnight。
  3. Codex 使用本站 Responses 配置;Claude Code 使用本站 Messages 环境变量。
  4. 保存、启用配置,重启目标客户端。

切换后核对

检查当前服务、模型和地址,避免旧配置或本地代理覆盖新设置。不要直接套用其他服务商预设中的 URL 或模型名。

图片服务

图片生成

在控制台直接文字生图,或通过 API 调用。请为 Key 选择图片模型所属分组。

POST https://ai.lightnight.cc/v1/images/generations

GPT Image:A / B 两档

A 档标准价 ¥0.05 / 张,B 档标准价 ¥0.15 / 张。同一把图片分组 Key 可通过完整模型 ID 选择档位;控制台会显示该账号当前生效的价格。

型号A 档模型 IDB 档模型 ID
GPT Image 2gpt-image-2-agpt-image-2-b
GPT Image 2.5gpt-image-2.5-agpt-image-2.5-b
GPT Image 2.6gpt-image-2.6-agpt-image-2.6-b

直接使用以上 -a 或 -b 模型 ID 时,本次请求按所选档位调用,失败不会自动切换另一档。A / B 档每次只生成 1 张,n 填 1;当前仅支持文字生图,不支持参考图编辑与流式输出。以下直接调用示例均使用 1024x1024 尺寸:A 档 quality 填 standard,B 档填 high。

size 为请求尺寸,实际输出尺寸以上游结果为准;B 档请求 1024x1024 时,可能返回 1254x1254。

按 Key 自选渠道顺序

需要自动切换时,在Key 管理点击该 Key 的「图片路由」,分别为每个图片型号勾选 A / B 并排序。默认不勾选;保存后,使用下表的路由模型 ID 调用。也可以只选一个渠道,或取消全部渠道停用该型号路由。

型号路由模型 IDKey 所需权限
GPT Image 2gpt-image-2-route已选渠道对应的 gpt-image-2-a / gpt-image-2-b
GPT Image 2.5gpt-image-2.5-route已选渠道对应的 gpt-image-2.5-a / gpt-image-2.5-b
GPT Image 2.6gpt-image-2.6-route已选渠道对应的 gpt-image-2.6-a / gpt-image-2.6-b

路由 ID 是本站的调用名称,不需要把 -route 添加到 Key 的模型权限里。Key 需要图片分组及所选 -a / -b 型号权限;保存路由不会扩大 Key 权限。

例如保存 A → B:A 成功按 ¥0.05 扣费;A 明确失败后转 B,B 成功按 ¥0.15 扣费,只按最终成功渠道扣费一次,不累加两档费用。最高扣费随所选渠道和当前账号价格展示;配置或价格发生变化时,需要重新读取并核对。

只有确认未生成的失败才尝试下一个渠道。正常排队、生成中、超时或断连导致结果不确定时,不继续切换;先核对结果与使用记录,避免重复生成。

读取当前 Key 的路由与价格

此只读接口不发起生图。返回该 Key 可用型号的渠道、顺序、价格、最高扣费和配置版本。未配置的型号返回空顺序。

curl https://ai.lightnight.cc/v1/image-routing \
  -H "Authorization: Bearer $LIGHTNIGHT_API_KEY"

发起一次路由生图

请求必须带 Idempotency-Key,长度为 16–128 个字符,建议使用随机 UUID。每次新的生图使用新值;同一次请求因网络问题重复发送时,保留原值和相同参数。下例先为一次生图生成标识,再提交请求;不要在网络重试时再次运行生成标识的命令。

export IMAGE_REQUEST_ID="$(python -c 'import uuid; print(uuid.uuid4())')"
curl https://ai.lightnight.cc/v1/images/generations \
  -H "Authorization: Bearer $LIGHTNIGHT_API_KEY" \
  -H "Idempotency-Key: $IMAGE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2-route","prompt":"一只橘猫坐在窗边,午后自然光","n":1,"size":"1024x1024"}'
{
  "model": "gpt-image-2-route",
  "prompt": "一只橘猫坐在窗边,午后自然光",
  "n": 1,
  "size": "1024x1024"
}

路由请求不传 quality,服务端自动使用 A 的 standard、B 的 high。支持 1024x1024、1536x1024、1024x1536 三种请求尺寸,每次 1 张;不支持参考图编辑与流式输出。成功响应的 routing.successfulTier 表示实际成功渠道,routing.chargedCny 表示本次人民币扣费;图片仍从 data 读取。

其他图片模型与能力

模型 ID文字生图参考图编辑 API
gpt-image-2支持支持
gpt-image-2.5-flare支持支持
gpt-image-2.5-sunburst支持支持
gpt-image-2.6-flare支持支持
gpt-image-2.6-sunburst支持支持
gemini-2.5-flash-image-per-call支持不支持
gemini-3-pro-image-per-call支持不支持
gemini-3.1-flash-image-per-call支持不支持
gemini-nano-banana-2.1-per-call支持不支持

实际可选模型以当前 Key 目录为准,请保留完整后缀。Gemini 图片也使用本页接口;本站不支持供客户直接调用 Gemini 原生 generateContent 路径。

文字生图示例

{
  "model": "gpt-image-2-a",
  "prompt": "一只橘猫坐在窗边,午后自然光,写实照片",
  "n": 1,
  "response_format": "b64_json",
  "quality": "standard",
  "size": "1024x1024"
}
curl https://ai.lightnight.cc/v1/images/generations \
  -H "Authorization: Bearer $LIGHTNIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2-b","prompt":"一只橘猫坐在窗边,午后自然光","n":1,"response_format":"b64_json","quality":"high","size":"1024x1024"}'

上方 JSON 示例选择 A 档;curl 示例选择同型号 B 档,同时将 quality 设为 high。无需更换接口地址。改选档位后重新提交,是一笔新的付费请求。

Gemini / Nano Banana

{
  "model": "gemini-nano-banana-2.1-per-call",
  "prompt": "咖啡店春季海报,柔和绿色背景,简洁构图",
  "n": 1,
  "response_format": "b64_json"
}

保存结果

data[].b64_json 是图片 Base64,解码后保存;若返回 data[].url,请及时下载。不要将完整 Base64 写入常规日志。

控制台每次文字生图 1 张,参考图使用编辑 API。超时或断连后先核对使用记录,避免重复生成。

图片服务

参考图编辑

POST https://ai.lightnight.cc/v1/images/edits

使用 multipart/form-data,适用于本站支持编辑的 GPT 图片模型。GPT Image 的 A / B 档与 Gemini 按次图片模型不支持此入口。

上传参考图

curl https://ai.lightnight.cc/v1/images/edits \
  -H "Authorization: Bearer $LIGHTNIGHT_API_KEY" \
  -F "model=gpt-image-2" \
  -F "prompt=保留主体,将背景改为明亮的室内摄影棚" \
  -F "image=@reference.png"

将 reference.png 替换为本地图片。由客户端自动生成 multipart Content-Type 与 boundary,不要手动使用普通 JSON Content-Type。

文件限制

multipart 总请求体上限 24 MiB,包含全部字段、文件及编码开销。具体文件格式、尺寸与扩展参数取决于目标模型,建议先用一张常规 PNG 或 JPEG 验证。

读取结果

与图片生成结果读取方式相同。收到图片后检查内容与尺寸是否满足需求,不要只检查 HTTP 状态。

社媒数据

目录、查询与结果

每个功能有自己的 action、参数和报价。先读取目录,再提交查询。

Key 需选择“社媒数据”分组。服务查询公开数据,不生成视频、不代发帖子。

接口列表

方法与路径用途
GET /v1/social-data/catalog功能目录与参数 schema,不扣费
GET /v1/social-data/pricing报价与价格版本,不扣费
POST /v1/social-data/call提交查询
GET /v1/social-data/requests?request_id=YOUR_REQUEST_ID按原请求编号恢复查询

1. 读取目录和报价

curl https://ai.lightnight.cc/v1/social-data/catalog \
  -H "Authorization: Bearer $LIGHTNIGHT_API_KEY"

curl https://ai.lightnight.cc/v1/social-data/pricing \
  -H "Authorization: Bearer $LIGHTNIGHT_API_KEY"

选择 action,按对应 input_schema 填写 params,并复制当前 price_version。不同功能的参数、分页与数据范围不同。

2. 提交查询

除 Bearer 与 JSON Content-Type 外,添加 Idempotency-Key 请求头。每个新查询生成一个 16–128 位唯一编号,只使用字母、数字、点、下划线、冒号或横线。

Idempotency-Key: YOUR_UNIQUE_REQUEST_ID
{
  "action": "COPY_ACTION_FROM_CATALOG",
  "params": {},
  "max_cost_cny": "0.10",
  "price_version": "COPY_PRICE_VERSION_FROM_PRICING"
}

这是字段模板,需替换实际参数与价格版本。max_cost_cny 是本次允许消费的人民币上限,示例 0.10 不是所有功能的报价。请求体上限 128 KiB。

3. 检查最终状态

同时查看 HTTP 和业务状态:HTTP 200 也可能携带失败状态;202 的 pending 或 review_required 表示结果尚未确认。

遇到 202 或断连,用原 Idempotency-Key 作为 request_id 查询。也可使用响应 SD_… 编号请求 /v1/social-data/requests/SD_…。不要为同一未确认请求换新编号反复提交。

curl 'https://ai.lightnight.cc/v1/social-data/requests?request_id=YOUR_UNIQUE_REQUEST_ID' \
  -H "Authorization: Bearer $LIGHTNIGHT_API_KEY"

计费

按成功查询结算,分页每页独立计费。usage.amount 在成功时为实际人民币金额,明确失败时为 0,待确认时为 null。结合最终状态和使用记录核对。

使用帮助

错误排查

看状态码、错误正文和请求编号。单看状态码不能断定故障发生在哪一段服务。

常见状态码

状态常见含义检查方向
400参数不符合要求JSON、模型 ID、必填字段和模型参数
401认证失败Key、认证头、有效期及停用状态
403请求被拒绝分组、IP / 来源限制及错误描述
404路径或资源不存在路径拼接、模型或资源 ID
405方法不支持生成接口使用 POST,确认本站支持该协议路径
408接收请求超时等上传网络、大小和完整错误正文
413请求体过大历史对话、素材和编码开销,注意接口具体上限
415内容类型不支持JSON Content-Type 或 multipart 编码
429频率、并发或配额限制降低并发;若有 Retry-After 按其等待;核对额度
502 / 503 / 504服务错误、不可用或等待超时保存请求编号,核对使用记录,避免密集重复提交

错误正文

接口通常通过 error 对象返回 code、type 或 message;Claude 使用对应协议结构。部分底层错误会统一为服务错误,不应依赖非标准错误码长期不变。

反馈材料

通过本站工单或 647182093@qq.com 联系,不需要发送密钥、密码或完整敏感请求体。

使用帮助

常见问题

兼容接口是什么意思?

表示按相应协议的请求字段、认证方式和响应结构接入,通常可在支持自定义服务的客户端修改地址、Key 和模型。兼容不代表具有原厂全部产品功能,也不表示所有模型支持全部参数。

其他站点的账号、余额和 Key 能直接用吗?

本站独立管理账号、余额和 Key。按本站注册、充值和迁移公告办理,不要直接使用旧 Key。余额迁移需求联系 647182093@qq.com。

为什么看到模型却调用失败?

同时核对 Key 分组、余额、限制设置、模型完整 ID 和参数。先用最小请求排除客户端附加参数问题。

HTTP 200 就是成功吗?

还要检查业务状态和结果:流式读取明确结束状态;图片检查是否有图片数据;社媒检查最终查询状态。

这里支持视频或火山素材库吗?

新站不支持视频生成、火山素材库和分销管理接口,不要将其他站点教程路径直接拼到本站域名上。

失败后会自动重试吗?

平台可按模型和故障类型使用备用通道,但不是所有请求都能切换,已返回部分内容的流式请求也不能无感重新生成。客户端应处理最终错误,并确认原请求状态后决定是否重新提交。

示例能直接运行吗?

先替换 Key、模型和参数,核对客户端环境。结构示例只说明格式,不代表已经替你发起调用;实际调用以本站当前报价计费。