LIGHTNIGHT / DOCUMENTATION
从这里连接你的 AI 服务
一个清楚的地址,一把属于本站的 Key。先完成首次调用,再把模型接入你习惯使用的工具。
账号、余额与 API Key 独立。请使用本站创建的 Key;其他站点的 Key 不能直接代用。
可以使用哪些服务
本站提供文本、生图、社媒数据服务;不提供视频或分销服务。
完成首次调用
查询可用模型,发送简单请求,核对结果与用量。
02 / DEVELOP接入大模型 API
查看三种对话协议的请求与响应说明。
03 / CONNECT配置常用客户端
连接 Codex、Claude Code 和聊天工具。
IMAGE生成与编辑图片
查看 GPT 与 Gemini 图片模型的入口和参数。
SOCIAL查询社媒公开数据
读取功能目录与报价,提交查询并获取结果。
推荐接入顺序
- 注册并登录本站,在控制台创建 Key。
- 从模型广场或模型目录复制完整模型 ID。
- 先查询模型目录,再做一次小规模调用。
- 在使用记录核对状态、模型和扣费,然后接入正式应用。
需要帮助时,保存请求编号与发生时间,通过本站工单或 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 验证调用身份,也决定你可以使用的模型分组。
创建步骤
- 登录本站,打开控制台 → 密钥管理。
- 创建密钥,填写便于区分用途的名称。
- 选择所需分组,核对有效期、额度和 IP 限制等设置。
- 保存密钥,在应用或客户端中配置。
请求头
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Claude Messages 也可使用 x-api-key,详见协议示例。同一请求只使用一种 Key 认证头。
分组与权限
通用密钥可按优先级选择多个已支持分组。不同分组对应不同价格,模型广场的分组单价已经包含倍率,不需要再自行乘一次。使用 GET /v1/models 核对当前 Key 可用模型。
日常管理
- 不同项目分别创建 Key,便于查看用量和停用。
- 只在受控服务端或本地客户端保存,不要放进网页源码、聊天内容或公开仓库。
- 怀疑泄露时停用旧 Key,并更新应用配置。反馈故障提供请求编号即可,无需发送完整 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 Completions | POST /v1/chat/completions | messages 对话格式 |
| Responses | POST /v1/responses | input 输入,Codex 使用此协议 |
| Claude Messages | POST /v1/messages | Claude 协议客户端 |
| 图片生成 | POST /v1/images/generations | 使用图片模型 |
| 参考图编辑 | POST /v1/images/edits | 支持编辑的 GPT 图片模型 |
| 社媒数据 | /v1/social-data/… | 目录、报价、查询及状态恢复 |
请求限制
常规 JSON 请求体上限 32 MiB,历史对话与 Base64 等编码内容也计入。具体服务可有更小限制,详见对应接口。Key、站点和模型通道可能有频率或并发限制,出现 429 时应降低并发并退避重试。
接入前检查
- 若客户端分别配置主机与 API 路径,避免重复拼接
/v1。 - 复制完整模型 ID,不要擅自删除后缀。
- JSON 请求使用 UTF-8,携带
Content-Type: application/json。 - Key 应保存在服务端;浏览器跨域请求可能受来源限制。
大模型 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 判定生成成功。
大模型 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 Completions | data 增量块、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、模型和地址。发送一个简短问题,并在本站使用记录确认。
排查配置
- 仍访问原服务:检查配置目录、profile 和运行环境。
- 提示缺少 Key:检查变量是否在客户端启动之前生效。
- 404 或 405:确认 Responses 协议与地址,没有重复 /v1。
本站提供手动配置说明,暂不提供自动配置安装脚本。
客户端配置
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,造成认证来源不清。
验证接入
- 重启 Claude Code,让环境变量生效。
- 运行
/status,核对当前配置与模型。 - 发送简短问题,在本站使用记录确认。
若客户端另外设置了快速模型或子任务模型,也应使用本站可用 ID。
客户端网关配置参考:Claude Code 官方文档 ↗
客户端配置
Chatbox / Cherry Studio
添加自定义 OpenAI 兼容服务。主机地址与 Base URL 的字段名称会随客户端版本变化。
Chatbox
在模型服务设置中添加自定义 OpenAI 兼容服务。若分别提供 API Host 与 API Path,按下表填写:
| 字段 | 内容 |
|---|---|
| API Host | https://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 和模型使用本站提供的值。
添加自定义服务
- 选择需要配置的应用,例如 Codex 或 Claude Code。
- 添加自定义服务,命名为 Lightnight。
- Codex 使用本站 Responses 配置;Claude Code 使用本站 Messages 环境变量。
- 保存、启用配置,重启目标客户端。
切换后核对
检查当前服务、模型和地址,避免旧配置或本地代理覆盖新设置。不要直接套用其他服务商预设中的 URL 或模型名。
字段与版本界面参考 CC Switch 项目文档 ↗。
图片服务
图片生成
在控制台直接文字生图,或通过 API 调用。请为 Key 选择图片模型所属分组。
POST https://ai.lightnight.cc/v1/images/generations
GPT Image:A / B 两档
A 档标准价 ¥0.05 / 张,B 档标准价 ¥0.15 / 张。同一把图片分组 Key 可通过完整模型 ID 选择档位;控制台会显示该账号当前生效的价格。
| 型号 | A 档模型 ID | B 档模型 ID |
|---|---|---|
| GPT Image 2 | gpt-image-2-a | gpt-image-2-b |
| GPT Image 2.5 | gpt-image-2.5-a | gpt-image-2.5-b |
| GPT Image 2.6 | gpt-image-2.6-a | gpt-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 调用。也可以只选一个渠道,或取消全部渠道停用该型号路由。
| 型号 | 路由模型 ID | Key 所需权限 |
|---|---|---|
| GPT Image 2 | gpt-image-2-route | 已选渠道对应的 gpt-image-2-a / gpt-image-2-b |
| GPT Image 2.5 | gpt-image-2.5-route | 已选渠道对应的 gpt-image-2.5-a / gpt-image-2.5-b |
| GPT Image 2.6 | gpt-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"
}
- 每次 1 张;不支持流式、批量与参考图编辑。
- prompt 最长 16,000 个字符;请求体上限 64 KiB。
- response_format 填 b64_json 或省略。
- size 可省略,或填 auto、1024x1024。后者仅作方形构图提示,不保证固定输出 1024 像素。
- 不要附加 quality 等未支持字段。GPT 系列的尺寸与质量参数也需按具体模型确认。
保存结果
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 状态。
使用帮助
错误排查
看状态码、错误正文和请求编号。单看状态码不能断定故障发生在哪一段服务。
常见状态码
| 状态 | 常见含义 | 检查方向 |
|---|---|---|
| 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 使用对应协议结构。部分底层错误会统一为服务错误,不应依赖非标准错误码长期不变。
反馈材料
- 时间与时区、本站账号邮箱。
- 完整模型 ID、请求方法与路径。
- HTTP 状态、脱敏错误正文和
x-request-id(如有)。 - 客户端名称,以及能否重复出现。
通过本站工单或 647182093@qq.com 联系,不需要发送密钥、密码或完整敏感请求体。
使用帮助
常见问题
兼容接口是什么意思?
表示按相应协议的请求字段、认证方式和响应结构接入,通常可在支持自定义服务的客户端修改地址、Key 和模型。兼容不代表具有原厂全部产品功能,也不表示所有模型支持全部参数。
其他站点的账号、余额和 Key 能直接用吗?
本站独立管理账号、余额和 Key。按本站注册、充值和迁移公告办理,不要直接使用旧 Key。余额迁移需求联系 647182093@qq.com。
为什么看到模型却调用失败?
同时核对 Key 分组、余额、限制设置、模型完整 ID 和参数。先用最小请求排除客户端附加参数问题。
HTTP 200 就是成功吗?
还要检查业务状态和结果:流式读取明确结束状态;图片检查是否有图片数据;社媒检查最终查询状态。
这里支持视频或火山素材库吗?
新站不支持视频生成、火山素材库和分销管理接口,不要将其他站点教程路径直接拼到本站域名上。
失败后会自动重试吗?
平台可按模型和故障类型使用备用通道,但不是所有请求都能切换,已返回部分内容的流式请求也不能无感重新生成。客户端应处理最终错误,并确认原请求状态后决定是否重新提交。
示例能直接运行吗?
先替换 Key、模型和参数,核对客户端环境。结构示例只说明格式,不代表已经替你发起调用;实际调用以本站当前报价计费。
社媒数据
目录、查询与结果
每个功能有自己的 action、参数和报价。先读取目录,再提交查询。
Key 需选择“社媒数据”分组。服务查询公开数据,不生成视频、不代发帖子。
接口列表
GET /v1/social-data/catalogGET /v1/social-data/pricingPOST /v1/social-data/callGET /v1/social-data/requests?request_id=YOUR_REQUEST_ID1. 读取目录和报价
选择 action,按对应 input_schema 填写 params,并复制当前 price_version。不同功能的参数、分页与数据范围不同。
2. 提交查询
除 Bearer 与 JSON Content-Type 外,添加
Idempotency-Key请求头。每个新查询生成一个 16–128 位唯一编号,只使用字母、数字、点、下划线、冒号或横线。这是字段模板,需替换实际参数与价格版本。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_…。不要为同一未确认请求换新编号反复提交。计费
按成功查询结算,分页每页独立计费。usage.amount 在成功时为实际人民币金额,明确失败时为 0,待确认时为 null。结合最终状态和使用记录核对。