× 0.26
【Deespeek】
供应商原生 Responses 端点，适配Codex.
NEZHA API / 开发者文档
哪吒API中转站开发者文档。
用熟悉的 API，连接文本、图片、视频与音频。
从第一个请求，到你的下一个作品。
BASE URL
https://nezhai.vip/v1OpenAI 兼容客户端使用此地址，无需重复添加 /v1。查看客户端配置
一个入口，四种创作能力
按你要构建的功能开始47 个模型
文本生成
对话、推理与代码
查看接入指南 32 个模型图片生成
文生图与参考图编辑
查看接入指南 29 个模型视频生成
异步任务与视频超分
查看接入指南 6 个模型音频生成
音乐生成与文本转语音
查看接入指南第一次使用哪吒？
跟着指南开始使用你自己的可用模型列表
GET /v1/models 返回当前 Key 与分组可用的完整模型 ID。模型价格以定价页为准。
注册账号
- 打开 https://nezhai.vip 注册账号。
- 登录后进入控制台。后面的令牌、分组和余额都在这里。
余额与充值
10 / 20 / 50 元无赠送。100 / 200 / 500 / 1000 元赠送 3%。余额不足时接口返回 402，充值后再提交。
创建 API Key
在控制台新建令牌，分组从列表里点选，不要手打。请求使用：
HTTP
Authorization: Bearer sk-替换为你的哪吒API-Key- Key 不放进 URL、前端公开代码、Git 或截图。
- 不同 Key 和分组可能看到不同模型。
- Key 泄露后先撤销，再新建。反馈问题时只提供脱敏的 request id。
选择分组
在创建令牌时选择分组。不同分组影响可用模型和计费倍率，以下为本次公开定价快照，最终扣费以账单为准。
× 0.288
【GPT-大户/企业-pro】
大户企业专用分组-(满血满缓存-3分钟检测)
× 0.255
【Grok-马斯克】
用特价的grok，这个是备用的。
× 1.08
【claude -max】
官连满血cc-max，【保真高SLA】
× 0.4
【claude-kiro渠道90缓存】
CLAUDEKIRO 反代 可通过糖果智力测试
× 0.16
【claude-kiro渠道】
高缓稳定，持续输出。
× 0.12
【codex】GPT--特价
plus+pro20x混池(缓存在线。概率降智)
× 0.15
【gemini--哈基米】
推荐使用dsh，或者codex 反重力渠道
× 0.23
【gpt-codex-pro】
pro20号池分组-(满血号池-10分钟一轮检查降智)
× 0.23
【国产福利模型】
福利模型，仅供学生助力！！！
× 0.13
【特价Grok-马斯克】
【推荐】特价 heawy号池渠道
× 0.9
【生图组】
× 0.066
【福利组0.06】GPT
不稳定保证，号没了了随时可能会下的
× 0.36
企业专线
官key渠道（100% 满智）
× 0.4
站长测试
站长测试用的
× 0.9
音频生成
音频生成
客户端配置
Cherry Studio、Chatbox，以及任意 OpenAI 兼容客户端，都只改这三项。本页不代表这三个客户端已经逐个实测。
通用配置
Base URL: https://nezhai.vip/v1
API Key: sk-替换为你的哪吒API-Key
Model: 从 /v1/models 获取的完整模型 ID模型填完整 ID，不要截断，也不要自己加后缀。Windows、macOS、Linux 用同一个 Base URL。
聊天对话
POST /v1/chat/completions。先用 GET /v1/models 拿到当前 Key 可见的模型 ID。
cURL
curl https://nezhai.vip/v1/chat/completions \
-H "Authorization: Bearer sk-替换为你的哪吒API-Key" \
-H "Content-Type: application/json" \
-d '{
"model": "从 /v1/models 获取的模型 ID",
"messages": [{"role": "user", "content": "你好"}],
"stream": false
}'创建返回 model_not_found 时，停止这个模型的新提交，核对精确 ID 和分组。不要自动换成别的模型，也不要重复创建。
2026-10-27 香蕉/MJ 更新：香蕉五款、稳定 MJ 五款、特惠 MJ 五款；旧高速型号停止新建，历史作品与账单保留。稳定 MJ 原生 POST /v1/midjourney/generations 返回 202；图片兼容入口默认同步等待。所有 MJ n=1，四单图与可选封面分别处理。GPT 服务沿用原渠道。
图片生成与编辑
网页生图用 哪吒画布。下面是 API 调用。
文生图通常使用 POST /v1/images/generations。以下为像素协议 GPT Image 系列的调用示例；参考图编辑使用 POST /v1/images/edits 和 multipart，不要手动设置 boundary。
图片型号的请求格式不同
以下代码中的模型占位符请替换为可用的像素协议 GPT Image 型号。Grok 编辑使用 JSON image / images，不使用 multipart；其他型号请按各自协议，先确认编辑能力。
生成
curl https://nezhai.vip/v1/images/generations \
-H "Authorization: Bearer sk-替换为你的哪吒API-Key" \
-H "Content-Type: application/json" \
-d '{
"model": "从 /v1/models 获取的图片模型 ID",
"prompt": "一座雨中的城市",
"n": 1,
"size": "模型支持的尺寸"
}'编辑
curl https://nezhai.vip/v1/images/edits \
-H "Authorization: Bearer sk-替换为你的哪吒API-Key" \
-F "model=从 /v1/models 获取的图片模型 ID" \
-F "prompt=把背景改成夜景" \
-F "image=@input.png" - 像素协议 GPT Image 2 / 2.5：2K、4K 使用型号后缀
*-2k/*-4k，不要在同一个 ID 上另传分辨率。 - 香蕉五款使用 image/images 参考图字段；Nano Banana 2 支持 512；2.1 使用 thinking_level；Lite 固定 1k；2.5 不传 resolution/quality，最多三张参考图。
- JSON 协议
gpt-image2/*1k2k4k使用各型号的resolution与比例size；Grok 使用resolution与aspect_ratio，不要与GPT Image 像素尺寸混用。 - 稳定 Midjourney 优先使用
POST /v1/midjourney/generations，返回 202；特惠使用POST /v1/images/generations。使用本站任务 ID 查询GET /v1/tasks/{task_id}。 - Midjourney：
size填画幅比。不要把--ar/--v写进提示词。 - 优先读
data[].url，没有 URL 时读data[].b64_json。多张结果逐张保存。
视频生成
视频生成是异步任务
创建后保存任务 ID，继续查询并在完成后下载。模型和价格以当前目录及定价页为准。
卡藏生成视频按次实付为官方价加 1 元，按秒实付为官方每秒价加 0.1 元。公开定价表达式已经包含这部分加价，按分组倍率计算后无需再次加收。其他渠道和视频超分按各自定价规则计算。
创建 POST /v1/videos，查询 GET /v1/videos/{task_id}，下载 GET /v1/videos/{task_id}/content。本地文件先上传，再把返回的 HTTPS URL 放进参考字段：
上传
POST https://media.nezhahuabu.vip/api/canvas-storage/media/uploads已有公网 URL 不必再上传。创建超时后如果响应里已经有任务 ID，只继续查询，不要再 POST 一次。
创建
curl https://nezhai.vip/v1/videos \
-H "Authorization: Bearer sk-替换为你的哪吒API-Key" \
-H "Content-Type: application/json" \
-d '{
"model": "S-2.5-满血按次-线路十一",
"prompt": "雨夜的海边公路",
"duration_seconds": 30,
"resolution": "720p",
"aspect_ratio": "16:9"
}'查询
curl https://nezhai.vip/v1/videos/任务ID \
-H "Authorization: Bearer sk-替换为你的哪吒API-Key" 下载
curl -L https://nezhai.vip/v1/videos/任务ID/content \
-H "Authorization: Bearer sk-替换为你的哪吒API-Key" \
-o result.mp4线路十一
【生图组】：¥5.5/次。 固定 720p。时长为整数 4–30 秒，默认 30，不要用小数。比例：adaptive / 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16，默认 16:9。提示词必填，最多 16000 个 UTF-16 代码单元。参考字段 referenceImages / referenceVideos / referenceAudios，最多 30 图、10 视频、10 音频，合计 50。单图和双图都是普通参考，不会自动当成首尾帧。
线路十一
{
"model": "S-2.5-满血按次-线路十一",
"prompt": "参考人物和场景生成连贯镜头",
"duration_seconds": 30,
"resolution": "720p",
"aspect_ratio": "16:9",
"referenceImages": ["https://assets.example.com/reference.png"],
"referenceVideos": ["https://assets.example.com/reference.mp4"],
"referenceAudios": ["https://assets.example.com/reference.mp3"]
}历史示例 · Z 渠道 Seedance（当前公开目录未收录）
以下保留历史参数供已有项目核对；新接入请先用自己的 Key 查询 GET /v1/models，以实际可用结果为准。
z-channel-seedance-2.0：当前公开目录未收录该型号，请先用自己的 Key 查询可用模型。 原参数时长只能 5 / 10 / 15 秒，默认 10。
z-channel-seedance-2.5：当前公开目录未收录该型号，请先用自己的 Key 查询可用模型。 原参数时长只能 5 / 10 / 30 秒，默认 10。15 秒和自定义 4–29 秒不可用。
两个型号都只走本站 /v1/videos。固定 720p。比例 16:9（默认）、9:16、1:1、4:3、3:4。没有 21:9 和 adaptive。最多 10 张参考图。参考视频、参考音频和首尾帧暂不开放。不要改成别的型号名，也不要打 /videos/generations。旧文档里的单次金额如果和这里不同，以本次定价接口为准。
z-channel-seedance-2.0
{
"model": "z-channel-seedance-2.0",
"prompt": "海边走路的镜头",
"duration_seconds": 10,
"resolution": "720p",
"aspect_ratio": "16:9"
}z-channel-seedance-2.5
{
"model": "z-channel-seedance-2.5",
"prompt": "海边走路的镜头",
"duration_seconds": 10,
"resolution": "720p",
"aspect_ratio": "16:9"
}Suno 音乐
精确 ID：suno-v5、suno-v5.5、suno-v6、suno-v6-mini、suno-v6-wild。默认 suno-v5。旧 ID suno 已下架。
POST /v1/chat/completions。只要纯文本 messages，1–32 条，合并最多 3000 个 UTF-16。n 为 1，拒绝 stream: true。可选 instrumental: true 生成纯音乐。不要再传 lyrics 或 style_text。返回几段音频就保存几段，不固定两首，也不轮询。
【生图组】：¥0.28/次；音频生成：¥0.28/次。 按次计费，不套用视频加价。
响应里的音频地址是 https://media.nezhahuabu.vip/api/kacang-audio/proxy-download/<token>，约 24 小时内有效，请及时保存。不要改去别的域名。
JSON
{
"model": "suno-v5",
"messages": [{"role": "user", "content": "summer guitar, warm"}],
"instrumental": true,
"n": 1,
"stream": false
}cURL
curl https://nezhai.vip/v1/chat/completions \
-H "Authorization: Bearer sk-替换为你的哪吒API-Key" \
-H "Content-Type: application/json" \
-d '{"model":"suno-v5","messages":[{"role":"user","content":"summer guitar, warm"}],"n":1,"stream":false}'Cloudflare 长同步可能超时时，用同一 Key 改走 https://media.nezhahuabu.vip/api/kacang-audio/v1/chat/completions。
语音合成
精确 ID：gemini-3.8-flash-tts。兼容口 POST /v1/audio/speech 输出 WAV，只收文本，默认音色 Kore，response_format 仅 wav。
音频生成：¥0.056/次；【生图组】：¥0.056/次。 按次计费，不随时长加价。
JSON
{
"model": "gemini-3.8-flash-tts",
"input": "你好，这是一段测试语音。",
"voice": "Kore",
"response_format": "wav"
}cURL
curl https://nezhai.vip/v1/audio/speech \
-H "Authorization: Bearer sk-替换为你的哪吒API-Key" \
-H "Content-Type: application/json" \
-d '{"model":"gemini-3.8-flash-tts","input":"你好，这是一段测试语音。","voice":"Kore","response_format":"wav"}'原生口 POST /v1beta/models/gemini-3.8-flash-tts:generateContent 需要 responseModalities 为 ["AUDIO"]，并带 speechConfig。同一 Key 的灰云地址：
灰云
https://media.nezhahuabu.vip/api/kacang-audio/v1/audio/speech
https://media.nezhahuabu.vip/api/kacang-audio/v1beta/models/gemini-3.8-flash-tts:generateContent模型与价格114
选择模型，展开查看它的请求参数、必填项、默认值、取值范围和完整示例。参数区分本站已记录、上游公开契约与协议字段；未公开的限制会明确标注。实际可调用模型以当前 Key 的 GET /v1/models 为准。
模型参数统一生成目录快照 2026-10-24 · 能力版本 2026-10-23.001核对当前可用模型
模型计费方式 / 分组
文本生成
claude-fable-5
按量计费2 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-fable-5" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 同名上游元数据（不是哪吒保证）={"default":"medium","options":["low","medium","high"],"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-fable-5",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-fable-5" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-fable-5",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-fable-5" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-fable-5",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-fable-5" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-fable-5",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/claude-fable-5:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-fable-5" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-fable-5:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-fable-5" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/claude-fable-5:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
claude-fable-5-1
按量计费2 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-fable-5-1" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 同名上游元数据（不是哪吒保证）={"default":"medium","options":["low","medium","high"],"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-fable-5-1",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-fable-5-1" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-fable-5-1",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-fable-5-1" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-fable-5-1",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-fable-5-1" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-fable-5-1",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/claude-fable-5-1:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-fable-5-1" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-fable-5-1:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-fable-5-1" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/claude-fable-5-1:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
claude-haiku-4-5
按公式计费2 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-haiku-4-5" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-haiku-4-5",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-haiku-4-5" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-haiku-4-5",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-haiku-4-5" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-haiku-4-5",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-haiku-4-5" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-haiku-4-5",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/claude-haiku-4-5:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-haiku-4-5" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-haiku-4-5:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-haiku-4-5" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/claude-haiku-4-5:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按量计费3 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-haiku-4-5-20251001" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-haiku-4-5-20251001",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-haiku-4-5-20251001" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-haiku-4-5-20251001",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-haiku-4-5-20251001" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-haiku-4-5-20251001",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-haiku-4-5-20251001" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-haiku-4-5-20251001",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/claude-haiku-4-5-20251001:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-haiku-4-5-20251001" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-haiku-4-5-20251001:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-haiku-4-5-20251001" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/claude-haiku-4-5-20251001:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按量计费1 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-1-20250805" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-1-20250805",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-1-20250805" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-1-20250805",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-1-20250805" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-1-20250805",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-1-20250805" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-1-20250805",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/claude-opus-4-1-20250805:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-opus-4-1-20250805" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-opus-4-1-20250805:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-1-20250805" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/claude-opus-4-1-20250805:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按量计费1 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-20250514" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-20250514",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-20250514" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-20250514",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-20250514" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-20250514",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-20250514" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-20250514",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/claude-opus-4-20250514:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-opus-4-20250514" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-opus-4-20250514:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-20250514" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/claude-opus-4-20250514:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按量计费3 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-5-20251101" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-5-20251101",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-5-20251101" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-5-20251101",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-5-20251101" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-5-20251101",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-5-20251101" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-5-20251101",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/claude-opus-4-5-20251101:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-opus-4-5-20251101" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-opus-4-5-20251101:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-5-20251101" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/claude-opus-4-5-20251101:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
claude-opus-4-6
按公式计费3 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-6" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 同名上游元数据（不是哪吒保证）={"default":"medium","options":["low","medium","high"],"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-6",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-6" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-6",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-6" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-6",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-6" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-6",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/claude-opus-4-6:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-opus-4-6" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-opus-4-6:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-6" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/claude-opus-4-6:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
claude-opus-4-7
按量计费3 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-7" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 同名上游元数据（不是哪吒保证）={"default":"medium","options":["low","medium","high"],"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-7",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-7" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-7",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-7" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-7",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-7" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-7",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/claude-opus-4-7:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-opus-4-7" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-opus-4-7:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-7" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/claude-opus-4-7:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
claude-opus-4-8
按量计费3 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-8" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 同名上游元数据（不是哪吒保证）={"default":"medium","options":["low","medium","high"],"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-8",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-8" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-8",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-8" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-8",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-8" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-4-8",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/claude-opus-4-8:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-opus-4-8" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-opus-4-8:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-4-8" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/claude-opus-4-8:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
claude-opus-5
按量计费3 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-5" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 同名上游元数据（不是哪吒保证）={"default":"medium","options":["low","medium","high"],"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-5",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-5" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-5",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-5" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-5",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-5" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-5",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/claude-opus-5:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-opus-5" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-opus-5:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-5" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/claude-opus-5:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
claude-opus-5-5
按公式计费3 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：anthropic、openai、openai-response、openai-response-compact、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-5-5" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-5-5",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-5-5" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 同名上游元数据（不是哪吒保证）={"default":"medium","options":["low","medium","high"],"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-5-5",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-5-5" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-5-5",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-5-5" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-5-5",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Gemini generateContent
POST
/v1beta/models/claude-opus-5-5:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-opus-5-5" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-opus-5-5:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-5-5" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/messagesPOST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1beta/models/claude-opus-5-5:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按量计费1 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-5-thinking" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-5-thinking",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-5-thinking" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-5-thinking",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-5-thinking" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-5-thinking",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-5-thinking" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-opus-5-thinking",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/claude-opus-5-thinking:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-opus-5-thinking" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-opus-5-thinking:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-opus-5-thinking" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/claude-opus-5-thinking:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按公式计费2 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-4-5" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-4-5",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-4-5" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-4-5",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-4-5" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-4-5",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-4-5" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-4-5",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/claude-sonnet-4-5:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-sonnet-4-5" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-sonnet-4-5:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-4-5" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/claude-sonnet-4-5:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按量计费3 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-4-5-20250929" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-4-5-20250929",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-4-5-20250929" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-4-5-20250929",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-4-5-20250929" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-4-5-20250929",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-4-5-20250929" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-4-5-20250929",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/claude-sonnet-4-5-20250929:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-sonnet-4-5-20250929" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-sonnet-4-5-20250929:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-4-5-20250929" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/claude-sonnet-4-5-20250929:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按公式计费3 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-4-6" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 同名上游元数据（不是哪吒保证）={"default":"medium","options":["low","medium","high"],"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-4-6",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-4-6" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-4-6",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-4-6" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-4-6",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-4-6" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-4-6",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/claude-sonnet-4-6:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-sonnet-4-6" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-sonnet-4-6:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-4-6" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/claude-sonnet-4-6:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
claude-sonnet-5
按公式计费3 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：anthropic、openai、openai-response、openai-response-compact、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-5" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-5",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-5" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 同名上游元数据（不是哪吒保证）={"default":"medium","options":["low","medium","high"],"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-5",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-5" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-5",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-5" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-5",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Gemini generateContent
POST
/v1beta/models/claude-sonnet-5:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-sonnet-5" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-sonnet-5:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-5" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/messagesPOST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1beta/models/claude-sonnet-5:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按公式计费3 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：anthropic、openai、openai-response、openai-response-compact、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-5-5" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-5-5",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-5-5" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-5-5",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-5-5" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-5-5",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-5-5" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "claude-sonnet-5-5",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Gemini generateContent
POST
/v1beta/models/claude-sonnet-5-5:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "claude-sonnet-5-5" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/claude-sonnet-5-5:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "claude-sonnet-5-5" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
调用入口概览
POST
/v1/messagesPOST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1beta/models/claude-sonnet-5-5:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按公式计费4 个分组
请求参数、示例与计费42 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "codex-auto-review" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "codex-auto-review",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}调用入口概览
POST
/v1/chat/completions以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按公式计费1 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "deepseek-v4-flash" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "deepseek-v4-flash",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "deepseek-v4-flash" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "deepseek-v4-flash",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "deepseek-v4-flash" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "deepseek-v4-flash",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "deepseek-v4-flash" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "deepseek-v4-flash",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/deepseek-v4-flash:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "deepseek-v4-flash" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/deepseek-v4-flash:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "deepseek-v4-flash" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/deepseek-v4-flash:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
deepseek-v4-pro
按公式计费1 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "deepseek-v4-pro" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "deepseek-v4-pro",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "deepseek-v4-pro" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "deepseek-v4-pro",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "deepseek-v4-pro" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "deepseek-v4-pro",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "deepseek-v4-pro" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "deepseek-v4-pro",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/deepseek-v4-pro:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "deepseek-v4-pro" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/deepseek-v4-pro:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "deepseek-v4-pro" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/deepseek-v4-pro:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按公式计费1 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "deepseek-v4.1-flash" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "deepseek-v4.1-flash",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "deepseek-v4.1-flash" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "deepseek-v4.1-flash",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "deepseek-v4.1-flash" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "deepseek-v4.1-flash",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "deepseek-v4.1-flash" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "deepseek-v4.1-flash",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/deepseek-v4.1-flash:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "deepseek-v4.1-flash" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/deepseek-v4.1-flash:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "deepseek-v4.1-flash" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/deepseek-v4.1-flash:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按公式计费1 个分组
请求参数、示例与计费42 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "deepseek-v4.1-flash-1017" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "deepseek-v4.1-flash-1017",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completions以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
gemini-3.1-pro
按公式计费1 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gemini-3.1-pro" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 同名上游元数据（不是哪吒保证）={"default":"medium","options":["low","medium","high"],"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-3.1-pro",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gemini-3.1-pro" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-3.1-pro",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gemini-3.1-pro" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-3.1-pro",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gemini-3.1-pro" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-3.1-pro",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/gemini-3.1-pro:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "gemini-3.1-pro" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/gemini-3.1-pro:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gemini-3.1-pro" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/gemini-3.1-pro:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
gemini-3.8-flash
按公式计费1 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gemini-3.8-flash" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-3.8-flash",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gemini-3.8-flash" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-3.8-flash",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gemini-3.8-flash" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-3.8-flash",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gemini-3.8-flash" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-3.8-flash",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/gemini-3.8-flash:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "gemini-3.8-flash" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/gemini-3.8-flash:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gemini-3.8-flash" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/gemini-3.8-flash:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价¥0.056/ 次音频生成2 个分组
请求参数、示例与计费14 项参数
Gemini 语音合成本站已记录
纯文本转语音：OpenAI 兼容 WAV 或 Gemini 原生 AUDIO/PCM。
- 仅文本输入；不支持声音克隆、参考音频、对话音频输入或音乐生成。
- 兼容 speech 返回 WAV 字节；原生返回 inlineData 中 base64 PCM，二者不是同一种响应封装。
- 声线为大小写敏感的 30 个预设；默认 Kore。不要把通用 OpenAI voice/alloy、mp3/opus 或 speed 强行套入。
- 输入字符上限、单次音频时长和流式能力无本站明确证据，不填造的默认/上限。
- 本次未执行付费 TTS。
OpenAI 兼容语音（WAV）
POST
/v1/audio/speechContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gemini-3.8-flash-tts" 本站已记录 |
inputstring | 必填 | 待合成的非空文本。 未公开默认值或限制 本站已记录 |
voicestring | 可选 | 预设音色，默认 Kore。 "Zephyr" / "Puck" / "Charon" / "Kore" / "Fenrir" / "Leda" / "Orus" / "Aoede" / "Callirrhoe" / "Autonoe" / "Enceladus" / "Iapetus" / "Umbriel" / "Algieba" / "Despina" / "Erinome" / "Algenib" / "Rasalgethi" / "Laomedeia" / "Achernar" / "Alnilam" / "Schedar" / "Gacrux" / "Pulcherrima" / "Achird" / "Zubenelgenubi" / "Vindemiatrix" / "Sadachbia" / "Sadaltager" / "Sulafat"；默认 "Kore" 本站已记录 |
response_formatstring | 可选 | 兼容入口仅 WAV；不是 Suno 的 response_format。 固定 "wav" 本站已记录 |
- 响应按二进制保存 .wav，不按 Chat JSON 解析。
OpenAI 兼容语音（WAV） · cURL
curl --request POST 'https://nezhai.vip/v1/audio/speech' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gemini-3.8-flash-tts",
"input": "你好，欢迎使用哪吒 API。",
"voice": "Kore",
"response_format": "wav"
}'响应示例
{
"documented": "WAV 二进制（24 kHz/mono/16-bit），不是 JSON"
}Gemini 原生 AUDIO
POST
/v1beta/models/gemini-3.8-flash-tts:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL；body 无 model。 固定 "gemini-3.8-flash-tts" 本站已记录 |
contentsarray<object> | 必填 | 纯文本内容，禁止媒体块。 最少项数 1 本站已记录 |
contents[].rolestring | 可选 | 文本请求示例使用 user。 固定 "user" 本站已记录 |
contents[].partsarray<object> | 必填 | 只使用 text 部分。 最少项数 1 本站已记录 |
contents[].parts[].textstring | 必填 | 待合成的非空文本。 未公开默认值或限制 本站已记录 |
generationConfig.responseModalitiesarray<string> | 必填 | 原生音频模式，必须置于 generationConfig。 固定 ["AUDIO"] 本站已记录 |
generationConfig.speechConfigobject | 必填 | 预设音色配置。 未公开默认值或限制 本站已记录 |
generationConfig.speechConfig.voiceConfig.prebuiltVoiceConfig.voiceNamestring | 可选 | 预设音色，默认 Kore；不得用 voice 放到 body 顶层。 "Zephyr" / "Puck" / "Charon" / "Kore" / "Fenrir" / "Leda" / "Orus" / "Aoede" / "Callirrhoe" / "Autonoe" / "Enceladus" / "Iapetus" / "Umbriel" / "Algieba" / "Despina" / "Erinome" / "Algenib" / "Rasalgethi" / "Laomedeia" / "Achernar" / "Alnilam" / "Schedar" / "Gacrux" / "Pulcherrima" / "Achird" / "Zubenelgenubi" / "Vindemiatrix" / "Sadachbia" / "Sadaltager" / "Sulafat"；默认 "Kore" 本站已记录 |
- 从 candidates[].content.parts[].inlineData 读取 mimeType/data；有多个 PCM part 时按实际顺序处理。
- 原始 PCM 不是可直接命名为 .wav 的 WAV 文件，需封装 WAV 头；不要发 response_format 到原生端点。
- 若返回 speech_metadata 应保留，但不能视为请求参数。
Gemini 原生 AUDIO · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/gemini-3.8-flash-tts:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "你好，欢迎使用哪吒 API。"
}
]
}
],
"generationConfig": {
"responseModalities": [
"AUDIO"
],
"speechConfig": {
"voiceConfig": {
"prebuiltVoiceConfig": {
"voiceName": "Kore"
}
}
}
}
}'响应示例
{
"documented": "candidates[].content.parts[].inlineData：mimeType=audio/l16;rate=24000，data=base64 PCM；可能带 speech_metadata"
}调用入口概览
POST
/v1/audio/speechPOST
/v1beta/models/gemini-3.8-flash-tts:generateContent调用入口与语音指南一致；兼容口与原生口的请求体不同。 参阅语音合成指南。
可选分组
计费
【生图组】¥0.056 / 次
音频生成¥0.056 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价文本生成
glm-5.1
按公式计费1 个分组
请求参数、示例与计费42 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "glm-5.1" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "glm-5.1",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completions以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
glm-5.2
按量计费1 个分组
请求参数、示例与计费42 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "glm-5.2" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "glm-5.2",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completions以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
glm-5.3
按量计费2 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "glm-5.3" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "glm-5.3",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "glm-5.3" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "glm-5.3",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "glm-5.3" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "glm-5.3",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "glm-5.3" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "glm-5.3",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/glm-5.3:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "glm-5.3" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/glm-5.3:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "glm-5.3" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/glm-5.3:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
glm-5.3-flash
按量计费2 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "glm-5.3-flash" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "glm-5.3-flash",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "glm-5.3-flash" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "glm-5.3-flash",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "glm-5.3-flash" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "glm-5.3-flash",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "glm-5.3-flash" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "glm-5.3-flash",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/glm-5.3-flash:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "glm-5.3-flash" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/glm-5.3-flash:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "glm-5.3-flash" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/glm-5.3-flash:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
gpt-5.6
按量计费1 个分组
请求参数、示例与计费42 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-5.6" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-5.6",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completions以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
gpt-5.6-luna
按公式计费仅站长测试分组1 个分组
请求参数、示例与计费42 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-5.6-luna" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-5.6-luna",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completions以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
gpt-5.6-sol
按公式计费7 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-5.6-sol" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 同名上游元数据（不是哪吒保证）={"default":"medium","options":["low","medium","high","xhigh","max","ultra"],"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-5.6-sol",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-5.6-sol" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-5.6-sol",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-5.6-sol" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-5.6-sol",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-5.6-sol" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-5.6-sol",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/gpt-5.6-sol:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "gpt-5.6-sol" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/gpt-5.6-sol:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-5.6-sol" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/gpt-5.6-sol:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
gpt-5.6-terra
按量计费5 个分组
请求参数、示例与计费42 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-5.6-terra" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-5.6-terra",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completions以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
gpt-6
按量计费1 个分组
请求参数、示例与计费42 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-6" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-6",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}调用入口概览
POST
/v1/chat/completions以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
gpt-6-astra
按公式计费7 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-6-astra" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-6-astra",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-6-astra" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-6-astra",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-6-astra" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-6-astra",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-6-astra" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-6-astra",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/gpt-6-astra:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "gpt-6-astra" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/gpt-6-astra:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-6-astra" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/gpt-6-astra:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
gpt-6-luna
按公式计费2 个分组
请求参数、示例与计费42 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-6-luna" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-6-luna",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}调用入口概览
POST
/v1/chat/completions以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
gpt-6-sol
按公式计费6 个分组
请求参数、示例与计费42 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-6-sol" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 同名上游元数据（不是哪吒保证）={"default":"medium","options":["low","medium","high","xhigh","max","ultra"],"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-6-sol",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completions以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
gpt-6.1-sol
按公式计费6 个分组
请求参数、示例与计费42 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-6.1-sol" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 同名上游元数据（不是哪吒保证）={"default":"medium","options":["low","medium","high","xhigh","max","ultra"],"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-6.1-sol",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completions以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价¥0.028 / 次生图组实付
请求参数、示例与计费7 项参数
Nano Banana 2 Lite 图片生成模型，固定 1K 分辨率；支持画面比例：auto、1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、21:9、8:1、4:1、1:4、1:8；使用 size 设置画面比例；参考图建议不超过 4 张，最多支持 14 张参考图。也支持 OpenAI 协议的图生图编辑：向 /v1/images/edits 提交源图（multipart 的 image 字段，或 JSON 的 image/images 字段）与编辑指令，按同一套分辨率档计价。
JSON image/images 或 multipart image/image[] 参考图编辑；n 固定 1。Pro、2、2.1 支持 Prefer: respond-async；Lite、2.5 使用同步请求。
POST /v1/images/generations；查询 GET /v1/tasks/{id}
| 字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
model | string | 是 | 模型；固定 "gemini-3.1-flash-lite-image" |
prompt | string | 是 | 提示词；最短 1 字符 |
resolution | string | 否 | 分辨率；固定 "1k" |
size | string | 否 | 画面比例；["auto","1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","21:9","8:1","4:1","1:4","1:8"]；默认 "auto" |
image | string | 否 | 单张参考图 |
images | array | 否 | 多张参考图；最多 14 项 |
n | integer | 否 | 生成张数；固定 1 |
curl https://nezhai.vip/v1/images/generations \
-H "Authorization: Bearer $NEZHA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.1-flash-lite-image",
"prompt": "电影感产品图：柔和自然光，主体清晰，背景简洁。",
"resolution": "1k",
"size": "auto",
"n": 1
}'图片读取 data[].url / data[].b64_json；任务结果 result.data.image_urls，封面 result.data.grid_image_url。
参数更新：2026-10-27。价格来源为本站生图组配置；查询与恢复不会重新提交。
¥0.042 / 次生图组实付
请求参数、示例与计费6 项参数
香蕉 2.5 Flash 图片生成模型；支持画面比例：auto、1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9（使用 size 设置画面比例，不指定则由模型自选）；参考图最多 3 张；分辨率与质量档不受支持——请求中携带 resolution、quality 档或像素尺寸（size 传 "WxH"）时会被忽略、按模型原生尺寸出图（画面比例仍按 size 生效）；也支持 OpenAI 协议的图生图编辑：向 /v1/images/edits 提交源图（multipart 的 image 字段，或 JSON 的 image/images 字段）与编辑指令。
JSON image/images 或 multipart image/image[] 参考图编辑；n 固定 1。Pro、2、2.1 支持 Prefer: respond-async；Lite、2.5 使用同步请求。
POST /v1/images/generations；查询 GET /v1/tasks/{id}
| 字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
model | string | 是 | 模型；固定 "gemini-2.5-flash-image" |
prompt | string | 是 | 提示词；最短 1 字符 |
size | string | 否 | 画面比例；["auto","1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9","21:9"]；默认 "auto" |
image | string | 否 | 单张参考图 |
images | array | 否 | 多张参考图；最多 3 项 |
n | integer | 否 | 生成张数；固定 1 |
curl https://nezhai.vip/v1/images/generations \
-H "Authorization: Bearer $NEZHA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-2.5-flash-image",
"prompt": "电影感产品图：柔和自然光，主体清晰，背景简洁。",
"size": "auto",
"n": 1
}'图片读取 data[].url / data[].b64_json；任务结果 result.data.image_urls，封面 result.data.grid_image_url。
参数更新：2026-10-27。价格来源为本站生图组配置；查询与恢复不会重新提交。
图片生成
nano-banana-pro
¥0.084 / 次生图组实付
请求参数、示例与计费7 项参数
Nano Banana Pro，支持同步生成和 Prefer: respond-async 异步任务、1K/2K/4K 分辨率；支持画面比例：auto、1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、21:9、8:1、4:1、1:4、1:8；使用 resolution 与 size 设置画面规格；参考图建议不超过 4 张，最多支持 14 张参考图。也支持 OpenAI 协议的图生图编辑：向 /v1/images/edits 提交源图（multipart 的 image 字段，或 JSON 的 image/images 字段）与编辑指令，按同一套分辨率档计价。
JSON image/images 或 multipart image/image[] 参考图编辑；n 固定 1。Pro、2、2.1 支持 Prefer: respond-async；Lite、2.5 使用同步请求。
POST /v1/images/generations；查询 GET /v1/tasks/{id}
| 字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
model | string | 是 | 模型；固定 "nano-banana-pro" |
prompt | string | 是 | 提示词；最短 1 字符 |
resolution | string | 否 | 分辨率；["1k","2k","4k"]；默认 "1k" |
size | string | 否 | 画面比例；["auto","1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","21:9","8:1","4:1","1:4","1:8"]；默认 "auto" |
image | string | 否 | 单张参考图 |
images | array | 否 | 多张参考图；最多 14 项 |
n | integer | 否 | 生成张数；固定 1 |
curl https://nezhai.vip/v1/images/generations \
-H "Authorization: Bearer $NEZHA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-pro",
"prompt": "电影感产品图：柔和自然光，主体清晰，背景简洁。",
"resolution": "1k",
"size": "auto",
"n": 1
}'图片读取 data[].url / data[].b64_json；任务结果 result.data.image_urls，封面 result.data.grid_image_url。
参数更新：2026-10-27。价格来源为本站生图组配置；查询与恢复不会重新提交。
图片生成
nano-banana-2
¥0.07 / 次生图组实付
请求参数、示例与计费7 项参数
Nano Banana 2，支持同步生成和 Prefer: respond-async 异步任务、0.5K/1K/2K/4K 分辨率（0.5K 即官方 512 档，用 resolution 传 "512"；传 0.5K 同样受理）；支持画面比例：auto、1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、21:9、8:1、4:1、1:4、1:8；使用 resolution 与 size 设置画面规格；参考图建议不超过 4 张，最多支持 14 张参考图。也支持 OpenAI 协议的图生图编辑：向 /v1/images/edits 提交源图（multipart 的 image 字段，或 JSON 的 image/images 字段）与编辑指令，按同一套分辨率档计价。
JSON image/images 或 multipart image/image[] 参考图编辑；n 固定 1。Pro、2、2.1 支持 Prefer: respond-async；Lite、2.5 使用同步请求。
POST /v1/images/generations；查询 GET /v1/tasks/{id}
| 字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
model | string | 是 | 模型；固定 "nano-banana-2" |
prompt | string | 是 | 提示词；最短 1 字符 |
resolution | string | 否 | 分辨率；["1k","2k","4k","512"]；默认 "1k" |
size | string | 否 | 画面比例；["auto","1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","21:9","8:1","4:1","1:4","1:8"]；默认 "auto" |
image | string | 否 | 单张参考图 |
images | array | 否 | 多张参考图；最多 14 项 |
n | integer | 否 | 生成张数；固定 1 |
curl https://nezhai.vip/v1/images/generations \
-H "Authorization: Bearer $NEZHA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-2",
"prompt": "电影感产品图：柔和自然光，主体清晰，背景简洁。",
"resolution": "1k",
"size": "auto",
"n": 1
}'图片读取 data[].url / data[].b64_json；任务结果 result.data.image_urls，封面 result.data.grid_image_url。
参数更新：2026-10-27。价格来源为本站生图组配置；查询与恢复不会重新提交。
图片生成
nano-banana-2.1
¥0.07 / 次生图组实付
请求参数、示例与计费8 项参数
Nano Banana 2.1，支持同步生成和 Prefer: respond-async 异步任务、1K/2K/4K 全分辨率；支持画面比例：auto、1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、21:9、8:1、4:1、1:4、1:8；使用 resolution 与 size 设置画面规格；思考强度可选 minimal、medium、high（默认 minimal，不传即按 minimal 出图；档位越高细节越多、耗时越长），按模型原生参数 generationConfig.thinkingConfig.thinkingLevel 传入，也可直接用 thinking_level；参考图建议不超过 4 张，最多支持 14 张参考图。也支持 OpenAI 协议的图生图编辑：向 /v1/images/edits 提交源图（multipart 的 image 字段，或 JSON 的 image/images 字段）与编辑指令，按同一套分辨率档计价。
JSON image/images 或 multipart image/image[] 参考图编辑；n 固定 1。Pro、2、2.1 支持 Prefer: respond-async；Lite、2.5 使用同步请求。
POST /v1/images/generations；查询 GET /v1/tasks/{id}
| 字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
model | string | 是 | 模型；固定 "nano-banana-2.1" |
prompt | string | 是 | 提示词；最短 1 字符 |
resolution | string | 否 | 分辨率；["1k","2k","4k"]；默认 "1k" |
size | string | 否 | 画面比例；["auto","1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","21:9","8:1","4:1","1:4","1:8"]；默认 "auto" |
thinking_level | string | 否 | 思考强度；["minimal","medium","high"]；默认 "minimal" |
image | string | 否 | 单张参考图 |
images | array | 否 | 多张参考图；最多 14 项 |
n | integer | 否 | 生成张数；固定 1 |
curl https://nezhai.vip/v1/images/generations \
-H "Authorization: Bearer $NEZHA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-2.1",
"prompt": "电影感产品图：柔和自然光，主体清晰，背景简洁。",
"resolution": "1k",
"size": "auto",
"n": 1
}'图片读取 data[].url / data[].b64_json；任务结果 result.data.image_urls，封面 result.data.grid_image_url。
参数更新：2026-10-27。价格来源为本站生图组配置；查询与恢复不会重新提交。
图片生成
mj-v8.1
¥0.7 / 次生图组实付 · 标准四图一组
请求参数、示例与计费29 项参数
稳定 Midjourney：支持四图生成及该型号公布的后续动作，动作单独按次计费。
原生入口返回 202；使用本站 task_id 查询。标准生成返回四张单图，grid_image_url 为可选封面，分别处理。后续动作按次计费；需要父任务的动作必须使用本用户本站任务 ID。blend（2–4 图）、edits、describe 无需父任务；describe 可只返回文本。
POST /v1/midjourney/generations；查询 GET /v1/tasks/{id}
| 字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
model | string | 是 | 模型；固定 "mj-v8.1" |
prompt | string | 是 | 提示词；最短 1 字符 |
size | string | 否 | 画面比例；["auto","1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","21:9","9:21"]；默认 "9:16" |
image | string | 否 | 单张参考图 |
images | array | 否 | 多张参考图；最多 5 项 |
raw | boolean | 否 | Raw 原始风格；默认 false |
negative_prompt | string | 否 | 负向提示词 |
seed | integer | 否 | 随机种子 |
stylize | integer | 否 | 风格化强度；默认 100；最小 0；最大 1000 |
chaos | integer | 否 | 混乱度；默认 0；最小 0；最大 100 |
weird | integer | 否 | 怪异度；默认 0；最小 0；最大 3000 |
tile | boolean | 否 | 平铺 |
iw | number | 否 | 参考图权重；最小 0；最大 3 |
cref | string | 否 | 角色参考图 URL |
sref | string | 否 | 风格参考图 URL |
dref | string | 否 | 深度参考图 URL |
cw | integer | 否 | 角色权重；最小 0；最大 100 |
sw | integer | 否 | 风格权重；最小 0；最大 1000 |
dw | number | 否 | 深度权重；最小 0；最大 100 |
quality | string | 否 | 画质；["0.25","0.5","1","2"]；默认 "1" |
hd | boolean | 否 | HD 高清；默认 false |
n | integer | 否 | 提交次数；固定 1 |
action | string | 否 | 后续动作；["upscale","variation","high_variation","low_variation","remix_strong","remix_subtle","reroll","zoom","pan","blend","edits","describe"] |
task_id | string | 否 | 父任务 ID |
index | integer | 否 | 四宫格第几张；最小 1；最大 4；取值待上游确认 |
custom_id | string | 否 | 按钮 ID；取值待上游确认 |
direction | string | 否 | 平移方向；["left","right","up","down"]；取值待上游确认 |
zoom_ratio | number | 否 | 扩图倍数；取值待上游确认 |
dimensions | string | 否 | 融图画幅；["SQUARE","PORTRAIT","LANDSCAPE"]；取值待上游确认 |
curl https://nezhai.vip/v1/midjourney/generations \
-H "Authorization: Bearer $NEZHA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "mj-v8.1",
"prompt": "保留参考图主体外形，改为电影感城市夜景，雨后街道倒映霓虹灯光。",
"size": "16:9",
"raw": false,
"image": "https://storage.googleapis.com/generativeai-downloads/images/scones.jpg",
"n": 1
}'图片读取 data[].url / data[].b64_json；任务结果 result.data.image_urls，封面 result.data.grid_image_url。
参数更新：2026-10-27。价格来源为本站生图组配置；查询与恢复不会重新提交。
图片生成
mj-v8.2
¥0.7 / 次生图组实付 · 标准四图一组
请求参数、示例与计费29 项参数
稳定 Midjourney：支持四图生成及该型号公布的后续动作，动作单独按次计费。
原生入口返回 202；使用本站 task_id 查询。标准生成返回四张单图，grid_image_url 为可选封面，分别处理。后续动作按次计费；需要父任务的动作必须使用本用户本站任务 ID。blend（2–4 图）、edits、describe 无需父任务；describe 可只返回文本。
POST /v1/midjourney/generations；查询 GET /v1/tasks/{id}
| 字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
model | string | 是 | 模型；固定 "mj-v8.2" |
prompt | string | 是 | 提示词；最短 1 字符；最长 1023 字符 |
size | string | 否 | 画面比例；["auto","1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","21:9","9:21"]；默认 "9:16" |
image | string | 否 | 单张参考图 |
images | array | 否 | 多张参考图；最多 5 项 |
raw | boolean | 否 | Raw 原始风格；默认 false |
negative_prompt | string | 否 | 负向提示词 |
seed | integer | 否 | 随机种子 |
stylize | integer | 否 | 风格化强度；默认 100；最小 0；最大 1000 |
chaos | integer | 否 | 混乱度；默认 0；最小 0；最大 100 |
weird | integer | 否 | 怪异度；默认 0；最小 0；最大 3000 |
tile | boolean | 否 | 平铺 |
iw | number | 否 | 参考图权重；最小 0；最大 3 |
cref | string | 否 | 角色参考图 URL |
sref | string | 否 | 风格参考图 URL |
dref | string | 否 | 深度参考图 URL |
cw | integer | 否 | 角色权重；最小 0；最大 100 |
sw | integer | 否 | 风格权重；最小 0；最大 1000 |
dw | number | 否 | 深度权重；最小 0；最大 100 |
quality | string | 否 | 画质；["0.25","0.5","1","2"]；默认 "1" |
hd | boolean | 否 | HD 高清；默认 false |
n | integer | 否 | 提交次数；固定 1 |
action | string | 否 | 后续动作；["upscale","variation","high_variation","low_variation","remix_strong","remix_subtle","reroll","zoom","pan","blend","edits","describe"] |
task_id | string | 否 | 父任务 ID |
index | integer | 否 | 四宫格第几张；最小 1；最大 4；取值待上游确认 |
custom_id | string | 否 | 按钮 ID；取值待上游确认 |
direction | string | 否 | 平移方向；["left","right","up","down"]；取值待上游确认 |
zoom_ratio | number | 否 | 扩图倍数；取值待上游确认 |
dimensions | string | 否 | 融图画幅；["SQUARE","PORTRAIT","LANDSCAPE"]；取值待上游确认 |
curl https://nezhai.vip/v1/midjourney/generations \
-H "Authorization: Bearer $NEZHA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "mj-v8.2",
"prompt": "保留参考图主体外形，改为电影感城市夜景，雨后街道倒映霓虹灯光。",
"size": "16:9",
"raw": false,
"image": "https://storage.googleapis.com/generativeai-downloads/images/scones.jpg",
"n": 1
}'图片读取 data[].url / data[].b64_json；任务结果 result.data.image_urls，封面 result.data.grid_image_url。
参数更新：2026-10-27。价格来源为本站生图组配置；查询与恢复不会重新提交。
图片生成
mj-niji7
¥0.7 / 次生图组实付 · 标准四图一组
请求参数、示例与计费28 项参数
稳定 Midjourney：支持四图生成及该型号公布的后续动作，动作单独按次计费。
原生入口返回 202；使用本站 task_id 查询。标准生成返回四张单图，grid_image_url 为可选封面，分别处理。后续动作按次计费；需要父任务的动作必须使用本用户本站任务 ID。blend（2–4 图）、edits、describe 无需父任务；describe 可只返回文本。
POST /v1/midjourney/generations；查询 GET /v1/tasks/{id}
| 字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
model | string | 是 | 模型；固定 "mj-niji7" |
prompt | string | 是 | 提示词；最短 1 字符 |
size | string | 否 | 画面比例；["auto","1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","21:9","9:21"]；默认 "9:16" |
image | string | 否 | 单张参考图 |
images | array | 否 | 多张参考图；最多 5 项 |
raw | boolean | 否 | Raw 原始风格；默认 false |
negative_prompt | string | 否 | 负向提示词 |
seed | integer | 否 | 随机种子 |
stylize | integer | 否 | 风格化强度；默认 100；最小 0；最大 1000 |
chaos | integer | 否 | 混乱度；默认 0；最小 0；最大 100 |
weird | integer | 否 | 怪异度；默认 0；最小 0；最大 3000 |
tile | boolean | 否 | 平铺 |
iw | number | 否 | 参考图权重；最小 0；最大 3 |
cref | string | 否 | 角色参考图 URL |
sref | string | 否 | 风格参考图 URL |
dref | string | 否 | 深度参考图 URL |
cw | integer | 否 | 角色权重；最小 0；最大 100 |
sw | integer | 否 | 风格权重；最小 0；最大 1000 |
dw | number | 否 | 深度权重；最小 0；最大 100 |
quality | string | 否 | 画质；["0.25","0.5","1","2"]；默认 "1" |
n | integer | 否 | 提交次数；固定 1 |
action | string | 否 | 后续动作；["upscale","variation","high_variation","low_variation","reroll","zoom","pan","blend","edits","describe"] |
task_id | string | 否 | 父任务 ID |
index | integer | 否 | 四宫格第几张；最小 1；最大 4；取值待上游确认 |
custom_id | string | 否 | 按钮 ID；取值待上游确认 |
direction | string | 否 | 平移方向；["left","right","up","down"]；取值待上游确认 |
zoom_ratio | number | 否 | 扩图倍数；取值待上游确认 |
dimensions | string | 否 | 融图画幅；["SQUARE","PORTRAIT","LANDSCAPE"]；取值待上游确认 |
curl https://nezhai.vip/v1/midjourney/generations \
-H "Authorization: Bearer $NEZHA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "mj-niji7",
"prompt": "保留参考图主体外形，改为电影感城市夜景，雨后街道倒映霓虹灯光。",
"size": "16:9",
"raw": false,
"image": "https://storage.googleapis.com/generativeai-downloads/images/scones.jpg",
"n": 1
}'图片读取 data[].url / data[].b64_json；任务结果 result.data.image_urls，封面 result.data.grid_image_url。
参数更新：2026-10-27。价格来源为本站生图组配置；查询与恢复不会重新提交。
图片生成
mj-v6.1
¥0.7 / 次生图组实付 · 标准四图一组
请求参数、示例与计费28 项参数
稳定 Midjourney：支持四图生成及该型号公布的后续动作，动作单独按次计费。
原生入口返回 202；使用本站 task_id 查询。标准生成返回四张单图，grid_image_url 为可选封面，分别处理。后续动作按次计费；需要父任务的动作必须使用本用户本站任务 ID。blend（2–4 图）、edits、describe 无需父任务；describe 可只返回文本。
POST /v1/midjourney/generations；查询 GET /v1/tasks/{id}
| 字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
model | string | 是 | 模型；固定 "mj-v6.1" |
prompt | string | 是 | 提示词；最短 1 字符 |
size | string | 否 | 画面比例；["auto","1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","21:9","9:21"]；默认 "9:16" |
image | string | 否 | 单张参考图 |
images | array | 否 | 多张参考图；最多 5 项 |
raw | boolean | 否 | Raw 原始风格；默认 false |
negative_prompt | string | 否 | 负向提示词 |
seed | integer | 否 | 随机种子 |
stylize | integer | 否 | 风格化强度；默认 100；最小 0；最大 1000 |
chaos | integer | 否 | 混乱度；默认 0；最小 0；最大 100 |
weird | integer | 否 | 怪异度；默认 0；最小 0；最大 3000 |
tile | boolean | 否 | 平铺 |
iw | number | 否 | 参考图权重；最小 0；最大 3 |
cref | string | 否 | 角色参考图 URL |
sref | string | 否 | 风格参考图 URL |
dref | string | 否 | 深度参考图 URL |
cw | integer | 否 | 角色权重；最小 0；最大 100 |
sw | integer | 否 | 风格权重；最小 0；最大 1000 |
dw | number | 否 | 深度权重；最小 0；最大 100 |
quality | string | 否 | 画质；["0.25","0.5","1","2"]；默认 "1" |
n | integer | 否 | 提交次数；固定 1 |
action | string | 否 | 后续动作；["upscale","variation","high_variation","low_variation","reroll","zoom","pan","blend","edits","describe"] |
task_id | string | 否 | 父任务 ID |
index | integer | 否 | 四宫格第几张；最小 1；最大 4；取值待上游确认 |
custom_id | string | 否 | 按钮 ID；取值待上游确认 |
direction | string | 否 | 平移方向；["left","right","up","down"]；取值待上游确认 |
zoom_ratio | number | 否 | 扩图倍数；取值待上游确认 |
dimensions | string | 否 | 融图画幅；["SQUARE","PORTRAIT","LANDSCAPE"]；取值待上游确认 |
curl https://nezhai.vip/v1/midjourney/generations \
-H "Authorization: Bearer $NEZHA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "mj-v6.1",
"prompt": "保留参考图主体外形，改为电影感城市夜景，雨后街道倒映霓虹灯光。",
"size": "16:9",
"raw": false,
"image": "https://storage.googleapis.com/generativeai-downloads/images/scones.jpg",
"n": 1
}'图片读取 data[].url / data[].b64_json；任务结果 result.data.image_urls，封面 result.data.grid_image_url。
参数更新：2026-10-27。价格来源为本站生图组配置；查询与恢复不会重新提交。
图片生成
mj-v7
¥0.7 / 次生图组实付 · 标准四图一组
请求参数、示例与计费28 项参数
稳定 Midjourney：支持四图生成及该型号公布的后续动作，动作单独按次计费。
原生入口返回 202；使用本站 task_id 查询。标准生成返回四张单图，grid_image_url 为可选封面，分别处理。后续动作按次计费；需要父任务的动作必须使用本用户本站任务 ID。blend（2–4 图）、edits、describe 无需父任务；describe 可只返回文本。
POST /v1/midjourney/generations；查询 GET /v1/tasks/{id}
| 字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
model | string | 是 | 模型；固定 "mj-v7" |
prompt | string | 是 | 提示词；最短 1 字符 |
size | string | 否 | 画面比例；["auto","1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","21:9","9:21"]；默认 "9:16" |
image | string | 否 | 单张参考图 |
images | array | 否 | 多张参考图；最多 5 项 |
raw | boolean | 否 | Raw 原始风格；默认 false |
negative_prompt | string | 否 | 负向提示词 |
seed | integer | 否 | 随机种子 |
stylize | integer | 否 | 风格化强度；默认 100；最小 0；最大 1000 |
chaos | integer | 否 | 混乱度；默认 0；最小 0；最大 100 |
weird | integer | 否 | 怪异度；默认 0；最小 0；最大 3000 |
tile | boolean | 否 | 平铺 |
iw | number | 否 | 参考图权重；最小 0；最大 3 |
cref | string | 否 | 角色参考图 URL |
sref | string | 否 | 风格参考图 URL |
dref | string | 否 | 深度参考图 URL |
cw | integer | 否 | 角色权重；最小 0；最大 100 |
sw | integer | 否 | 风格权重；最小 0；最大 1000 |
dw | number | 否 | 深度权重；最小 0；最大 100 |
quality | string | 否 | 画质；["0.25","0.5","1","2"]；默认 "1" |
n | integer | 否 | 提交次数；固定 1 |
action | string | 否 | 后续动作；["upscale","variation","high_variation","low_variation","reroll","zoom","pan","blend","edits","describe"] |
task_id | string | 否 | 父任务 ID |
index | integer | 否 | 四宫格第几张；最小 1；最大 4；取值待上游确认 |
custom_id | string | 否 | 按钮 ID；取值待上游确认 |
direction | string | 否 | 平移方向；["left","right","up","down"]；取值待上游确认 |
zoom_ratio | number | 否 | 扩图倍数；取值待上游确认 |
dimensions | string | 否 | 融图画幅；["SQUARE","PORTRAIT","LANDSCAPE"]；取值待上游确认 |
curl https://nezhai.vip/v1/midjourney/generations \
-H "Authorization: Bearer $NEZHA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "mj-v7",
"prompt": "保留参考图主体外形，改为电影感城市夜景，雨后街道倒映霓虹灯光。",
"size": "16:9",
"raw": false,
"image": "https://storage.googleapis.com/generativeai-downloads/images/scones.jpg",
"n": 1
}'图片读取 data[].url / data[].b64_json；任务结果 result.data.image_urls，封面 result.data.grid_image_url。
参数更新：2026-10-27。价格来源为本站生图组配置；查询与恢复不会重新提交。
图片生成
Midjourney v6-特惠
¥0.21 / 次生图组实付 · 标准四图一组
请求参数、示例与计费7 项参数
Midjourney 特惠：一次提交生成四张单图；请使用此精确模型 ID。
n 固定 1，一次生成四张，按一组计费；最多一张参考图。v8.2/v8.1 高清使用 hd=true。
POST /v1/images/generations；查询 GET /v1/tasks/{id}
| 字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
model | string | 是 | 模型；固定 "Midjourney v6-特惠" |
prompt | string | 是 | 提示词；最短 1 字符 |
size | string | 否 | 画面比例；["1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","21:9"]；默认 "16:9" |
quality | string | 否 | 生成质量；["0.25","0.5","1","2"]；默认 "1" |
image | string | 否 | 单张参考图 |
images | array | 否 | 多张参考图；最多 1 项 |
n | integer | 否 | 提交次数；固定 1 |
curl https://nezhai.vip/v1/images/generations \
-H "Authorization: Bearer $NEZHA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Midjourney v6-特惠",
"prompt": "一枚放在白色桌面上的红苹果，棚拍产品照，柔光，无文字。",
"size": "16:9"
}'图片读取 data[].url / data[].b64_json；任务结果 result.data.image_urls，封面 result.data.grid_image_url。
参数更新：2026-10-27。价格来源为本站生图组配置；查询与恢复不会重新提交。
图片生成
Midjourney v7-特惠
¥0.21 / 次生图组实付 · 标准四图一组
请求参数、示例与计费6 项参数
Midjourney 特惠：一次提交生成四张单图；请使用此精确模型 ID。
n 固定 1，一次生成四张，按一组计费；最多一张参考图。v8.2/v8.1 高清使用 hd=true。
POST /v1/images/generations；查询 GET /v1/tasks/{id}
| 字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
model | string | 是 | 模型；固定 "Midjourney v7-特惠" |
prompt | string | 是 | 提示词；最短 1 字符 |
size | string | 否 | 画面比例；["auto","1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","21:9","9:21"]；默认 "16:9" |
image | string | 否 | 单张参考图 |
images | array | 否 | 多张参考图；最多 1 项 |
n | integer | 否 | 提交次数；固定 1 |
curl https://nezhai.vip/v1/images/generations \
-H "Authorization: Bearer $NEZHA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Midjourney v7-特惠",
"prompt": "一枚放在白色桌面上的红苹果，棚拍产品照，柔光，无文字。",
"size": "16:9"
}'图片读取 data[].url / data[].b64_json；任务结果 result.data.image_urls，封面 result.data.grid_image_url。
参数更新：2026-10-27。价格来源为本站生图组配置；查询与恢复不会重新提交。
¥0.21 / 次生图组实付 · 标准四图一组
请求参数、示例与计费8 项参数
Midjourney 特惠：一次提交生成四张单图；请使用此精确模型 ID。
n 固定 1，一次生成四张，按一组计费；最多一张参考图。v8.2/v8.1 高清使用 hd=true。
POST /v1/images/generations；查询 GET /v1/tasks/{id}
| 字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
model | string | 是 | 模型；固定 "Midjourney v8.2-特惠" |
prompt | string | 是 | 提示词；最短 1 字符 |
size | string | 否 | 画面比例；["1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","21:9"]；默认 "16:9" |
quality | string | 否 | 生成质量；["0.25","0.5","1","2"]；默认 "1" |
hd | boolean | 否 | HD 高清；默认 false |
image | string | 否 | 单张参考图 |
images | array | 否 | 多张参考图；最多 1 项 |
n | integer | 否 | 提交次数；固定 1 |
curl https://nezhai.vip/v1/images/generations \
-H "Authorization: Bearer $NEZHA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Midjourney v8.2-特惠",
"prompt": "一枚放在白色桌面上的红苹果，棚拍产品照，柔光，无文字。",
"size": "16:9"
}'图片读取 data[].url / data[].b64_json；任务结果 result.data.image_urls，封面 result.data.grid_image_url。
参数更新：2026-10-27。价格来源为本站生图组配置；查询与恢复不会重新提交。
¥0.21 / 次生图组实付 · 标准四图一组
请求参数、示例与计费7 项参数
Midjourney 特惠：一次提交生成四张单图；请使用此精确模型 ID。
n 固定 1，一次生成四张，按一组计费；最多一张参考图。v8.2/v8.1 高清使用 hd=true。
POST /v1/images/generations；查询 GET /v1/tasks/{id}
| 字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
model | string | 是 | 模型；固定 "Midjourney v6.1-特惠" |
prompt | string | 是 | 提示词；最短 1 字符 |
size | string | 否 | 画面比例；["1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","21:9"]；默认 "16:9" |
quality | string | 否 | 生成质量；["0.25","0.5","1","2"]；默认 "1" |
image | string | 否 | 单张参考图 |
images | array | 否 | 多张参考图；最多 1 项 |
n | integer | 否 | 提交次数；固定 1 |
curl https://nezhai.vip/v1/images/generations \
-H "Authorization: Bearer $NEZHA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Midjourney v6.1-特惠",
"prompt": "一枚放在白色桌面上的红苹果，棚拍产品照，柔光，无文字。",
"size": "16:9"
}'图片读取 data[].url / data[].b64_json；任务结果 result.data.image_urls，封面 result.data.grid_image_url。
参数更新：2026-10-27。价格来源为本站生图组配置；查询与恢复不会重新提交。
¥0.21 / 次生图组实付 · 标准四图一组
请求参数、示例与计费8 项参数
Midjourney 特惠：一次提交生成四张单图；请使用此精确模型 ID。
n 固定 1，一次生成四张，按一组计费；最多一张参考图。v8.2/v8.1 高清使用 hd=true。
POST /v1/images/generations；查询 GET /v1/tasks/{id}
| 字段 | 类型 | 必填 | 约束 |
|---|---|---|---|
model | string | 是 | 模型；固定 "Midjourney v8.1-特惠" |
prompt | string | 是 | 提示词；最短 1 字符 |
size | string | 否 | 画面比例；["1:1","3:2","2:3","4:3","3:4","5:4","4:5","16:9","9:16","21:9"]；默认 "16:9" |
quality | string | 否 | 生成质量；["0.25","0.5","1","2"]；默认 "1" |
hd | boolean | 否 | HD 高清；默认 false |
image | string | 否 | 单张参考图 |
images | array | 否 | 多张参考图；最多 1 项 |
n | integer | 否 | 提交次数；固定 1 |
curl https://nezhai.vip/v1/images/generations \
-H "Authorization: Bearer $NEZHA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Midjourney v8.1-特惠",
"prompt": "一枚放在白色桌面上的红苹果，棚拍产品照，柔光，无文字。",
"size": "16:9"
}'图片读取 data[].url / data[].b64_json；任务结果 result.data.image_urls，封面 result.data.grid_image_url。
参数更新：2026-10-27。价格来源为本站生图组配置；查询与恢复不会重新提交。
图片生成
gpt-image-1.5
按量计费仅站长测试分组1 个分组
请求参数、示例与计费3 项参数
GPT Image · 待确认取值待确认
目录可见，但该精确 ID 的哪吒路由与参数尚未确证。
- 不要把此 ID 归入本站像素协议九型号，也不要把第三方相近/带 official 后缀的模型自动当作同一个。
- 目录声明 image-generation/openai 不是编辑、视觉聊天、尺寸档位或参考图数量的证明。
- quality/size/n 默认、像素或画幅比语义、参考图编码、响应格式与编辑路径全部待补；未生成可复制调用示例。
图片入口声明（完整契约待补）
POST
/v1/images/generationsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-image-1.5" 本站已记录 |
promptstring | 可选 | 通用图片协议中的文字提示；本站此精确 ID 的必填性与长度上限尚未确证。 未公开默认值或限制 取值待确认 |
- 路径仅来自目录 image-generation 声明，不代表当前模型请求已验收；不附猜测的成功示例。
参数依据：哪吒目录：精确 ID 与 image-generation 声明 2026-10-24
调用入口概览
POST
/v1/images/generations文生图入口见图片指南。编辑能力、请求格式和尺寸字段因型号而异，不能一律发送 multipart。 参阅图片生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价图片生成
gpt-image-2
¥0.07182/ 次【生图组】2 个分组
请求参数、示例与计费17 项参数
GPT Image 像素协议本站已记录
本站像素生图与 multipart 参考图编辑；保留精确型号。
- 哪吒此精确 ID 走 OpenAI 像素协议：JSON /images/generations，参考图 multipart /images/edits。
- 不要套第三方同名模型 JSON resolution/size(画幅比)/image(s) 请求；不发送 aspect_ratio 或 resolution。2K/4K 必须切精确模型名。
- 不显式发送 response_format；本协议常返回 data[].b64_json。不要从其他图片适配器复制 response_format。
- 尺寸映射：1:1→1024x1024；16:9→1280x720；9:16→720x1280；2:3→1024x1536；3:2→1536x1024；4:3→1024x768；3:4→768x1024；21:9→1792x768；9:21→768x1792；5:4→1280x1024；4:5→1024x1280。4K 方图是 2880x2880，不是 4096x4096。
- 2026-10-24 本站入口记录：非法/档位不匹配 size 改到当前档方图，表内同比例跨档可升到当前档像素。该行为不应作为所有上游/所有路由统一保证。
- 保留完整 ID；不把 gpt-image-2-em、adobe、sunburst 自动改成基础型号；内部实现不改变对外 ID。
- 没有发起本次生成测试；输出像素不可仅按请求字段保证。
像素文生图
POST
/v1/images/generationsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-image-2" 本站已记录 |
promptstring | 必填 | 生成/编辑文字指令。上游文档给 32000 字符上限，但本站精确型号的同等上限尚未独立验证。 未公开默认值或限制 本站已记录 |
sizestring | 可选 | 像素字符串，不是画幅比；本型号使用 1K 档。应显式使用对应像素；auto/省略时的实际画幅不作精确输出保证。 "auto" / "1024x1024" / "1280x720" / "720x1280" / "1024x1536" / "1536x1024" / "1024x768" / "768x1024" / "1792x768" / "768x1792" / "1280x1024" / "1024x1280" 本站已记录 |
qualitystring | 可选 | 本站像素协议支持四值；不发送其他协议的 xhigh/max。默认值未独立确认，示例显式 auto。 "auto" / "low" / "medium" / "high" 本站已记录 |
ninteger | 可选 | 当前本站入口固定单张；不能由其他平台或前端 count 推定多图支持。 固定 1 本站已记录 |
moderationstring | 可选 | 上游文档允许 low；本站此精确型号的接收与实效未独立验证，默认省略。 "low" 上游公开契约 |
backgroundstring | 可选 | 背景选项/透明输出在本站此型号的枚举与实效未确证，默认省略。 未公开默认值或限制 取值待确认 |
- Content-Type: application/json；示例 size 为本型号方图客户端选择，不是全站统一默认。
像素文生图 · cURL
curl --request POST 'https://nezhai.vip/v1/images/generations' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2",
"prompt": "一只坐在窗边的橘猫，柔和自然光。",
"size": "1024x1024",
"quality": "auto",
"n": 1
}'响应示例
{
"documented": "data[]，优先按实际 b64_json / url 返回项处理"
}参考图编辑（multipart）
POST
/v1/images/editsContent-Type: multipart/form-data
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-image-2" 本站已记录 |
promptstring | 必填 | 生成/编辑文字指令。上游文档给 32000 字符上限，但本站精确型号的同等上限尚未独立验证。 未公开默认值或限制 本站已记录 |
sizestring | 可选 | 像素字符串，不是画幅比；本型号使用 1K 档。应显式使用对应像素；auto/省略时的实际画幅不作精确输出保证。 "auto" / "1024x1024" / "1280x720" / "720x1280" / "1024x1536" / "1536x1024" / "1024x768" / "768x1024" / "1792x768" / "768x1792" / "1280x1024" / "1024x1280" 本站已记录 |
qualitystring | 可选 | 本站像素协议支持四值；不发送其他协议的 xhigh/max。默认值未独立确认，示例显式 auto。 "auto" / "low" / "medium" / "high" 本站已记录 |
ninteger | 可选 | 当前本站入口固定单张；不能由其他平台或前端 count 推定多图支持。 固定 1 本站已记录 |
moderationstring | 可选 | 上游文档允许 low；本站此精确型号的接收与实效未独立验证，默认省略。 "low" 上游公开契约 |
backgroundstring | 可选 | 背景选项/透明输出在本站此型号的枚举与实效未确证，默认省略。 未公开默认值或限制 取值待确认 |
imagearray<file> | 必填 | 重复名 image 的文件字段（不是 JSON images 或单个文件路径字符串）；PNG/JPEG/WEBP，最多 7 张。 最少项数 1；最多项数 7 本站已记录 |
- 由 HTTP 客户端自动生成 multipart boundary；多个参考图重复追加 image 字段。
- @reference.png 是 cURL 本地文件占位，不是服务器可直接读取的请求字符串。
- 提示长度/单文件字节上限、mask/input_fidelity 等无哪吒逐型号确证，不编造。
参考图编辑（multipart） · cURL
curl --request POST 'https://nezhai.vip/v1/images/edits' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--form 'model=gpt-image-2' \
--form 'prompt=保留参考图主体，把背景改为浅蓝色。' \
--form 'size=1024x1024' \
--form 'quality=auto' \
--form 'n=1' \
--form 'image=@reference.png'响应示例
{
"documented": "按 data[] 实际返回处理；不保证请求像素严格等于输出像素"
}调用入口概览
POST
/v1/images/generationsPOST
/v1/images/edits文生图入口见图片指南。编辑能力、请求格式和尺寸字段因型号而异，不能一律发送 multipart。 参阅图片生成指南。
可选分组
计费
【生图组】¥0.07182 / 次
站长测试¥0.03192 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价图片生成
gpt-image-2-2k
¥0.04788/ 次【生图组】1 个分组
请求参数、示例与计费17 项参数
GPT Image 像素协议本站已记录
本站像素生图与 multipart 参考图编辑；保留精确型号。
- 哪吒此精确 ID 走 OpenAI 像素协议：JSON /images/generations，参考图 multipart /images/edits。
- 不要套第三方同名模型 JSON resolution/size(画幅比)/image(s) 请求；不发送 aspect_ratio 或 resolution。2K/4K 必须切精确模型名。
- 不显式发送 response_format；本协议常返回 data[].b64_json。不要从其他图片适配器复制 response_format。
- 尺寸映射：1:1→2048x2048；16:9→2048x1152；9:16→1152x2048；2:3→1536x2304；3:2→2304x1536；4:3→2048x1536；3:4→1536x2048；21:9→2688x1152；9:21→1152x2688。4K 方图是 2880x2880，不是 4096x4096。
- 2026-10-24 本站入口记录：非法/档位不匹配 size 改到当前档方图，表内同比例跨档可升到当前档像素。该行为不应作为所有上游/所有路由统一保证。
- 保留完整 ID；不把 gpt-image-2-em、adobe、sunburst 自动改成基础型号；内部实现不改变对外 ID。
- 没有发起本次生成测试；输出像素不可仅按请求字段保证。
像素文生图
POST
/v1/images/generationsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-image-2-2k" 本站已记录 |
promptstring | 必填 | 生成/编辑文字指令。上游文档给 32000 字符上限，但本站精确型号的同等上限尚未独立验证。 未公开默认值或限制 本站已记录 |
sizestring | 可选 | 像素字符串，不是画幅比；本型号使用 2K 档。应显式使用对应像素；auto/省略时的实际画幅不作精确输出保证。 "auto" / "2048x2048" / "2048x1152" / "1152x2048" / "1536x2304" / "2304x1536" / "2048x1536" / "1536x2048" / "2688x1152" / "1152x2688" 本站已记录 |
qualitystring | 可选 | 本站像素协议支持四值；不发送其他协议的 xhigh/max。默认值未独立确认，示例显式 auto。 "auto" / "low" / "medium" / "high" 本站已记录 |
ninteger | 可选 | 当前本站入口固定单张；不能由其他平台或前端 count 推定多图支持。 固定 1 本站已记录 |
moderationstring | 可选 | 上游文档允许 low；本站此精确型号的接收与实效未独立验证，默认省略。 "low" 上游公开契约 |
backgroundstring | 可选 | 背景选项/透明输出在本站此型号的枚举与实效未确证，默认省略。 未公开默认值或限制 取值待确认 |
- Content-Type: application/json；示例 size 为本型号方图客户端选择，不是全站统一默认。
像素文生图 · cURL
curl --request POST 'https://nezhai.vip/v1/images/generations' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2-2k",
"prompt": "一只坐在窗边的橘猫，柔和自然光。",
"size": "2048x2048",
"quality": "auto",
"n": 1
}'响应示例
{
"documented": "data[]，优先按实际 b64_json / url 返回项处理"
}参考图编辑（multipart）
POST
/v1/images/editsContent-Type: multipart/form-data
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-image-2-2k" 本站已记录 |
promptstring | 必填 | 生成/编辑文字指令。上游文档给 32000 字符上限，但本站精确型号的同等上限尚未独立验证。 未公开默认值或限制 本站已记录 |
sizestring | 可选 | 像素字符串，不是画幅比；本型号使用 2K 档。应显式使用对应像素；auto/省略时的实际画幅不作精确输出保证。 "auto" / "2048x2048" / "2048x1152" / "1152x2048" / "1536x2304" / "2304x1536" / "2048x1536" / "1536x2048" / "2688x1152" / "1152x2688" 本站已记录 |
qualitystring | 可选 | 本站像素协议支持四值；不发送其他协议的 xhigh/max。默认值未独立确认，示例显式 auto。 "auto" / "low" / "medium" / "high" 本站已记录 |
ninteger | 可选 | 当前本站入口固定单张；不能由其他平台或前端 count 推定多图支持。 固定 1 本站已记录 |
moderationstring | 可选 | 上游文档允许 low；本站此精确型号的接收与实效未独立验证，默认省略。 "low" 上游公开契约 |
backgroundstring | 可选 | 背景选项/透明输出在本站此型号的枚举与实效未确证，默认省略。 未公开默认值或限制 取值待确认 |
imagearray<file> | 必填 | 重复名 image 的文件字段（不是 JSON images 或单个文件路径字符串）；PNG/JPEG/WEBP，最多 7 张。 最少项数 1；最多项数 7 本站已记录 |
- 由 HTTP 客户端自动生成 multipart boundary；多个参考图重复追加 image 字段。
- @reference.png 是 cURL 本地文件占位，不是服务器可直接读取的请求字符串。
- 提示长度/单文件字节上限、mask/input_fidelity 等无哪吒逐型号确证，不编造。
参考图编辑（multipart） · cURL
curl --request POST 'https://nezhai.vip/v1/images/edits' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--form 'model=gpt-image-2-2k' \
--form 'prompt=保留参考图主体，把背景改为浅蓝色。' \
--form 'size=2048x2048' \
--form 'quality=auto' \
--form 'n=1' \
--form 'image=@reference.png'响应示例
{
"documented": "按 data[] 实际返回处理；不保证请求像素严格等于输出像素"
}调用入口概览
POST
/v1/images/generationsPOST
/v1/images/edits文生图入口见图片指南。编辑能力、请求格式和尺寸字段因型号而异，不能一律发送 multipart。 参阅图片生成指南。
可选分组
计费
【生图组】¥0.04788 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价图片生成
gpt-image-2-4k
¥0.07182/ 次【生图组】1 个分组
请求参数、示例与计费17 项参数
GPT Image 像素协议本站已记录
本站像素生图与 multipart 参考图编辑；保留精确型号。
- 哪吒此精确 ID 走 OpenAI 像素协议：JSON /images/generations，参考图 multipart /images/edits。
- 不要套第三方同名模型 JSON resolution/size(画幅比)/image(s) 请求；不发送 aspect_ratio 或 resolution。2K/4K 必须切精确模型名。
- 不显式发送 response_format；本协议常返回 data[].b64_json。不要从其他图片适配器复制 response_format。
- 尺寸映射：1:1→2880x2880；16:9→3840x2160；9:16→2160x3840；4:3→3264x2448；3:4→2448x3264；21:9→3440x1440；5:4→2560x2048；4:5→2048x2560。4K 方图是 2880x2880，不是 4096x4096。
- 2026-10-24 本站入口记录：非法/档位不匹配 size 改到当前档方图，表内同比例跨档可升到当前档像素。该行为不应作为所有上游/所有路由统一保证。
- 保留完整 ID；不把 gpt-image-2-em、adobe、sunburst 自动改成基础型号；内部实现不改变对外 ID。
- 没有发起本次生成测试；输出像素不可仅按请求字段保证。
像素文生图
POST
/v1/images/generationsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-image-2-4k" 本站已记录 |
promptstring | 必填 | 生成/编辑文字指令。上游文档给 32000 字符上限，但本站精确型号的同等上限尚未独立验证。 未公开默认值或限制 本站已记录 |
sizestring | 可选 | 像素字符串，不是画幅比；本型号使用 4K 档。应显式使用对应像素；auto/省略时的实际画幅不作精确输出保证。 "auto" / "2880x2880" / "3840x2160" / "2160x3840" / "3264x2448" / "2448x3264" / "3440x1440" / "2560x2048" / "2048x2560" 本站已记录 |
qualitystring | 可选 | 本站像素协议支持四值；不发送其他协议的 xhigh/max。默认值未独立确认，示例显式 auto。 "auto" / "low" / "medium" / "high" 本站已记录 |
ninteger | 可选 | 当前本站入口固定单张；不能由其他平台或前端 count 推定多图支持。 固定 1 本站已记录 |
moderationstring | 可选 | 上游文档允许 low；本站此精确型号的接收与实效未独立验证，默认省略。 "low" 上游公开契约 |
backgroundstring | 可选 | 背景选项/透明输出在本站此型号的枚举与实效未确证，默认省略。 未公开默认值或限制 取值待确认 |
- Content-Type: application/json；示例 size 为本型号方图客户端选择，不是全站统一默认。
像素文生图 · cURL
curl --request POST 'https://nezhai.vip/v1/images/generations' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2-4k",
"prompt": "一只坐在窗边的橘猫，柔和自然光。",
"size": "2880x2880",
"quality": "auto",
"n": 1
}'响应示例
{
"documented": "data[]，优先按实际 b64_json / url 返回项处理"
}参考图编辑（multipart）
POST
/v1/images/editsContent-Type: multipart/form-data
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-image-2-4k" 本站已记录 |
promptstring | 必填 | 生成/编辑文字指令。上游文档给 32000 字符上限，但本站精确型号的同等上限尚未独立验证。 未公开默认值或限制 本站已记录 |
sizestring | 可选 | 像素字符串，不是画幅比；本型号使用 4K 档。应显式使用对应像素；auto/省略时的实际画幅不作精确输出保证。 "auto" / "2880x2880" / "3840x2160" / "2160x3840" / "3264x2448" / "2448x3264" / "3440x1440" / "2560x2048" / "2048x2560" 本站已记录 |
qualitystring | 可选 | 本站像素协议支持四值；不发送其他协议的 xhigh/max。默认值未独立确认，示例显式 auto。 "auto" / "low" / "medium" / "high" 本站已记录 |
ninteger | 可选 | 当前本站入口固定单张；不能由其他平台或前端 count 推定多图支持。 固定 1 本站已记录 |
moderationstring | 可选 | 上游文档允许 low；本站此精确型号的接收与实效未独立验证，默认省略。 "low" 上游公开契约 |
backgroundstring | 可选 | 背景选项/透明输出在本站此型号的枚举与实效未确证，默认省略。 未公开默认值或限制 取值待确认 |
imagearray<file> | 必填 | 重复名 image 的文件字段（不是 JSON images 或单个文件路径字符串）；PNG/JPEG/WEBP，最多 7 张。 最少项数 1；最多项数 7 本站已记录 |
- 由 HTTP 客户端自动生成 multipart boundary；多个参考图重复追加 image 字段。
- @reference.png 是 cURL 本地文件占位，不是服务器可直接读取的请求字符串。
- 提示长度/单文件字节上限、mask/input_fidelity 等无哪吒逐型号确证，不编造。
参考图编辑（multipart） · cURL
curl --request POST 'https://nezhai.vip/v1/images/edits' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--form 'model=gpt-image-2-4k' \
--form 'prompt=保留参考图主体，把背景改为浅蓝色。' \
--form 'size=2880x2880' \
--form 'quality=auto' \
--form 'n=1' \
--form 'image=@reference.png'响应示例
{
"documented": "按 data[] 实际返回处理；不保证请求像素严格等于输出像素"
}调用入口概览
POST
/v1/images/generationsPOST
/v1/images/edits文生图入口见图片指南。编辑能力、请求格式和尺寸字段因型号而异，不能一律发送 multipart。 参阅图片生成指南。
可选分组
计费
【生图组】¥0.07182 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价图片生成
gpt-image-2.5
¥0.14364/ 次【生图组】2 个分组
请求参数、示例与计费17 项参数
GPT Image 像素协议本站已记录
本站像素生图与 multipart 参考图编辑；保留精确型号。
- 哪吒此精确 ID 走 OpenAI 像素协议：JSON /images/generations，参考图 multipart /images/edits。
- 不要套第三方同名模型 JSON resolution/size(画幅比)/image(s) 请求；不发送 aspect_ratio 或 resolution。2K/4K 必须切精确模型名。
- 不显式发送 response_format；本协议常返回 data[].b64_json。不要从其他图片适配器复制 response_format。
- 尺寸映射：1:1→1024x1024；16:9→1280x720；9:16→720x1280；2:3→1024x1536；3:2→1536x1024；4:3→1024x768；3:4→768x1024；21:9→1792x768；9:21→768x1792；5:4→1280x1024；4:5→1024x1280。4K 方图是 2880x2880，不是 4096x4096。
- 2026-10-24 本站入口记录：非法/档位不匹配 size 改到当前档方图，表内同比例跨档可升到当前档像素。该行为不应作为所有上游/所有路由统一保证。
- 保留完整 ID；不把 gpt-image-2-em、adobe、sunburst 自动改成基础型号；内部实现不改变对外 ID。
- 没有发起本次生成测试；输出像素不可仅按请求字段保证。
像素文生图
POST
/v1/images/generationsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-image-2.5" 本站已记录 |
promptstring | 必填 | 生成/编辑文字指令。上游文档给 32000 字符上限，但本站精确型号的同等上限尚未独立验证。 未公开默认值或限制 本站已记录 |
sizestring | 可选 | 像素字符串，不是画幅比；本型号使用 1K 档。应显式使用对应像素；auto/省略时的实际画幅不作精确输出保证。 "auto" / "1024x1024" / "1280x720" / "720x1280" / "1024x1536" / "1536x1024" / "1024x768" / "768x1024" / "1792x768" / "768x1792" / "1280x1024" / "1024x1280" 本站已记录 |
qualitystring | 可选 | 本站像素协议支持四值；不发送其他协议的 xhigh/max。默认值未独立确认，示例显式 auto。 "auto" / "low" / "medium" / "high" 本站已记录 |
ninteger | 可选 | 当前本站入口固定单张；不能由其他平台或前端 count 推定多图支持。 固定 1 本站已记录 |
moderationstring | 可选 | 上游文档允许 low；本站此精确型号的接收与实效未独立验证，默认省略。 "low" 上游公开契约 |
backgroundstring | 可选 | 背景选项/透明输出在本站此型号的枚举与实效未确证，默认省略。 未公开默认值或限制 取值待确认 |
- Content-Type: application/json；示例 size 为本型号方图客户端选择，不是全站统一默认。
像素文生图 · cURL
curl --request POST 'https://nezhai.vip/v1/images/generations' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2.5",
"prompt": "一只坐在窗边的橘猫，柔和自然光。",
"size": "1024x1024",
"quality": "auto",
"n": 1
}'响应示例
{
"documented": "data[]，优先按实际 b64_json / url 返回项处理"
}参考图编辑（multipart）
POST
/v1/images/editsContent-Type: multipart/form-data
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-image-2.5" 本站已记录 |
promptstring | 必填 | 生成/编辑文字指令。上游文档给 32000 字符上限，但本站精确型号的同等上限尚未独立验证。 未公开默认值或限制 本站已记录 |
sizestring | 可选 | 像素字符串，不是画幅比；本型号使用 1K 档。应显式使用对应像素；auto/省略时的实际画幅不作精确输出保证。 "auto" / "1024x1024" / "1280x720" / "720x1280" / "1024x1536" / "1536x1024" / "1024x768" / "768x1024" / "1792x768" / "768x1792" / "1280x1024" / "1024x1280" 本站已记录 |
qualitystring | 可选 | 本站像素协议支持四值；不发送其他协议的 xhigh/max。默认值未独立确认，示例显式 auto。 "auto" / "low" / "medium" / "high" 本站已记录 |
ninteger | 可选 | 当前本站入口固定单张；不能由其他平台或前端 count 推定多图支持。 固定 1 本站已记录 |
moderationstring | 可选 | 上游文档允许 low；本站此精确型号的接收与实效未独立验证，默认省略。 "low" 上游公开契约 |
backgroundstring | 可选 | 背景选项/透明输出在本站此型号的枚举与实效未确证，默认省略。 未公开默认值或限制 取值待确认 |
imagearray<file> | 必填 | 重复名 image 的文件字段（不是 JSON images 或单个文件路径字符串）；PNG/JPEG/WEBP，最多 7 张。 最少项数 1；最多项数 7 本站已记录 |
- 由 HTTP 客户端自动生成 multipart boundary；多个参考图重复追加 image 字段。
- @reference.png 是 cURL 本地文件占位，不是服务器可直接读取的请求字符串。
- 提示长度/单文件字节上限、mask/input_fidelity 等无哪吒逐型号确证，不编造。
参考图编辑（multipart） · cURL
curl --request POST 'https://nezhai.vip/v1/images/edits' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--form 'model=gpt-image-2.5' \
--form 'prompt=保留参考图主体，把背景改为浅蓝色。' \
--form 'size=1024x1024' \
--form 'quality=auto' \
--form 'n=1' \
--form 'image=@reference.png'响应示例
{
"documented": "按 data[] 实际返回处理；不保证请求像素严格等于输出像素"
}调用入口概览
POST
/v1/images/generationsPOST
/v1/images/edits文生图入口见图片指南。编辑能力、请求格式和尺寸字段因型号而异，不能一律发送 multipart。 参阅图片生成指南。
可选分组
计费
【生图组】¥0.14364 / 次
站长测试¥0.06384 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价¥0.02633/ 次【生图组】1 个分组
请求参数、示例与计费11 项参数
GPT JSON 图片上游公开契约
JSON 图片生成；比例与分辨率分别设置，按当前型号选择参考图及质量参数。
- 参数按完整模型 ID 区分；上游公开值与哪吒已记录的约束分别标注，未进行付费生成验证。
- 创建与参考图生成均用 application/json；单张参考图用 image，多张用 images，两者二选一。
- resolution 选择档位，size 填比例。示例按本站实际字段生成，原上游示例与参数标志保存在机器数据中。
- 这组 ID 使用哪吒 JSON 图片协议，参考图上限 14 张；gpt-image2 上游现列 16 张，此处保留本站 14 张。
- background/output_format 仅在各字段标记已确认时才可据此承诺透明背景。
创建图片
POST
/v1/images/generationsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "gpt-image-2.5-1k2k4k" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "1k" / "2k" / "4k"；默认 "1k" 本站已记录 |
sizestring | 可选 | 图片画幅比例；本页 JSON 图片示例使用比例字符串，与 resolution 分开设置。 "auto" / "1:1" / "3:2" / "2:3" / "4:3" / "3:4" / "5:4" / "4:5" / "16:9" / "9:16" / "2:1" / "1:2" / "3:1" / "1:3" / "21:9" / "9:21"；默认 "auto" 本站已记录 |
qualitystring | 可选 | 当前操作的生成质量档位；不适用于未列出该字段的编辑操作。 上游取值已公开，未声明已执行全部约束校验。 "low" / "medium" / "high" / "xhigh" / "max" 本站已记录 |
imagestring | 可选 | 单张参考图片；与 images 二选一。JSON 字符串可为公网 URL，内联图片是否可用依本型号。 未公开默认值或限制 上游公开契约 |
imagesarray | 可选 | 参考图片数组；与 image 二选一，数量遵守此型号上限。 数组元素类型：string；格式：uri-or-data-image。 最少项数 1；最多项数 14 本站已记录 |
backgroundstring | 可选 | 背景模式；候选取值的确认状态见字段标记。 上游尚未确认取值；所列范围或枚举仅为候选，不能据此承诺服务端能力。 "transparent" / "opaque" / "auto" 取值待确认 |
output_formatstring | 可选 | 输出图片格式；透明背景需要支持透明度的格式。 上游尚未确认取值；所列范围或枚举仅为候选，不能据此承诺服务端能力。 "png" / "webp" / "jpeg" 取值待确认 |
response_formatstring | 可选 | 图片返回 URL 或 Base64；读取对应 data[].url / data[].b64_json。 "url" / "b64_json"；默认 "url" 上游公开契约 |
ninteger | 可选 | 提交生成数量；任务或一次响应中实际图片数量另见结果说明。 此处采用哪吒已记录的限制；上游原始取值另保留在机器数据的 upstream_parameter 中。 固定 1；最小 1；最大 1 本站已记录 |
- 省略可选字段时的服务端行为仅以表中已公开默认值为准。
创建图片 · cURL
curl --request POST 'https://nezhai.vip/v1/images/generations' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2.5-1k2k4k",
"prompt": "电影感产品图：柔和自然光，主体清晰，背景简洁。",
"resolution": "1k",
"size": "auto",
"response_format": "url",
"n": 1
}'结果读取：普通图片读取 data[].url 或 data[].b64_json。MJ 任务保存 id/task_id，完成后读取 result.data.image_urls 与可选 grid_image_url。
调用入口概览
POST
/v1/images/generations文生图入口见图片指南。编辑能力、请求格式和尺寸字段因型号而异，不能一律发送 multipart。 参阅图片生成指南。
可选分组
计费
【生图组】¥0.02633 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价图片生成
gpt-image-2.5-2k
¥0.04788/ 次【生图组】1 个分组
请求参数、示例与计费17 项参数
GPT Image 像素协议本站已记录
本站像素生图与 multipart 参考图编辑；保留精确型号。
- 哪吒此精确 ID 走 OpenAI 像素协议：JSON /images/generations，参考图 multipart /images/edits。
- 不要套第三方同名模型 JSON resolution/size(画幅比)/image(s) 请求；不发送 aspect_ratio 或 resolution。2K/4K 必须切精确模型名。
- 不显式发送 response_format；本协议常返回 data[].b64_json。不要从其他图片适配器复制 response_format。
- 尺寸映射：1:1→2048x2048；16:9→2048x1152；9:16→1152x2048；2:3→1536x2304；3:2→2304x1536；4:3→2048x1536；3:4→1536x2048；21:9→2688x1152；9:21→1152x2688。4K 方图是 2880x2880，不是 4096x4096。
- 2026-10-24 本站入口记录：非法/档位不匹配 size 改到当前档方图，表内同比例跨档可升到当前档像素。该行为不应作为所有上游/所有路由统一保证。
- 保留完整 ID；不把 gpt-image-2-em、adobe、sunburst 自动改成基础型号；内部实现不改变对外 ID。
- 没有发起本次生成测试；输出像素不可仅按请求字段保证。
像素文生图
POST
/v1/images/generationsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-image-2.5-2k" 本站已记录 |
promptstring | 必填 | 生成/编辑文字指令。上游文档给 32000 字符上限，但本站精确型号的同等上限尚未独立验证。 未公开默认值或限制 本站已记录 |
sizestring | 可选 | 像素字符串，不是画幅比；本型号使用 2K 档。应显式使用对应像素；auto/省略时的实际画幅不作精确输出保证。 "auto" / "2048x2048" / "2048x1152" / "1152x2048" / "1536x2304" / "2304x1536" / "2048x1536" / "1536x2048" / "2688x1152" / "1152x2688" 本站已记录 |
qualitystring | 可选 | 本站像素协议支持四值；不发送其他协议的 xhigh/max。默认值未独立确认，示例显式 auto。 "auto" / "low" / "medium" / "high" 本站已记录 |
ninteger | 可选 | 当前本站入口固定单张；不能由其他平台或前端 count 推定多图支持。 固定 1 本站已记录 |
moderationstring | 可选 | 上游文档允许 low；本站此精确型号的接收与实效未独立验证，默认省略。 "low" 上游公开契约 |
backgroundstring | 可选 | 背景选项/透明输出在本站此型号的枚举与实效未确证，默认省略。 未公开默认值或限制 取值待确认 |
- Content-Type: application/json；示例 size 为本型号方图客户端选择，不是全站统一默认。
像素文生图 · cURL
curl --request POST 'https://nezhai.vip/v1/images/generations' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2.5-2k",
"prompt": "一只坐在窗边的橘猫，柔和自然光。",
"size": "2048x2048",
"quality": "auto",
"n": 1
}'响应示例
{
"documented": "data[]，优先按实际 b64_json / url 返回项处理"
}参考图编辑（multipart）
POST
/v1/images/editsContent-Type: multipart/form-data
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-image-2.5-2k" 本站已记录 |
promptstring | 必填 | 生成/编辑文字指令。上游文档给 32000 字符上限，但本站精确型号的同等上限尚未独立验证。 未公开默认值或限制 本站已记录 |
sizestring | 可选 | 像素字符串，不是画幅比；本型号使用 2K 档。应显式使用对应像素；auto/省略时的实际画幅不作精确输出保证。 "auto" / "2048x2048" / "2048x1152" / "1152x2048" / "1536x2304" / "2304x1536" / "2048x1536" / "1536x2048" / "2688x1152" / "1152x2688" 本站已记录 |
qualitystring | 可选 | 本站像素协议支持四值；不发送其他协议的 xhigh/max。默认值未独立确认，示例显式 auto。 "auto" / "low" / "medium" / "high" 本站已记录 |
ninteger | 可选 | 当前本站入口固定单张；不能由其他平台或前端 count 推定多图支持。 固定 1 本站已记录 |
moderationstring | 可选 | 上游文档允许 low；本站此精确型号的接收与实效未独立验证，默认省略。 "low" 上游公开契约 |
backgroundstring | 可选 | 背景选项/透明输出在本站此型号的枚举与实效未确证，默认省略。 未公开默认值或限制 取值待确认 |
imagearray<file> | 必填 | 重复名 image 的文件字段（不是 JSON images 或单个文件路径字符串）；PNG/JPEG/WEBP，最多 7 张。 最少项数 1；最多项数 7 本站已记录 |
- 由 HTTP 客户端自动生成 multipart boundary；多个参考图重复追加 image 字段。
- @reference.png 是 cURL 本地文件占位，不是服务器可直接读取的请求字符串。
- 提示长度/单文件字节上限、mask/input_fidelity 等无哪吒逐型号确证，不编造。
参考图编辑（multipart） · cURL
curl --request POST 'https://nezhai.vip/v1/images/edits' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--form 'model=gpt-image-2.5-2k' \
--form 'prompt=保留参考图主体，把背景改为浅蓝色。' \
--form 'size=2048x2048' \
--form 'quality=auto' \
--form 'n=1' \
--form 'image=@reference.png'响应示例
{
"documented": "按 data[] 实际返回处理；不保证请求像素严格等于输出像素"
}调用入口概览
POST
/v1/images/generationsPOST
/v1/images/edits文生图入口见图片指南。编辑能力、请求格式和尺寸字段因型号而异，不能一律发送 multipart。 参阅图片生成指南。
可选分组
计费
【生图组】¥0.04788 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价图片生成
gpt-image-2.5-4k
¥0.07182/ 次【生图组】1 个分组
请求参数、示例与计费17 项参数
GPT Image 像素协议本站已记录
本站像素生图与 multipart 参考图编辑；保留精确型号。
- 哪吒此精确 ID 走 OpenAI 像素协议：JSON /images/generations，参考图 multipart /images/edits。
- 不要套第三方同名模型 JSON resolution/size(画幅比)/image(s) 请求；不发送 aspect_ratio 或 resolution。2K/4K 必须切精确模型名。
- 不显式发送 response_format；本协议常返回 data[].b64_json。不要从其他图片适配器复制 response_format。
- 尺寸映射：1:1→2880x2880；16:9→3840x2160；9:16→2160x3840；4:3→3264x2448；3:4→2448x3264；21:9→3440x1440；5:4→2560x2048；4:5→2048x2560。4K 方图是 2880x2880，不是 4096x4096。
- 2026-10-24 本站入口记录：非法/档位不匹配 size 改到当前档方图，表内同比例跨档可升到当前档像素。该行为不应作为所有上游/所有路由统一保证。
- 保留完整 ID；不把 gpt-image-2-em、adobe、sunburst 自动改成基础型号；内部实现不改变对外 ID。
- 没有发起本次生成测试；输出像素不可仅按请求字段保证。
像素文生图
POST
/v1/images/generationsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-image-2.5-4k" 本站已记录 |
promptstring | 必填 | 生成/编辑文字指令。上游文档给 32000 字符上限，但本站精确型号的同等上限尚未独立验证。 未公开默认值或限制 本站已记录 |
sizestring | 可选 | 像素字符串，不是画幅比；本型号使用 4K 档。应显式使用对应像素；auto/省略时的实际画幅不作精确输出保证。 "auto" / "2880x2880" / "3840x2160" / "2160x3840" / "3264x2448" / "2448x3264" / "3440x1440" / "2560x2048" / "2048x2560" 本站已记录 |
qualitystring | 可选 | 本站像素协议支持四值；不发送其他协议的 xhigh/max。默认值未独立确认，示例显式 auto。 "auto" / "low" / "medium" / "high" 本站已记录 |
ninteger | 可选 | 当前本站入口固定单张；不能由其他平台或前端 count 推定多图支持。 固定 1 本站已记录 |
moderationstring | 可选 | 上游文档允许 low；本站此精确型号的接收与实效未独立验证，默认省略。 "low" 上游公开契约 |
backgroundstring | 可选 | 背景选项/透明输出在本站此型号的枚举与实效未确证，默认省略。 未公开默认值或限制 取值待确认 |
- Content-Type: application/json；示例 size 为本型号方图客户端选择，不是全站统一默认。
像素文生图 · cURL
curl --request POST 'https://nezhai.vip/v1/images/generations' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2.5-4k",
"prompt": "一只坐在窗边的橘猫，柔和自然光。",
"size": "2880x2880",
"quality": "auto",
"n": 1
}'响应示例
{
"documented": "data[]，优先按实际 b64_json / url 返回项处理"
}参考图编辑（multipart）
POST
/v1/images/editsContent-Type: multipart/form-data
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-image-2.5-4k" 本站已记录 |
promptstring | 必填 | 生成/编辑文字指令。上游文档给 32000 字符上限，但本站精确型号的同等上限尚未独立验证。 未公开默认值或限制 本站已记录 |
sizestring | 可选 | 像素字符串，不是画幅比；本型号使用 4K 档。应显式使用对应像素；auto/省略时的实际画幅不作精确输出保证。 "auto" / "2880x2880" / "3840x2160" / "2160x3840" / "3264x2448" / "2448x3264" / "3440x1440" / "2560x2048" / "2048x2560" 本站已记录 |
qualitystring | 可选 | 本站像素协议支持四值；不发送其他协议的 xhigh/max。默认值未独立确认，示例显式 auto。 "auto" / "low" / "medium" / "high" 本站已记录 |
ninteger | 可选 | 当前本站入口固定单张；不能由其他平台或前端 count 推定多图支持。 固定 1 本站已记录 |
moderationstring | 可选 | 上游文档允许 low；本站此精确型号的接收与实效未独立验证，默认省略。 "low" 上游公开契约 |
backgroundstring | 可选 | 背景选项/透明输出在本站此型号的枚举与实效未确证，默认省略。 未公开默认值或限制 取值待确认 |
imagearray<file> | 必填 | 重复名 image 的文件字段（不是 JSON images 或单个文件路径字符串）；PNG/JPEG/WEBP，最多 7 张。 最少项数 1；最多项数 7 本站已记录 |
- 由 HTTP 客户端自动生成 multipart boundary；多个参考图重复追加 image 字段。
- @reference.png 是 cURL 本地文件占位，不是服务器可直接读取的请求字符串。
- 提示长度/单文件字节上限、mask/input_fidelity 等无哪吒逐型号确证，不编造。
参考图编辑（multipart） · cURL
curl --request POST 'https://nezhai.vip/v1/images/edits' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--form 'model=gpt-image-2.5-4k' \
--form 'prompt=保留参考图主体，把背景改为浅蓝色。' \
--form 'size=2880x2880' \
--form 'quality=auto' \
--form 'n=1' \
--form 'image=@reference.png'响应示例
{
"documented": "按 data[] 实际返回处理；不保证请求像素严格等于输出像素"
}调用入口概览
POST
/v1/images/generationsPOST
/v1/images/edits文生图入口见图片指南。编辑能力、请求格式和尺寸字段因型号而异，不能一律发送 multipart。 参阅图片生成指南。
可选分组
计费
【生图组】¥0.07182 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价按公式计费仅站长测试分组1 个分组
请求参数、示例与计费3 项参数
GPT Image · 待确认取值待确认
目录可见，但该精确 ID 的哪吒路由与参数尚未确证。
- 不要把此 ID 归入本站像素协议九型号，也不要把第三方相近/带 official 后缀的模型自动当作同一个。
- 目录声明 image-generation/openai 不是编辑、视觉聊天、尺寸档位或参考图数量的证明。
- quality/size/n 默认、像素或画幅比语义、参考图编码、响应格式与编辑路径全部待补；未生成可复制调用示例。
图片入口声明（完整契约待补）
POST
/v1/images/generationsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-image-2.5-flare" 本站已记录 |
promptstring | 可选 | 通用图片协议中的文字提示；本站此精确 ID 的必填性与长度上限尚未确证。 未公开默认值或限制 取值待确认 |
- 路径仅来自目录 image-generation 声明，不代表当前模型请求已验收；不附猜测的成功示例。
参数依据：哪吒目录：精确 ID 与 image-generation 声明 2026-10-24
调用入口概览
POST
/v1/images/generations文生图入口见图片指南。编辑能力、请求格式和尺寸字段因型号而异，不能一律发送 multipart。 参阅图片生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按公式计费仅站长测试分组1 个分组
请求参数、示例与计费17 项参数
GPT Image 像素协议本站已记录
本站像素生图与 multipart 参考图编辑；保留精确型号。
- 哪吒此精确 ID 走 OpenAI 像素协议：JSON /images/generations，参考图 multipart /images/edits。
- 不要套第三方同名模型 JSON resolution/size(画幅比)/image(s) 请求；不发送 aspect_ratio 或 resolution。2K/4K 必须切精确模型名。
- 不显式发送 response_format；本协议常返回 data[].b64_json。不要从其他图片适配器复制 response_format。
- 尺寸映射：1:1→1024x1024；16:9→1280x720；9:16→720x1280；2:3→1024x1536；3:2→1536x1024；4:3→1024x768；3:4→768x1024；21:9→1792x768；9:21→768x1792；5:4→1280x1024；4:5→1024x1280。4K 方图是 2880x2880，不是 4096x4096。
- 2026-10-24 本站入口记录：非法/档位不匹配 size 改到当前档方图，表内同比例跨档可升到当前档像素。该行为不应作为所有上游/所有路由统一保证。
- 保留完整 ID；不把 gpt-image-2-em、adobe、sunburst 自动改成基础型号；内部实现不改变对外 ID。
- 没有发起本次生成测试；输出像素不可仅按请求字段保证。
像素文生图
POST
/v1/images/generationsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-image-2.5-sunburst" 本站已记录 |
promptstring | 必填 | 生成/编辑文字指令。上游文档给 32000 字符上限，但本站精确型号的同等上限尚未独立验证。 未公开默认值或限制 本站已记录 |
sizestring | 可选 | 像素字符串，不是画幅比；本型号使用 1K 档。应显式使用对应像素；auto/省略时的实际画幅不作精确输出保证。 "auto" / "1024x1024" / "1280x720" / "720x1280" / "1024x1536" / "1536x1024" / "1024x768" / "768x1024" / "1792x768" / "768x1792" / "1280x1024" / "1024x1280" 本站已记录 |
qualitystring | 可选 | 本站像素协议支持四值；不发送其他协议的 xhigh/max。默认值未独立确认，示例显式 auto。 "auto" / "low" / "medium" / "high" 本站已记录 |
ninteger | 可选 | 当前本站入口固定单张；不能由其他平台或前端 count 推定多图支持。 固定 1 本站已记录 |
moderationstring | 可选 | 上游文档允许 low；本站此精确型号的接收与实效未独立验证，默认省略。 "low" 上游公开契约 |
backgroundstring | 可选 | 背景选项/透明输出在本站此型号的枚举与实效未确证，默认省略。 未公开默认值或限制 取值待确认 |
- Content-Type: application/json；示例 size 为本型号方图客户端选择，不是全站统一默认。
像素文生图 · cURL
curl --request POST 'https://nezhai.vip/v1/images/generations' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2.5-sunburst",
"prompt": "一只坐在窗边的橘猫，柔和自然光。",
"size": "1024x1024",
"quality": "auto",
"n": 1
}'响应示例
{
"documented": "data[]，优先按实际 b64_json / url 返回项处理"
}参考图编辑（multipart）
POST
/v1/images/editsContent-Type: multipart/form-data
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-image-2.5-sunburst" 本站已记录 |
promptstring | 必填 | 生成/编辑文字指令。上游文档给 32000 字符上限，但本站精确型号的同等上限尚未独立验证。 未公开默认值或限制 本站已记录 |
sizestring | 可选 | 像素字符串，不是画幅比；本型号使用 1K 档。应显式使用对应像素；auto/省略时的实际画幅不作精确输出保证。 "auto" / "1024x1024" / "1280x720" / "720x1280" / "1024x1536" / "1536x1024" / "1024x768" / "768x1024" / "1792x768" / "768x1792" / "1280x1024" / "1024x1280" 本站已记录 |
qualitystring | 可选 | 本站像素协议支持四值；不发送其他协议的 xhigh/max。默认值未独立确认，示例显式 auto。 "auto" / "low" / "medium" / "high" 本站已记录 |
ninteger | 可选 | 当前本站入口固定单张；不能由其他平台或前端 count 推定多图支持。 固定 1 本站已记录 |
moderationstring | 可选 | 上游文档允许 low；本站此精确型号的接收与实效未独立验证，默认省略。 "low" 上游公开契约 |
backgroundstring | 可选 | 背景选项/透明输出在本站此型号的枚举与实效未确证，默认省略。 未公开默认值或限制 取值待确认 |
imagearray<file> | 必填 | 重复名 image 的文件字段（不是 JSON images 或单个文件路径字符串）；PNG/JPEG/WEBP，最多 7 张。 最少项数 1；最多项数 7 本站已记录 |
- 由 HTTP 客户端自动生成 multipart boundary；多个参考图重复追加 image 字段。
- @reference.png 是 cURL 本地文件占位，不是服务器可直接读取的请求字符串。
- 提示长度/单文件字节上限、mask/input_fidelity 等无哪吒逐型号确证，不编造。
参考图编辑（multipart） · cURL
curl --request POST 'https://nezhai.vip/v1/images/edits' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--form 'model=gpt-image-2.5-sunburst' \
--form 'prompt=保留参考图主体，把背景改为浅蓝色。' \
--form 'size=1024x1024' \
--form 'quality=auto' \
--form 'n=1' \
--form 'image=@reference.png'响应示例
{
"documented": "按 data[] 实际返回处理；不保证请求像素严格等于输出像素"
}调用入口概览
POST
/v1/images/generationsPOST
/v1/images/edits文生图入口见图片指南。编辑能力、请求格式和尺寸字段因型号而异，不能一律发送 multipart。 参阅图片生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价¥0.02633/ 次【生图组】1 个分组
请求参数、示例与计费11 项参数
GPT JSON 图片上游公开契约
JSON 图片生成；比例与分辨率分别设置，按当前型号选择参考图及质量参数。
- 参数按完整模型 ID 区分；上游公开值与哪吒已记录的约束分别标注，未进行付费生成验证。
- 创建与参考图生成均用 application/json；单张参考图用 image，多张用 images，两者二选一。
- resolution 选择档位，size 填比例。示例按本站实际字段生成，原上游示例与参数标志保存在机器数据中。
- 这组 ID 使用哪吒 JSON 图片协议，参考图上限 14 张；gpt-image2 上游现列 16 张，此处保留本站 14 张。
- background/output_format 仅在各字段标记已确认时才可据此承诺透明背景。
创建图片
POST
/v1/images/generationsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "gpt-image-2.5-sunburst1k2k4k" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "1k" / "2k" / "4k"；默认 "1k" 本站已记录 |
sizestring | 可选 | 图片画幅比例；本页 JSON 图片示例使用比例字符串，与 resolution 分开设置。 "auto" / "1:1" / "3:2" / "2:3" / "4:3" / "3:4" / "5:4" / "4:5" / "16:9" / "9:16" / "2:1" / "1:2" / "3:1" / "1:3" / "21:9" / "9:21"；默认 "auto" 本站已记录 |
qualitystring | 可选 | 当前操作的生成质量档位；不适用于未列出该字段的编辑操作。 上游取值已公开，未声明已执行全部约束校验。 "low" / "medium" / "high" / "xhigh" / "max" 本站已记录 |
imagestring | 可选 | 单张参考图片；与 images 二选一。JSON 字符串可为公网 URL，内联图片是否可用依本型号。 未公开默认值或限制 上游公开契约 |
imagesarray | 可选 | 参考图片数组；与 image 二选一，数量遵守此型号上限。 数组元素类型：string；格式：uri-or-data-image。 最少项数 1；最多项数 14 本站已记录 |
backgroundstring | 可选 | 背景模式；候选取值的确认状态见字段标记。 上游尚未确认取值；所列范围或枚举仅为候选，不能据此承诺服务端能力。 "transparent" / "opaque" / "auto" 取值待确认 |
output_formatstring | 可选 | 输出图片格式；透明背景需要支持透明度的格式。 上游尚未确认取值；所列范围或枚举仅为候选，不能据此承诺服务端能力。 "png" / "webp" / "jpeg" 取值待确认 |
response_formatstring | 可选 | 图片返回 URL 或 Base64；读取对应 data[].url / data[].b64_json。 "url" / "b64_json"；默认 "url" 上游公开契约 |
ninteger | 可选 | 提交生成数量；任务或一次响应中实际图片数量另见结果说明。 此处采用哪吒已记录的限制；上游原始取值另保留在机器数据的 upstream_parameter 中。 固定 1；最小 1；最大 1 本站已记录 |
- 省略可选字段时的服务端行为仅以表中已公开默认值为准。
创建图片 · cURL
curl --request POST 'https://nezhai.vip/v1/images/generations' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image-2.5-sunburst1k2k4k",
"prompt": "电影感产品图：柔和自然光，主体清晰，背景简洁。",
"resolution": "1k",
"size": "auto",
"response_format": "url",
"n": 1
}'结果读取：普通图片读取 data[].url 或 data[].b64_json。MJ 任务保存 id/task_id，完成后读取 result.data.image_urls 与可选 grid_image_url。
调用入口概览
POST
/v1/images/generations文生图入口见图片指南。编辑能力、请求格式和尺寸字段因型号而异，不能一律发送 multipart。 参阅图片生成指南。
可选分组
计费
【生图组】¥0.02633 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价图片生成
gpt-image2
¥0.07182/ 次【生图组】1 个分组
请求参数、示例与计费13 项参数
GPT JSON 图片上游公开契约
JSON 图片生成；比例与分辨率分别设置，按当前型号选择参考图及质量参数。
- 参数按完整模型 ID 区分；上游公开值与哪吒已记录的约束分别标注，未进行付费生成验证。
- 创建与参考图生成均用 application/json；单张参考图用 image，多张用 images，两者二选一。
- resolution 选择档位，size 填比例。示例按本站实际字段生成，原上游示例与参数标志保存在机器数据中。
- 这组 ID 使用哪吒 JSON 图片协议，参考图上限 14 张；gpt-image2 上游现列 16 张，此处保留本站 14 张。
- background/output_format 仅在各字段标记已确认时才可据此承诺透明背景。
创建图片
POST
/v1/images/generationsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "gpt-image2" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "1k" / "2k" / "4k"；默认 "1k" 本站已记录 |
sizestring | 可选 | 图片画幅比例；本页 JSON 图片示例使用比例字符串，与 resolution 分开设置。 上游取值已公开，未声明已执行全部约束校验。 此处采用哪吒已记录的限制；上游原始取值另保留在机器数据的 upstream_parameter 中。 "auto" / "1:1" / "3:2" / "2:3" / "4:3" / "3:4" / "5:4" / "4:5" / "16:9" / "9:16" / "21:9" / "9:21" / "2:1" / "1:2" / "3:1" / "1:3" 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "auto" / "1:1" / "3:2" / "2:3" / "4:3" / "3:4" / "5:4" / "4:5" / "16:9" / "9:16" / "2:1" / "1:2" / "3:1" / "1:3" / "21:9" / "9:21"；默认 "auto" 本站已记录 |
aspectRatiostring | 可选 | 上游公开的兼容比例别名；优先使用本页示例中的规范字段。 "auto" / "1:1" / "3:2" / "2:3" / "4:3" / "3:4" / "5:4" / "4:5" / "16:9" / "9:16" / "2:1" / "1:2" / "3:1" / "1:3" / "21:9" / "9:21" 本站已记录 |
ratiostring | 可选 | 上游公开的兼容比例别名；与其他比例字段择一填写。 "auto" / "1:1" / "3:2" / "2:3" / "4:3" / "3:4" / "5:4" / "4:5" / "16:9" / "9:16" / "2:1" / "1:2" / "3:1" / "1:3" / "21:9" / "9:21" 本站已记录 |
qualitystring | 可选 | 当前操作的生成质量档位；不适用于未列出该字段的编辑操作。 "low" / "medium" / "high"；默认 "medium" 本站已记录 |
imagestring | 可选 | 单张参考图片；与 images 二选一。JSON 字符串可为公网 URL，内联图片是否可用依本型号。 未公开默认值或限制 上游公开契约 |
imagesarray | 可选 | 参考图片数组；与 image 二选一，数量遵守此型号上限。 数组元素类型：string；格式：uri-or-data-image。 此处采用哪吒已记录的限制；上游原始取值另保留在机器数据的 upstream_parameter 中。 最少项数 1；最多项数 14 本站已记录 |
backgroundstring | 可选 | 背景模式；候选取值的确认状态见字段标记。 上游尚未确认取值；所列范围或枚举仅为候选，不能据此承诺服务端能力。 "transparent" / "opaque" / "auto" 取值待确认 |
output_formatstring | 可选 | 输出图片格式；透明背景需要支持透明度的格式。 上游尚未确认取值；所列范围或枚举仅为候选，不能据此承诺服务端能力。 "png" / "webp" / "jpeg" 取值待确认 |
ninteger | 可选 | 提交生成数量；任务或一次响应中实际图片数量另见结果说明。 此处采用哪吒已记录的限制；上游原始取值另保留在机器数据的 upstream_parameter 中。 固定 1；最小 1；最大 1 本站已记录 |
- 省略可选字段时的服务端行为仅以表中已公开默认值为准。
创建图片 · cURL
curl --request POST 'https://nezhai.vip/v1/images/generations' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image2",
"prompt": "电影感产品图：柔和自然光，主体清晰，背景简洁。",
"resolution": "1k",
"size": "16:9",
"quality": "medium",
"n": 1
}'结果读取：普通图片读取 data[].url 或 data[].b64_json。MJ 任务保存 id/task_id，完成后读取 result.data.image_urls 与可选 grid_image_url。
调用入口概览
POST
/v1/images/generations文生图入口见图片指南。编辑能力、请求格式和尺寸字段因型号而异，不能一律发送 multipart。 参阅图片生成指南。
可选分组
计费
【生图组】¥0.07182 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价¥0.02633/ 次【生图组】1 个分组
请求参数、示例与计费13 项参数
GPT JSON 图片上游公开契约
JSON 图片生成；比例与分辨率分别设置，按当前型号选择参考图及质量参数。
- 参数按完整模型 ID 区分；上游公开值与哪吒已记录的约束分别标注，未进行付费生成验证。
- 创建与参考图生成均用 application/json；单张参考图用 image，多张用 images，两者二选一。
- resolution 选择档位，size 填比例。示例按本站实际字段生成，原上游示例与参数标志保存在机器数据中。
- 这组 ID 使用哪吒 JSON 图片协议，参考图上限 14 张；gpt-image2 上游现列 16 张，此处保留本站 14 张。
- background/output_format 仅在各字段标记已确认时才可据此承诺透明背景。
创建图片
POST
/v1/images/generationsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "gpt-image2-1k2k4k" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "1k" / "2k" / "4k"；默认 "1k" 本站已记录 |
sizestring | 可选 | 图片画幅比例；本页 JSON 图片示例使用比例字符串，与 resolution 分开设置。 上游取值已公开，未声明已执行全部约束校验。 此处采用哪吒已记录的限制；上游原始取值另保留在机器数据的 upstream_parameter 中。 "auto" / "1:1" / "3:2" / "2:3" / "4:3" / "3:4" / "5:4" / "4:5" / "16:9" / "9:16" / "21:9" / "9:21" / "2:1" / "1:2" / "3:1" / "1:3" 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "auto" / "1:1" / "3:2" / "2:3" / "4:3" / "3:4" / "5:4" / "4:5" / "16:9" / "9:16" / "2:1" / "1:2" / "3:1" / "1:3" / "21:9" / "9:21"；默认 "auto" 本站已记录 |
aspectRatiostring | 可选 | 上游公开的兼容比例别名；优先使用本页示例中的规范字段。 "auto" / "1:1" / "3:2" / "2:3" / "4:3" / "3:4" / "5:4" / "4:5" / "16:9" / "9:16" / "2:1" / "1:2" / "3:1" / "1:3" / "21:9" / "9:21" 本站已记录 |
ratiostring | 可选 | 上游公开的兼容比例别名；与其他比例字段择一填写。 "auto" / "1:1" / "3:2" / "2:3" / "4:3" / "3:4" / "5:4" / "4:5" / "16:9" / "9:16" / "2:1" / "1:2" / "3:1" / "1:3" / "21:9" / "9:21" 本站已记录 |
qualitystring | 可选 | 当前操作的生成质量档位；不适用于未列出该字段的编辑操作。 "low" / "medium" / "high"；默认 "medium" 本站已记录 |
imagestring | 可选 | 单张参考图片；与 images 二选一。JSON 字符串可为公网 URL，内联图片是否可用依本型号。 未公开默认值或限制 上游公开契约 |
imagesarray | 可选 | 参考图片数组；与 image 二选一，数量遵守此型号上限。 数组元素类型：string；格式：uri-or-data-image。 最少项数 1；最多项数 14 本站已记录 |
backgroundstring | 可选 | 背景模式；候选取值的确认状态见字段标记。 上游尚未确认取值；所列范围或枚举仅为候选，不能据此承诺服务端能力。 "transparent" / "opaque" / "auto" 取值待确认 |
output_formatstring | 可选 | 输出图片格式；透明背景需要支持透明度的格式。 上游尚未确认取值；所列范围或枚举仅为候选，不能据此承诺服务端能力。 "png" / "webp" / "jpeg" 取值待确认 |
ninteger | 可选 | 提交生成数量；任务或一次响应中实际图片数量另见结果说明。 此处采用哪吒已记录的限制；上游原始取值另保留在机器数据的 upstream_parameter 中。 固定 1；最小 1；最大 1 本站已记录 |
- 省略可选字段时的服务端行为仅以表中已公开默认值为准。
创建图片 · cURL
curl --request POST 'https://nezhai.vip/v1/images/generations' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-image2-1k2k4k",
"prompt": "电影感产品图：柔和自然光，主体清晰，背景简洁。",
"resolution": "1k",
"size": "16:9",
"quality": "medium",
"n": 1
}'结果读取：普通图片读取 data[].url 或 data[].b64_json。MJ 任务保存 id/task_id，完成后读取 result.data.image_urls 与可选 grid_image_url。
调用入口概览
POST
/v1/images/generations文生图入口见图片指南。编辑能力、请求格式和尺寸字段因型号而异，不能一律发送 multipart。 参阅图片生成指南。
可选分组
计费
【生图组】¥0.02633 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价文本生成
gpt-reserve
按量计费1 个分组
请求参数、示例与计费42 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "gpt-reserve" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-reserve",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}调用入口概览
POST
/v1/chat/completions以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
grok-4.5
按公式计费1 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "grok-4.5" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-4.5",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "grok-4.5" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-4.5",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "grok-4.5" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-4.5",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "grok-4.5" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-4.5",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/grok-4.5:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "grok-4.5" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/grok-4.5:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "grok-4.5" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/grok-4.5:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
grok-4.6
按公式计费2 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "grok-4.6" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-4.6",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "grok-4.6" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-4.6",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "grok-4.6" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-4.6",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "grok-4.6" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-4.6",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/grok-4.6:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "grok-4.6" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/grok-4.6:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "grok-4.6" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/grok-4.6:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
grok-4.7
按公式计费2 个分组
请求参数、示例与计费174 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai、openai-response、openai-response-compact、anthropic、gemini、openai-alpha-search；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "grok-4.7" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-4.7",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}OpenAI Responses
POST
/v1/responsesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "grok-4.7" 本站已记录 |
inputstring|array<object> | 必填 | 待生成输入；可为文本或消息/工具调用项数组；不发送 messages。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].typestring | 可选 | 消息可用 message 或按协议省略；函数往返用 function_call / function_call_output。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项角色，message 项需要。 "system" / "developer" / "user" / "assistant" 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 消息正文；内容块类型不同于 Chat。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].typestring | 可选 | 输入块类型；图片、文件仅在模型与渠道确认支持时使用。 "input_text" / "input_image" / "input_file" 协议字段 · 能力依型号 |
input[].content[].textstring | 可选 | type=input_text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].image_urlstring | 可选 | type=input_image 时使用；不是 Chat 的 image_url.url。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].detailstring | 可选 | 图片细节，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
input[].content[].file_idstring | 可选 | type=input_file 时的文件 ID；文件上传/保留能力另验。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_datastring | 可选 | type=input_file 时的文件数据；与 file_id/file_url 的取舍依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].content[].file_urlstring | 可选 | type=input_file 时的可访问文件地址；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].call_idstring | 可选 | function_call_output 必填，关联 function_call.call_id。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].outputstring|array<object> | 可选 | function_call_output 的工具结果。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 本次系统/开发者指令；previous_response_id 不意味着上一轮 instructions 自动继承。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 条件支持的上次 Responses ID；会话存储与跨请求恢复并非目录可保证。 未公开默认值或限制 协议字段 · 能力依型号 |
conversationstring|object | 可选 | 条件支持的托管会话；不要与 previous_response_id 同时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议默认非流式；true 使用 Responses SSE 事件，不是 Chat delta。 默认 false 协议字段 · 能力依型号 |
stream_optionsobject | 可选 | 流式扩展，仅在渠道支持时使用；不假设 Chat 的所有子项通用。 未公开默认值或限制 协议字段 · 能力依型号 |
max_output_tokensinteger | 可选 | Responses 输出预算，可能包含推理 token；不使用 max_tokens / max_completion_tokens，无本站逐型号上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 条件支持；推理型号可能不接受。范围与默认值未逐型号确认。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 条件支持的核采样。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoningobject | 可选 | 条件支持的推理配置。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.effortstring | 可选 | 推理等级依精确模型；不预填通用枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning.summarystring | 可选 | 条件支持的推理摘要设置。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持；函数工具属性是扁平的 type/name/parameters，不套 Chat.function。其他内置工具需单独证实。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 自定义函数填写 function；web_search 等内置工具不能据同名目录假定放行。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | type=function 时必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 函数说明。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].parametersobject | 可选 | 函数参数 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].strictboolean | 可选 | 严格参数匹配，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | none/auto/required 或 {type:function,name:...}；不同于 Chat 的 function 嵌套。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 是否允许并行工具，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tool_callsinteger | 可选 | 内置工具调用预算，条件支持；不是客户端函数执行次数保证。 未公开默认值或限制 协议字段 · 能力依型号 |
textobject | 可选 | Responses 输出格式设置；不发送顶层 response_format。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.typestring | 可选 | text/json_object/json_schema，依模型支持。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
text.format.namestring | 可选 | JSON Schema 名称（不是 Chat 的 json_schema.name 嵌套）。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.schemaobject | 可选 | 结构化输出 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
text.format.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
text.verbositystring | 可选 | 文字详细程度，精确型号支持待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
includearray<string> | 可选 | 请求附加响应字段；允许项依模型/渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 是否允许上游保存；本站实际保留/过滤策略另验，不抄上游默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 应用元数据，不放凭证。 未公开默认值或限制 协议字段 · 能力依型号 |
truncationstring | 可选 | 输入超长处理，条件支持；不能用它推断上下文长度。 未公开默认值或限制 协议字段 · 能力依型号 |
promptobject | 可选 | 条件支持的提示模板引用，如 id/version/variables；不等于 Chat 的 prompt 文本。 未公开默认值或限制 协议字段 · 能力依型号 |
context_managementarray<object> | 可选 | 上下文管理扩展；不能把 /responses/compact 声明等同于自动压缩支持。 未公开默认值或限制 协议字段 · 能力依型号 |
- 这是目录声明的协议映射；未逐模型验证本站真实 Responses 转换、工具与可调推理等级。
- 读取 output[].content[].text；不要依赖 Chat choices，也不要仅假定 SDK 的 output_text 便利属性存在于原始 JSON。
- SSE 使用 response.* 事件；API Key 有权见到模型不等于全部 Responses 可选项可用。
OpenAI Responses · cURL
curl --request POST 'https://nezhai.vip/v1/responses' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-4.7",
"input": "请用一句话介绍哪吒 API。",
"stream": false
}'响应示例
{
"protocol": "id/status/output[]/usage；流式 response.output_text.delta 等 response.* 事件"
}Responses 上下文压缩（目录声明）
POST
/v1/responses/compactContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "grok-4.7" 本站已记录 |
inputarray<object> | 必填 | 待压缩的 Responses 对话项数组；含原有消息与函数往返。这里不是自由文本生成。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].rolestring | 可选 | 消息项使用对应角色。 未公开默认值或限制 协议字段 · 能力依型号 |
input[].contentstring|array<object> | 可选 | 保留原对话输入结构。 未公开默认值或限制 协议字段 · 能力依型号 |
instructionsstring | 可选 | 可选压缩指令。 未公开默认值或限制 协议字段 · 能力依型号 |
previous_response_idstring | 可选 | 可选会话续接字段；该型号压缩接口是否接受尚未验证。 未公开默认值或限制 取值待确认 |
toolsarray<object> | 可选 | 可选兼容字段；不保证本型号压缩接口接受。 未公开默认值或限制 取值待确认 |
parallel_tool_callsboolean | 可选 | 可选并行工具字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
reasoning.effortstring | 可选 | 可选推理配置；压缩请求允许等级待确认。 未公开默认值或限制 取值待确认 |
textobject | 可选 | 可选输出格式字段；本型号压缩支持待确认。 未公开默认值或限制 取值待确认 |
- 仅目录元数据声明，未验证本站该精确模型可调用；非普通聊天生成示例。
- 压缩为非流式操作；不添加 stream、messages 或生成 token 参数。
- 压缩输出不是新的 assistant 文本回复；结果结构和可续用性待此型号证实。
Responses 上下文压缩（目录声明） · cURL
curl --request POST 'https://nezhai.vip/v1/responses/compact' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-4.7",
"input": [
{
"role": "user",
"content": "请压缩这段已完成的对话。"
},
{
"role": "assistant",
"content": "保留目标、结论和待办。"
}
]
}'响应示例
{
"protocol": "压缩 output[] / usage（条件支持）；本型号返回结构未验证"
}Anthropic Messages
POST
/v1/messagesContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
anthropic-versionstring请求头 | 必填 | Anthropic 原生协议版本；示例使用 2023-06-01，不代表哪吒逐模型已验证该版本。 未公开默认值或限制 协议字段 · 能力依型号 |
anthropic-betastring请求头 | 可选 | 实验功能版本头；只有明确确认渠道放行时发送。 未公开默认值或限制 协议字段 · 能力依型号 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "grok-4.7" 本站已记录 |
messagesarray<object> | 必填 | 用户/助手消息，不能将 system 塞成 messages 角色。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色。 "user" / "assistant" 协议字段 · 能力依型号 |
messages[].contentstring|array<object> | 必填 | 消息正文；使用内容块可表达 text/image/tool_use/tool_result。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 内容块类型，图片与工具需模型及渠道支持。 "text" / "image" / "tool_use" / "tool_result" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 的文字。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].sourceobject | 可选 | image 的 source：type/base64、media_type、data 或渠道支持的 URL 结构；不保证全部型号视觉能力。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].idstring | 可选 | type=tool_use 的调用 ID。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].namestring | 可选 | type=tool_use 的函数名。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].inputobject | 可选 | type=tool_use 的参数对象；不是 Chat 的 JSON 字符串 arguments。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].tool_use_idstring | 可选 | type=tool_result 时必填，关联先前 tool_use.id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].contentstring|array<object> | 可选 | type=tool_result 的工具结果，通常回填在 user 消息。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].is_errorboolean | 可选 | 工具结果是否为错误。 未公开默认值或限制 协议字段 · 能力依型号 |
systemstring|array<object> | 可选 | 顶层系统指令，使用 text 块时可按渠道支持附 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 必填 | 原生 Messages 必填输出预算；示例 512 仅作客户端选择，不是默认或型号上限。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
streamboolean | 可选 | 省略为非流式；true 返回 Anthropic SSE，条件支持。 默认 false 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 可调性、范围和默认值依精确型号；thinking 模式可能限制。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样，条件支持；部分型号不可与 temperature 共用。 未公开默认值或限制 协议字段 · 能力依型号 |
top_kinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
stop_sequencesarray<string> | 可选 | 停止序列，不是 Chat 的 stop。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 工具声明，需型号/渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].namestring | 可选 | 函数工具名称，使用工具时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].descriptionstring | 可选 | 工具用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].input_schemaobject | 可选 | 工具输入 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choiceobject | 可选 | {type:auto|any|tool|none}；type=tool 时带 name，禁并行用 disable_parallel_tool_use。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.typestring | 可选 | enabled/disabled/adaptive 等取决于型号与渠道，不对全部 Claude/GPT 等统一开放。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.budget_tokensinteger | 可选 | 仅手动 enabled 模式的预算；必须配合 max_tokens，最小值/上限待本站证实。 未公开默认值或限制 协议字段 · 能力依型号 |
thinking.displaystring | 可选 | 推理摘要显示设置；精确型号支持待确认。 未公开默认值或限制 取值待确认 |
output_config.effortstring | 可选 | 自适应推理强度；枚举按精确型号确认，不能从 thinking 后缀猜测。 未公开默认值或限制 取值待确认 |
output_config.formatobject | 可选 | 结构化输出配置，模型/版本/渠道支持待确认；不使用 OpenAI response_format。 未公开默认值或限制 取值待确认 |
messages[].content[].cache_controlobject | 可选 | 提示缓存控制；计费有缓存价格不等于所有块都可 cache_control。 未公开默认值或限制 协议字段 · 能力依型号 |
metadata.user_idstring | 可选 | 应用用户标识，不放敏感信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录声明此兼容协议，不表示非 Anthropic 原生模型具备全部 Claude 特性。
- anthropic-version: 2023-06-01 是请求头示例，不是请求体；鉴权仍用哪吒 Bearer Key。
- 响应读 content[] 与 stop_reason；SSE 为 message_start/content_block_delta/message_stop 等，不是 Chat delta。
- 没有经哪吒逐型号确证的上下文窗口、thinking 枚举或温度默认，不填官方同名参数表。
Anthropic Messages · cURL
curl --request POST 'https://nezhai.vip/v1/messages' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'anthropic-version: 2023-06-01' \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-4.7",
"max_tokens": 512,
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "content[]（text/tool_use 等）、stop_reason、usage"
}Gemini generateContent
POST
/v1beta/models/grok-4.7:generateContentContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring路径 | 必填 | 精确型号位于 URL 路径，不在 JSON body 重复 model。 固定 "grok-4.7" 本站已记录 |
contentsarray<object> | 必填 | 对话内容，不使用 messages 或 Responses input。 最少项数 1 协议字段 · 能力依型号 |
contents[].rolestring | 可选 | 用户消息用 user，助手历史用 model。 "user" / "model" 协议字段 · 能力依型号 |
contents[].partsarray<object> | 必填 | 内容块数组，每块选 text/inlineData/fileData/functionCall/functionResponse 中相应结构。 最少项数 1 协议字段 · 能力依型号 |
contents[].parts[].textstring | 可选 | 文本输入；纯文本最小请求使用此项。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.mimeTypestring | 可选 | 内嵌媒体 MIME；须型号支持对应媒体。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].inlineData.datastring | 可选 | 内嵌媒体纯 base64，不含 data: 前缀。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.fileUristring | 可选 | 外部/文件资源 URI；可访问范围与上传能力未逐型号证实。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].fileData.mimeTypestring | 可选 | fileData 的媒体类型。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionCallobject | 可选 | 助手函数调用 {name,args}，保留 thoughtSignature（若返回）。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].functionResponseobject | 可选 | 工具结果 {name,response:{...}}，不是 role=tool。 未公开默认值或限制 协议字段 · 能力依型号 |
contents[].parts[].thoughtSignaturestring | 可选 | 模型返回的思维签名应原样回填；是否使用取决于型号。 未公开默认值或限制 协议字段 · 能力依型号 |
systemInstruction.parts[].textstring | 可选 | 顶层系统指令文本。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfigobject | 可选 | 可选生成设置；未声明逐型号默认。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.maxOutputTokensinteger | 可选 | 输出 token 预算；没有本站逐型号可用上限。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.temperaturenumber | 可选 | 采样温度，范围与默认值依型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topPnumber | 可选 | 核采样，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.topKinteger | 可选 | 候选截断，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.candidateCountinteger | 可选 | 候选数，条件支持；不推定全站可多候选。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.stopSequencesarray<string> | 可选 | 停止序列。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseMimeTypestring | 可选 | 例如 text/plain 或 application/json；JSON 输出需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseSchemaobject | 可选 | 结构化响应 schema，需 responseMimeType 与渠道支持。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.responseJsonSchemaobject | 可选 | JSON Schema 形式；不要与 responseSchema 同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingBudgetinteger | 可选 | 思考预算，允许值/是否接受依精确型号。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.thinkingLevelstring | 可选 | 思考等级，不能统一套用其他 Gemini 版本枚举。 未公开默认值或限制 协议字段 · 能力依型号 |
generationConfig.thinkingConfig.includeThoughtsboolean | 可选 | 是否返回可见思考摘要；条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarationsarray<object> | 可选 | 工具声明数组，需型号支持。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].namestring | 可选 | 函数名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].functionDeclarations[].parametersobject | 可选 | 函数入参 schema，按 Gemini 支持的 schema 子集。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.modestring | 可选 | 条件支持的 AUTO/ANY/NONE 等调用模式。 未公开默认值或限制 协议字段 · 能力依型号 |
toolConfig.functionCallingConfig.allowedFunctionNamesarray<string> | 可选 | 函数白名单，与调用模式配合使用。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].categorystring | 可选 | 安全分类；可用枚举与可放开程度依渠道。 未公开默认值或限制 协议字段 · 能力依型号 |
safetySettings[].thresholdstring | 可选 | 安全阈值，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
cachedContentstring | 可选 | 显式缓存引用；本站创建/保留缓存能力待确认。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录仅声明 generateContent；不能据此添加 stream:true 或保证 :streamGenerateContent 也可用。
- Gemini 原生流式是另一 action 的 SSE，不是此 JSON body 的 stream 参数。
- 读取 candidates[].content.parts 与 usageMetadata；非原生 Gemini 型号的协议转换能力未逐一验真。
Gemini generateContent · cURL
curl --request POST 'https://nezhai.vip/v1beta/models/grok-4.7:generateContent' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请用一句话介绍哪吒 API。"
}
]
}
]
}'响应示例
{
"protocol": "candidates[].content.parts / finishReason / usageMetadata"
}Alpha Search（目录声明，待补请求契约）
POST
/v1/alpha/searchContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "grok-4.7" 本站已记录 |
idstring | 可选 | 可选请求 ID，精确用途及本型号支持待确认。 未公开默认值或限制 取值待确认 |
- 目前只有目录端点声明，不足以构造完整搜索请求。
- 查询词字段、必填项、过滤条件及返回结构未获哪吒公开确证，因此不编造 query/search 示例。
- 目录有此类型不表示本型号已通过独立搜索验收；不得套普通 Chat 或 Responses body。
参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completionsPOST
/v1/responsesPOST
/v1/responses/compactPOST
/v1/messagesPOST
/v1beta/models/grok-4.7:generateContentPOST
/v1/alpha/search以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价¥0.0225/ 次【生图组】1 个分组
请求参数、示例与计费14 项参数
Grok 图片上游公开契约
Grok 图片生成；仅使用本型号列出的分辨率、数量及编辑能力。
- 参数按完整模型 ID 区分；上游公开值与哪吒已记录的约束分别标注，未进行付费生成验证。
创建图片
POST
/v1/images/generationsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "grok-imagine-image" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
ninteger | 可选 | 提交生成数量；任务或一次响应中实际图片数量另见结果说明。 默认 1；最小 1；最大 10 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "1:1" / "3:4" / "4:3" / "9:16" / "16:9" / "2:3" / "3:2" / "9:19.5" / "19.5:9" / "9:20" / "20:9" / "1:2" / "2:1" / "21:9" / "5:2" / "auto"；默认 "auto" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "1k" / "2k"；默认 "1k" 本站已记录 |
response_formatstring | 可选 | 图片返回 URL 或 Base64；读取对应 data[].url / data[].b64_json。 "url" / "b64_json"；默认 "url" 上游公开契约 |
- 省略可选字段时的服务端行为仅以表中已公开默认值为准。
创建图片 · cURL
curl --request POST 'https://nezhai.vip/v1/images/generations' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-imagine-image",
"prompt": "电影感产品图：柔和自然光，主体清晰，背景简洁。",
"n": 1,
"aspect_ratio": "auto",
"resolution": "1k",
"response_format": "url"
}'结果读取：普通图片读取 data[].url 或 data[].b64_json。MJ 任务保存 id/task_id，完成后读取 result.data.image_urls 与可选 grid_image_url。
JSON 图片编辑
POST
/v1/images/editsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "grok-imagine-image" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
ninteger | 可选 | 提交生成数量；任务或一次响应中实际图片数量另见结果说明。 默认 1；最小 1；最大 10 本站已记录 |
aspect_ratiostring | 可选 | 单图编辑跟随源图比例，省略此字段；多图编辑时才选择输出比例。 "1:1" / "3:4" / "4:3" / "9:16" / "16:9" / "2:3" / "3:2" / "9:19.5" / "19.5:9" / "9:20" / "20:9" / "1:2" / "2:1" / "21:9" / "5:2" / "auto" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "1k" / "2k"；默认 "1k" 本站已记录 |
response_formatstring | 可选 | 图片返回 URL 或 Base64；读取对应 data[].url / data[].b64_json。 "url" / "b64_json"；默认 "url" 上游公开契约 |
imageobject | string | 可选 | 单张源图：公开标准为 {"url":"https://..."}；本站已记录的对接方式使用兼容的 URL 字符串。与 images 二选一。 未公开默认值或限制 协议字段 · 能力依型号 |
imagesarray | 可选 | 多张源图；上游公开对象 {"url":"https://..."} 数组，哪吒兼容 URL 字符串数组。本站上限 3 张，上游新通用说明写 5 张但型号说明仍写 3 张。 最少项数 1；最多项数 3 本站已记录 |
- 必须提供 image 或 images，二选一；编辑请求不能传 quality、mask 或 stream。
- 可在提示词中使用 <IMAGE_0> 等引用源图；单图示例省略 aspect_ratio。
- 上游通用编辑说明与型号说明的最大源图数存在 5 / 3 差异；此处采用哪吒本站 3 张上限。
JSON 图片编辑 · cURL
curl --request POST 'https://nezhai.vip/v1/images/edits' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-imagine-image",
"prompt": "保留主体外形，将背景改为柔和自然光的室内。",
"image": "https://example.com/source.png",
"n": 1
}'结果读取：读取 data[].url 或 data[].b64_json；这是 JSON 编辑入口。
调用入口概览
POST
/v1/images/generationsPOST
/v1/images/edits文生图入口见图片指南。编辑能力、请求格式和尺寸字段因型号而异，不能一律发送 multipart。 参阅图片生成指南。
可选分组
计费
【生图组】¥0.0225 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价¥0.05985/ 次【生图组】1 个分组
请求参数、示例与计费15 项参数
Grok 图片上游公开契约
Grok 图片生成；仅使用本型号列出的分辨率、数量及编辑能力。
- 参数按完整模型 ID 区分；上游公开值与哪吒已记录的约束分别标注，未进行付费生成验证。
创建图片
POST
/v1/images/generationsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "grok-imagine-image-2.0" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
ninteger | 可选 | 提交生成数量；任务或一次响应中实际图片数量另见结果说明。 默认 1；最小 1；最大 10 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "1:1" / "3:4" / "4:3" / "9:16" / "16:9" / "2:3" / "3:2" / "9:19.5" / "19.5:9" / "9:20" / "20:9" / "1:2" / "2:1" / "21:9" / "5:2" / "auto"；默认 "auto" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "1k" / "2k"；默认 "1k" 本站已记录 |
qualitystring | 可选 | 当前操作的生成质量档位；不适用于未列出该字段的编辑操作。 "low" / "medium" / "auto"；默认 "auto" 上游公开契约 |
response_formatstring | 可选 | 图片返回 URL 或 Base64；读取对应 data[].url / data[].b64_json。 "url" / "b64_json"；默认 "url" 上游公开契约 |
- 省略可选字段时的服务端行为仅以表中已公开默认值为准。
创建图片 · cURL
curl --request POST 'https://nezhai.vip/v1/images/generations' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-imagine-image-2.0",
"prompt": "电影感产品图：柔和自然光，主体清晰，背景简洁。",
"n": 1,
"aspect_ratio": "auto",
"resolution": "1k",
"quality": "auto",
"response_format": "url"
}'结果读取：普通图片读取 data[].url 或 data[].b64_json。MJ 任务保存 id/task_id，完成后读取 result.data.image_urls 与可选 grid_image_url。
JSON 图片编辑
POST
/v1/images/editsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "grok-imagine-image-2.0" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
ninteger | 可选 | 提交生成数量；任务或一次响应中实际图片数量另见结果说明。 默认 1；最小 1；最大 10 本站已记录 |
aspect_ratiostring | 可选 | 单图编辑跟随源图比例，省略此字段；多图编辑时才选择输出比例。 "1:1" / "3:4" / "4:3" / "9:16" / "16:9" / "2:3" / "3:2" / "9:19.5" / "19.5:9" / "9:20" / "20:9" / "1:2" / "2:1" / "21:9" / "5:2" / "auto" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "1k" / "2k"；默认 "1k" 本站已记录 |
response_formatstring | 可选 | 图片返回 URL 或 Base64；读取对应 data[].url / data[].b64_json。 "url" / "b64_json"；默认 "url" 上游公开契约 |
imageobject | string | 可选 | 单张源图：公开标准为 {"url":"https://..."}；本站已记录的对接方式使用兼容的 URL 字符串。与 images 二选一。 未公开默认值或限制 协议字段 · 能力依型号 |
imagesarray | 可选 | 多张源图；上游公开对象 {"url":"https://..."} 数组，哪吒兼容 URL 字符串数组。本站上限 3 张，上游新通用说明写 5 张但型号说明仍写 3 张。 最少项数 1；最多项数 3 本站已记录 |
- 必须提供 image 或 images，二选一；编辑请求不能传 quality、mask 或 stream。
- 可在提示词中使用 <IMAGE_0> 等引用源图；单图示例省略 aspect_ratio。
- 上游通用编辑说明与型号说明的最大源图数存在 5 / 3 差异；此处采用哪吒本站 3 张上限。
JSON 图片编辑 · cURL
curl --request POST 'https://nezhai.vip/v1/images/edits' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-imagine-image-2.0",
"prompt": "保留主体外形，将背景改为柔和自然光的室内。",
"image": "https://example.com/source.png",
"n": 1
}'结果读取：读取 data[].url 或 data[].b64_json；这是 JSON 编辑入口。
调用入口概览
POST
/v1/images/generationsPOST
/v1/images/edits文生图入口见图片指南。编辑能力、请求格式和尺寸字段因型号而异，不能一律发送 multipart。 参阅图片生成指南。
可选分组
计费
【生图组】¥0.05985 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价¥0.01077/ 次【生图组】1 个分组
请求参数、示例与计费7 项参数
Grok 图片上游公开契约
Grok 图片生成；仅使用本型号列出的分辨率、数量及编辑能力。
- 参数按完整模型 ID 区分；上游公开值与哪吒已记录的约束分别标注，未进行付费生成验证。
创建图片
POST
/v1/images/generationsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "grok-imagine-image-2.0-文生" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
ninteger | 可选 | 提交生成数量；任务或一次响应中实际图片数量另见结果说明。 默认 1；最小 1；最大 10 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "1:1" / "3:4" / "4:3" / "9:16" / "16:9" / "2:3" / "3:2" / "9:19.5" / "19.5:9" / "9:20" / "20:9" / "1:2" / "2:1" / "21:9" / "5:2" / "auto"；默认 "auto" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "1k"；默认 "1k" 本站已记录 |
qualitystring | 可选 | 当前操作的生成质量档位；不适用于未列出该字段的编辑操作。 "low" / "medium" / "auto"；默认 "auto" 上游公开契约 |
response_formatstring | 可选 | 图片返回 URL 或 Base64；读取对应 data[].url / data[].b64_json。 "url" / "b64_json"；默认 "url" 上游公开契约 |
- 省略可选字段时的服务端行为仅以表中已公开默认值为准。
创建图片 · cURL
curl --request POST 'https://nezhai.vip/v1/images/generations' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-imagine-image-2.0-文生",
"prompt": "电影感产品图：柔和自然光，主体清晰，背景简洁。",
"n": 1,
"aspect_ratio": "auto",
"resolution": "1k",
"quality": "auto",
"response_format": "url"
}'结果读取：普通图片读取 data[].url 或 data[].b64_json。MJ 任务保存 id/task_id，完成后读取 result.data.image_urls 与可选 grid_image_url。
调用入口概览
POST
/v1/images/generations文生图入口见图片指南。编辑能力、请求格式和尺寸字段因型号而异，不能一律发送 multipart。 参阅图片生成指南。
可选分组
计费
【生图组】¥0.01077 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价按公式计费1 个分组
请求参数、示例与计费10 项参数
Grok 视频上游公开契约
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 14 项，仍须同时满足各类单独上限。
- 单图使用 image，多图使用 images；两者二选一，不传通用 reference_images。最多 14 张参考图。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "grok-imagine-video" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 8；最小 4；最大 15 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "1:1" / "16:9" / "9:16" / "4:3" / "3:4" / "3:2" / "2:3"；默认 "16:9" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 上游取值已公开，未声明已执行全部约束校验。 "480p" / "720p"；默认 "480p" 本站已记录 |
imagestring | 可选 | 单张参考图片；与 images 二选一。JSON 字符串可为公网 URL，内联图片是否可用依本型号。 未公开默认值或限制 上游公开契约 |
imagesarray | 可选 | 参考图片数组；与 image 二选一，数量遵守此型号上限。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 14 本站已记录 |
ninteger | 可选 | 提交生成数量；任务或一次响应中实际图片数量另见结果说明。 固定 1 上游公开契约 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-imagine-video",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 8,
"aspect_ratio": "16:9",
"resolution": "480p",
"n": 1
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按公式计费1 个分组
请求参数、示例与计费10 项参数
Grok 视频上游公开契约
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 14 项，仍须同时满足各类单独上限。
- 单图使用 image，多图使用 images；两者二选一，不传通用 reference_images。最多 14 张参考图。
- 带参考图最高 720p；上游说明 1080p 会降到 720p，但本站客户端会拒绝该组合，调用时直接选择 720p。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "grok-imagine-video-1.5" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 8；最小 4；最大 15 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "1:1" / "16:9" / "9:16" / "4:3" / "3:4" / "3:2" / "2:3"；默认 "16:9" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 上游取值已公开，未声明已执行全部约束校验。 "480p" / "720p" / "1080p"；默认 "480p" 本站已记录 |
imagestring | 可选 | 单张参考图片；与 images 二选一。JSON 字符串可为公网 URL，内联图片是否可用依本型号。 未公开默认值或限制 上游公开契约 |
imagesarray | 可选 | 参考图片数组；与 image 二选一，数量遵守此型号上限。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 14 本站已记录 |
ninteger | 可选 | 提交生成数量；任务或一次响应中实际图片数量另见结果说明。 固定 1 上游公开契约 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-imagine-video-1.5",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 8,
"aspect_ratio": "16:9",
"resolution": "480p",
"n": 1
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
kimi-k2.6
按公式计费1 个分组
请求参数、示例与计费42 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "kimi-k2.6" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "kimi-k2.6",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}调用入口概览
POST
/v1/chat/completions以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
kimi-k2.7-code
按公式计费1 个分组
请求参数、示例与计费42 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "kimi-k2.7-code" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "kimi-k2.7-code",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completions以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
kimi-k3
按公式计费1 个分组
请求参数、示例与计费42 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
- 同名上游数值仅以 unconfirmed 文字旁证显示，不写为本站参数默认或硬上限。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "kimi-k3" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 同名上游元数据（不是哪吒保证）={"min":1,"max":131072,"documentation":{"values_confirmed":false,"constraints_enforced":false,"exclusion_confirmed":false}}；本站此参数默认值/枚举/上限未验证。 未公开默认值或限制 取值待确认 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "kimi-k3",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}参数依据：哪吒定价目录：精确 ID 与 supported_endpoint_types 2026-10-24 · 哪吒公开接入说明 2026-10-24 · 第三方同名文本元数据：仅待确认旁证 2026-10-23.001
调用入口概览
POST
/v1/chat/completions以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价视频生成
kling-video-v3
按公式计费1 个分组
请求参数、示例与计费10 项参数
可灵视频上游公开契约
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 9 项，仍须同时满足各类单独上限。
- 本站已记录的对接方式素材使用 reference_images/reference_videos/reference_audios；通用参考时长字段是 referenceVideoDurations，线路七使用 reference_video_durations。
- 首帧、参考图模式按本型号列出的字段选择；型号说明不支持尾帧，不继承其他可灵版本的尾帧或音频能力。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "kling-video-v3" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 5；最小 3；最大 15 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "16:9" / "9:16" / "1:1"；默认 "16:9" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "720p" / "1080p" / "4k"；默认 "720p" 本站已记录 |
reference_imagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_images，上游目录字段为 referenceImages。 最少项数 0；最多项数 9 本站已记录 |
first_frame_urlstring | 可选 | 首帧图片公网 URL；与参考素材的互斥规则以此型号说明为准。 未公开默认值或限制 上游公开契约 |
last_frame_urlstring | 可选 | 尾帧图片公网 URL；是否必须与首帧成对填写以此型号说明为准。 型号说明明确不支持尾帧，与上游结构字段冲突，请勿提交。 未公开默认值或限制 取值待确认 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-video-v3",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按公式计费1 个分组
请求参数、示例与计费12 项参数
可灵视频上游公开契约
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 12 项，仍须同时满足各类单独上限。
- 参考视频需逐条提供正数时长并与数组顺序对应，累计不超过 15 秒。
- 本站已记录的对接方式素材使用 reference_images/reference_videos/reference_audios；通用参考时长字段是 referenceVideoDurations，线路七使用 reference_video_durations。
- 首帧、参考图模式按本型号列出的字段选择；型号说明不支持尾帧，不继承其他可灵版本的尾帧或音频能力。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "kling-video-v3-omni" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
referenceVideoDurationsarray | 可选 | 参考视频的逐条时长数组，单位秒，与视频数组按索引对应；本站客户端发送时使用正数，是否必须声明与总时长限制见此型号说明。 数组元素类型：number。 最多项数 3 本站已记录 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 5；最小 3；最大 15 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "16:9" / "9:16" / "1:1"；默认 "16:9" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "720p" / "1080p" / "4k"；默认 "720p" 本站已记录 |
reference_imagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_images，上游目录字段为 referenceImages。 最少项数 0；最多项数 9 本站已记录 |
reference_videosarray | 可选 | 参考视频 URL 数组；同时满足条数、总时长及逐条时长声明要求。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_videos，上游目录字段为 referenceVideos。 最少项数 0；最多项数 3 本站已记录 |
first_frame_urlstring | 可选 | 首帧图片公网 URL；与参考素材的互斥规则以此型号说明为准。 未公开默认值或限制 上游公开契约 |
last_frame_urlstring | 可选 | 尾帧图片公网 URL；是否必须与首帧成对填写以此型号说明为准。 型号说明明确不支持尾帧，与上游结构字段冲突，请勿提交。 未公开默认值或限制 取值待确认 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-video-v3-omni",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按公式计费1 个分组
请求参数、示例与计费10 项参数
可灵视频上游公开契约
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 9 项，仍须同时满足各类单独上限。
- 本站已记录的对接方式素材使用 reference_images/reference_videos/reference_audios；通用参考时长字段是 referenceVideoDurations，线路七使用 reference_video_durations。
- 首帧、参考图模式按本型号列出的字段选择；型号说明不支持尾帧，不继承其他可灵版本的尾帧或音频能力。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "kling-video-v3-turbo" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 5；最小 3；最大 15 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "16:9" / "9:16" / "1:1"；默认 "16:9" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "720p" / "1080p"；默认 "720p" 本站已记录 |
reference_imagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_images，上游目录字段为 referenceImages。 最少项数 0；最多项数 9 本站已记录 |
first_frame_urlstring | 可选 | 首帧图片公网 URL；与参考素材的互斥规则以此型号说明为准。 未公开默认值或限制 上游公开契约 |
last_frame_urlstring | 可选 | 尾帧图片公网 URL；是否必须与首帧成对填写以此型号说明为准。 型号说明明确不支持尾帧，与上游结构字段冲突，请勿提交。 未公开默认值或限制 取值待确认 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-video-v3-turbo",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价视频生成
kling-video-v4
按公式计费1 个分组
请求参数、示例与计费13 项参数
可灵视频上游公开契约
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 15 项，仍须同时满足各类单独上限。
- 参考视频需逐条提供正数时长并与数组顺序对应，累计不超过 15 秒。
- 本站已记录的对接方式素材使用 reference_images/reference_videos/reference_audios；通用参考时长字段是 referenceVideoDurations，线路七使用 reference_video_durations。
- 上游现在列 5 段参考视频、合计 30 秒，本站已登记上限仍为 3 段、合计 15 秒；此处采用本站限制。尾帧字段虽被上游结构列出，但型号文字明确不支持，不作为可用能力。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "kling-video-v4" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
referenceVideoDurationsarray | 可选 | 参考视频的逐条时长数组，单位秒，与视频数组按索引对应；本站客户端发送时使用正数，是否必须声明与总时长限制见此型号说明。 数组元素类型：number。 此处采用哪吒已记录的限制；上游原始取值另保留在机器数据的 upstream_parameter 中。 最多项数 3 本站已记录 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 5；最小 3；最大 30 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "16:9" / "9:16" / "1:1" / "21:9"；默认 "16:9" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "720p" / "1080p"；默认 "720p" 本站已记录 |
reference_imagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_images，上游目录字段为 referenceImages。 最少项数 0；最多项数 10 本站已记录 |
reference_videosarray | 可选 | 参考视频 URL 数组；同时满足条数、总时长及逐条时长声明要求。 数组元素类型：string；格式：public-http-url。 此处采用哪吒已记录的限制；上游原始取值另保留在机器数据的 upstream_parameter 中。 哪吒请求字段为 reference_videos，上游目录字段为 referenceVideos。 最少项数 0；最多项数 3 本站已记录 |
reference_audiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_audios，上游目录字段为 referenceAudios。 最少项数 0；最多项数 3 本站已记录 |
first_frame_urlstring | 可选 | 首帧图片公网 URL；与参考素材的互斥规则以此型号说明为准。 未公开默认值或限制 上游公开契约 |
last_frame_urlstring | 可选 | 尾帧图片公网 URL；是否必须与首帧成对填写以此型号说明为准。 上游型号说明明确不支持尾帧，与结构字段存在冲突，请勿提交。 未公开默认值或限制 取值待确认 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "kling-video-v4",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
minimax-m3
按公式计费1 个分组
请求参数、示例与计费42 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "minimax-m3" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "minimax-m3",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}调用入口概览
POST
/v1/chat/completions以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价视频生成
minimax_h3
按公式计费1 个分组
请求参数、示例与计费12 项参数
MiniMax H3上游公开契约
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 12 项，仍须同时满足各类单独上限。
- 参考视频需逐条提供正数时长并与数组顺序对应，累计不超过 15 秒。
- 本站已记录的对接方式素材使用 reference_images/reference_videos/reference_audios；通用参考时长字段是 referenceVideoDurations，线路七使用 reference_video_durations。
- 2K / 4K 必须至少提供一种参考素材；本站分辨率枚举为 768/1080p/2K/4K，上游新列的 480p 未计入本站能力。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "minimax_h3" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
prompt_enhanceboolean | 可选 | 是否使用本型号的提示词增强；未公开默认值时按需传入。 未公开默认值或限制 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 4；最小 4；最大 15 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "21:9" / "16:9" / "4:3" / "1:1" / "3:4" / "9:16"；默认 "16:9" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 此处采用哪吒已记录的限制；上游原始取值另保留在机器数据的 upstream_parameter 中。 "768" / "1080p" / "2K" / "4K"；默认 "768" 本站已记录 |
reference_imagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_images，上游目录字段为 referenceImages。 最少项数 0；最多项数 9 本站已记录 |
reference_videosarray | 可选 | 参考视频 URL 数组；同时满足条数、总时长及逐条时长声明要求。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_videos，上游目录字段为 referenceVideos。 最少项数 0；最多项数 3 本站已记录 |
referenceVideoDurationsarray | 可选 | 参考视频的逐条时长数组，单位秒，与视频数组按索引对应；本站客户端发送时使用正数，是否必须声明与总时长限制见此型号说明。 数组元素类型：number。 最少项数 0；最多项数 3 本站已记录 |
reference_audiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_audios，上游目录字段为 referenceAudios。 最少项数 0；最多项数 3 本站已记录 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "minimax_h3",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 4,
"aspect_ratio": "16:9",
"resolution": "768"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价文本生成
muse-spark-1.3
按公式计费1 个分组
请求参数、示例与计费42 项参数
文本与多模态协议字段 · 能力依型号
精确型号的声明协议与条件支持字段；不是上游官方同名能力表。
- 此型号按当前目录声明展开：openai；未声明的协议不自动开放。
- protocol 字段只解释线格式；工具、采样、推理、多模态、缓存、上下文窗口、token 上限和渠道默认均需精确型号证据。
- GET /v1/models 是令牌可见目录，无 messages/input；GET /api/pricing 是公共定价/协议声明。两者都不是模型生成测试。
- Responses 的 input/max_output_tokens/text.format 与 Chat 的 messages/max_completion_tokens/response_format 不可混用。
- 只列此 ID 声明的协议，不给 openai-only 型号增开 Responses/Anthropic/Gemini。compact/alpha-search 尤其标为元数据未验证。
- 未执行任何付费推理；不把 billing_usage_schema 当成请求字段或能力来源。
OpenAI 兼容 Chat Completions
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "muse-spark-1.3" 本站已记录 |
messagesarray<object> | 必填 | 有序对话；不使用 Responses 的 input。至少一条消息。 最少项数 1 协议字段 · 能力依型号 |
messages[].rolestring | 必填 | 消息角色；developer/system 可否使用取决于模型。 "system" / "developer" / "user" / "assistant" / "tool" 协议字段 · 能力依型号 |
messages[].contentstring|array<object>|null | 必填 | 普通消息必填文本或内容块；assistant 仅含 tool_calls 时可为 null。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].typestring | 可选 | 使用内容块时必填。text 为文本；image_url/input_audio/file 仅在模型与渠道明确支持时可用。 "text" / "image_url" / "input_audio" / "file" 协议字段 · 能力依型号 |
messages[].content[].textstring | 可选 | type=text 时必填。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.urlstring | 可选 | type=image_url 时的图片 URL 或 data URI；图片数量、大小与视觉能力未逐模型确认。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].content[].image_url.detailstring | 可选 | 图片细节等级，条件支持。 "auto" / "low" / "high" 协议字段 · 能力依型号 |
messages[].namestring | 可选 | 可选消息发送者名称。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_call_idstring | 可选 | role=tool 时必填，对应先前 assistant.tool_calls[].id。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_callsarray<object> | 可选 | 回填 assistant 工具调用记录，须保留 id/type/function。 未公开默认值或限制 协议字段 · 能力依型号 |
messages[].tool_calls[].function.argumentsstring | 可选 | JSON 编码字符串，不是直接嵌套对象。 未公开默认值或限制 协议字段 · 能力依型号 |
streamboolean | 可选 | 协议省略时为非流式；true 返回 SSE；模型/渠道是否支持流式另验。 默认 false 协议字段 · 能力依型号 |
stream_options.include_usageboolean | 可选 | 仅在 stream=true 且渠道支持时请求流末 usage。 未公开默认值或限制 协议字段 · 能力依型号 |
max_tokensinteger | 可选 | 兼容旧聊天输出上限；没有哪吒逐模型上限证据。推理模型可能要求 max_completion_tokens；不同时设置。 未公开默认值或限制 协议字段 · 能力依型号 |
max_completion_tokensinteger | 可选 | 聊天补全的生成预算，含可能的推理 token；不是 Responses 的 max_output_tokens。不推定模型上限。 未公开默认值或限制 协议字段 · 能力依型号 |
temperaturenumber | 可选 | 采样温度；可用范围、默认值及是否可调均依模型，不套官方同名上限。 未公开默认值或限制 协议字段 · 能力依型号 |
top_pnumber | 可选 | 核采样；条件支持，通常不与 temperature 同时调整。 未公开默认值或限制 协议字段 · 能力依型号 |
stopstring|array<string> | 可选 | 停止序列；推理模型可能不支持，数量上限未证实。 未公开默认值或限制 协议字段 · 能力依型号 |
ninteger | 可选 | 聊天候选数；支持与默认值未逐模型确认，最小示例不发送。 未公开默认值或限制 协议字段 · 能力依型号 |
frequency_penaltynumber | 可选 | 频率惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
presence_penaltynumber | 可选 | 存在惩罚，条件支持；无本站逐模型范围证据。 未公开默认值或限制 协议字段 · 能力依型号 |
seedinteger | 可选 | 条件支持的随机种子，不保证完全可复现。 未公开默认值或限制 协议字段 · 能力依型号 |
reasoning_effortstring | 可选 | 推理强度；可选枚举依精确型号/渠道，不能把某 GPT 的等级复制给全部文本模型。 未公开默认值或限制 协议字段 · 能力依型号 |
toolsarray<object> | 可选 | 条件支持的工具声明；Chat 使用嵌套 function 对象，与 Responses 扁平 function 工具不同。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].typestring | 可选 | 普通函数工具使用 function。 "function" 协议字段 · 能力依型号 |
tools[].function.namestring | 可选 | 函数工具必填名称。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.descriptionstring | 可选 | 函数用途。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.parametersobject | 可选 | 函数入参 JSON Schema；例如 {type:object,properties:{...},required:[...]}。 未公开默认值或限制 协议字段 · 能力依型号 |
tools[].function.strictboolean | 可选 | 严格函数参数 schema；条件支持，不设本站统一默认。 未公开默认值或限制 协议字段 · 能力依型号 |
tool_choicestring|object | 可选 | 可选 none/auto/required，或 {type:function,function:{name:...}}；仅在支持工具调用时使用。 未公开默认值或限制 协议字段 · 能力依型号 |
parallel_tool_callsboolean | 可选 | 允许同轮多函数调用；模型及转换链路须支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_formatobject | 可选 | 聊天结构化输出对象；并非 Responses 的 text.format。条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.typestring | 可选 | text/json_object/json_schema，支持级别依模型。 "text" / "json_object" / "json_schema" 协议字段 · 能力依型号 |
response_format.json_schema.namestring | 可选 | type=json_schema 时的 schema 名称。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.schemaobject | 可选 | type=json_schema 时的 JSON Schema。 未公开默认值或限制 协议字段 · 能力依型号 |
response_format.json_schema.strictboolean | 可选 | 严格结构化输出，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
logprobsboolean | 可选 | 是否返回 token 概率，条件支持。 未公开默认值或限制 协议字段 · 能力依型号 |
top_logprobsinteger | 可选 | 需 logprobs=true；上限依模型。 未公开默认值或限制 协议字段 · 能力依型号 |
storeboolean | 可选 | 上游保存选项；实际是否转发依渠道，不承诺全站默认。 未公开默认值或限制 协议字段 · 能力依型号 |
metadataobject | 可选 | 可选应用元数据；不放 API Key 或敏感个人信息。 未公开默认值或限制 协议字段 · 能力依型号 |
- 目录 openai 只声明此协议入口，不证明所有可选参数、视觉或工具能力可用。
- Chat 返回 choices[].message / SSE choices[].delta；不能按 Responses.output 解析。
- 示例是非计费执行的协议构造，不表示本次已调用该模型。
OpenAI 兼容 Chat Completions · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "muse-spark-1.3",
"messages": [
{
"role": "user",
"content": "请用一句话介绍哪吒 API。"
}
],
"stream": false
}'响应示例
{
"protocol": "choices[].message.content；流式 choices[].delta，usage 视渠道返回"
}调用入口概览
POST
/v1/chat/completions以上为公开定价元数据声明的端点类型，具体能力和请求体以对应模型协议为准。 参阅文本生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价视频生成
S-2.0-903-线路四
¥4/ 次【生图组】1 个分组
请求参数、示例与计费9 项参数
Seedance 视频上游公开契约
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 12 项，仍须同时满足各类单独上限。
- 本站已记录的对接方式素材使用 reference_images/reference_videos/reference_audios；通用参考时长字段是 referenceVideoDurations，线路七使用 reference_video_durations。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "S-2.0-903-线路四" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 4；最小 4；最大 15 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "16:9" / "9:16"；默认 "16:9" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 固定 "720p"；"720p" 本站已记录 |
reference_imagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_images，上游目录字段为 referenceImages。 最少项数 0；最多项数 9 本站已记录 |
reference_audiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_audios，上游目录字段为 referenceAudios。 最少项数 0；最多项数 3 本站已记录 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "S-2.0-903-线路四",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 4,
"aspect_ratio": "16:9",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
【生图组】¥4 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价视频生成
S-2.0-933-竖屏-线路三
¥3.2/ 次【生图组】1 个分组
请求参数、示例与计费11 项参数
Seedance 视频上游公开契约
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 15 项，仍须同时满足各类单独上限。
- 本站已记录的对接方式素材使用 reference_images/reference_videos/reference_audios；通用参考时长字段是 referenceVideoDurations，线路七使用 reference_video_durations。
- 此完整型号不支持首尾帧模式。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "S-2.0-933-竖屏-线路三" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 4；最小 4；最大 15 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "9:16"；默认 "9:16" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 固定 "720p"；"720p" 本站已记录 |
reference_imagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_images，上游目录字段为 referenceImages。 最少项数 0；最多项数 9 本站已记录 |
reference_videosarray | 可选 | 参考视频 URL 数组；同时满足条数、总时长及逐条时长声明要求。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_videos，上游目录字段为 referenceVideos。 最少项数 0；最多项数 3 本站已记录 |
reference_audiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_audios，上游目录字段为 referenceAudios。 最少项数 0；最多项数 3 本站已记录 |
referenceVideoDurationsarray | 可选 | 参考视频的逐条时长数组，单位秒，与视频数组按索引对应；本站客户端发送时使用正数，是否必须声明与总时长限制见此型号说明。 最少项数 0；最多项数 3 协议字段 · 能力依型号 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "S-2.0-933-竖屏-线路三",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 4,
"aspect_ratio": "9:16",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
【生图组】¥3.2 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价视频生成
S-2.0-933-线路四
按公式计费1 个分组
请求参数、示例与计费11 项参数
Seedance 视频本站已记录
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 15 项，仍须同时满足各类单独上限。
- 本站已记录的对接方式素材使用 reference_images/reference_videos/reference_audios；通用参考时长字段是 referenceVideoDurations，线路七使用 reference_video_durations。
- 当前上游机器目录未收录此完整 ID；参数来自已记录的同 ID 型号卡及哪吒精确适配，不借用 903 或其他线路。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "S-2.0-933-线路四" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 本站已记录 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 5；最小 5；最大 15 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "16:9" / "9:16"；默认 "16:9" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 固定 "720p"；"720p" 本站已记录 |
reference_imagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 哪吒请求字段为 reference_images，上游目录字段为 referenceImages。 最少项数 0；最多项数 9 本站已记录 |
reference_videosarray | 可选 | 参考视频 URL 数组；同时满足条数、总时长及逐条时长声明要求。 哪吒请求字段为 reference_videos，上游目录字段为 referenceVideos。 最少项数 0；最多项数 3 本站已记录 |
reference_audiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 哪吒请求字段为 reference_audios，上游目录字段为 referenceAudios。 最少项数 0；最多项数 3 本站已记录 |
referenceVideoDurationsarray | 可选 | 参考视频的逐条时长数组，单位秒，与视频数组按索引对应；本站客户端发送时使用正数，是否必须声明与总时长限制见此型号说明。 最少项数 0；最多项数 3 协议字段 · 能力依型号 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "S-2.0-933-线路四",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价按公式计费1 个分组
请求参数、示例与计费11 项参数
Seedance 视频上游公开契约
视频异步任务；当前按上游公开的此完整型号契约列出，本站透传行为待确认。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 此完整 ID 暂无可核对的本站精确适配条目；创建参数与驼峰素材字段按上游公开契约展示，哪吒透传及服务端执行规则待确认。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "S-2.0-fast-稳定满血-线路三" 上游公开契约 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
enable_audioboolean | 可选 | 是否启用生成音轨；这是本型号上游公开字段，不能当作其他型号的通用参数。 默认 true 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 4；最小 4；最大 15 上游公开契约 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "16:9" / "9:16"；默认 "16:9" 上游公开契约 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "480p" / "720p"；默认 "720p" 上游公开契约 |
referenceImagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 9 上游公开契约 |
referenceVideosarray | 可选 | 参考视频 URL 数组；同时满足条数、总时长及逐条时长声明要求。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 3 上游公开契约 |
referenceAudiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 3 上游公开契约 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "S-2.0-fast-稳定满血-线路三",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 4,
"aspect_ratio": "16:9",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价视频生成
S-2.0-稳定满血-线路三
按公式计费1 个分组
请求参数、示例与计费11 项参数
Seedance 视频上游公开契约
视频异步任务；当前按上游公开的此完整型号契约列出，本站透传行为待确认。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 此完整 ID 暂无可核对的本站精确适配条目；创建参数与驼峰素材字段按上游公开契约展示，哪吒透传及服务端执行规则待确认。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "S-2.0-稳定满血-线路三" 上游公开契约 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
enable_audioboolean | 可选 | 是否启用生成音轨；这是本型号上游公开字段，不能当作其他型号的通用参数。 默认 true 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 4；最小 4；最大 15 上游公开契约 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "16:9" / "9:16"；默认 "16:9" 上游公开契约 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "480p" / "720p"；默认 "720p" 上游公开契约 |
referenceImagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 9 上游公开契约 |
referenceVideosarray | 可选 | 参考视频 URL 数组；同时满足条数、总时长及逐条时长声明要求。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 3 上游公开契约 |
referenceAudiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 3 上游公开契约 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "S-2.0-稳定满血-线路三",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 4,
"aspect_ratio": "16:9",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价视频生成
S-2.0-高码率480
¥3.5/ 次【生图组】1 个分组
请求参数、示例与计费9 项参数
Seedance 视频上游公开契约
视频异步任务；当前按上游公开的此完整型号契约列出，本站透传行为待确认。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 此完整 ID 暂无可核对的本站精确适配条目；创建参数与驼峰素材字段按上游公开契约展示，哪吒透传及服务端执行规则待确认。
- 固定 480p；最多 9 张图片与 3 段音频，合计 12 项，不支持参考视频。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "S-2.0-高码率480" 上游公开契约 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 15；最小 4；最大 15 上游公开契约 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "21:9" / "16:9" / "4:3" / "1:1" / "3:4" / "9:16"；默认 "16:9" 上游公开契约 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 固定 "480p"；"480p" 上游公开契约 |
referenceImagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 9 上游公开契约 |
referenceAudiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 3 上游公开契约 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "S-2.0-高码率480",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 15,
"aspect_ratio": "16:9",
"resolution": "480p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
【生图组】¥3.5 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价¥2.1/ 次【生图组】1 个分组
请求参数、示例与计费11 项参数
Seedance 视频上游公开契约
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 15 项，仍须同时满足各类单独上限。
- 本站已记录的对接方式素材使用 reference_images/reference_videos/reference_audios；通用参考时长字段是 referenceVideoDurations，线路七使用 reference_video_durations。
- 此完整型号不支持首尾帧模式。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "S-2.0mini-933-竖屏-线路三" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 4；最小 4；最大 15 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "9:16"；默认 "9:16" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 固定 "720p"；"720p" 本站已记录 |
reference_imagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_images，上游目录字段为 referenceImages。 最少项数 0；最多项数 9 本站已记录 |
reference_videosarray | 可选 | 参考视频 URL 数组；同时满足条数、总时长及逐条时长声明要求。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_videos，上游目录字段为 referenceVideos。 最少项数 0；最多项数 3 本站已记录 |
reference_audiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_audios，上游目录字段为 referenceAudios。 最少项数 0；最多项数 3 本站已记录 |
referenceVideoDurationsarray | 可选 | 参考视频的逐条时长数组，单位秒，与视频数组按索引对应；本站客户端发送时使用正数，是否必须声明与总时长限制见此型号说明。 最少项数 0；最多项数 3 协议字段 · 能力依型号 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "S-2.0mini-933-竖屏-线路三",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 4,
"aspect_ratio": "9:16",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
【生图组】¥2.1 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价视频生成
S-2.0mini-线路五
¥1.6/ 次【生图组】1 个分组
请求参数、示例与计费9 项参数
Seedance 视频上游公开契约
视频异步任务；当前按上游公开的此完整型号契约列出，本站透传行为待确认。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 此完整 ID 暂无可核对的本站精确适配条目；创建参数与驼峰素材字段按上游公开契约展示，哪吒透传及服务端执行规则待确认。
- 固定 720p；最多 3 张图片与 1 段音频，合计 4 项，不支持参考视频。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "S-2.0mini-线路五" 上游公开契约 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 15；最小 4；最大 15 上游公开契约 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "21:9" / "16:9" / "4:3" / "1:1" / "3:4" / "9:16"；默认 "16:9" 上游公开契约 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 固定 "720p"；"720p" 上游公开契约 |
referenceImagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 3 上游公开契约 |
referenceAudiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 1 上游公开契约 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "S-2.0mini-线路五",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 15,
"aspect_ratio": "16:9",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
【生图组】¥1.6 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价视频生成
S-2.0稳定-903-线路十
¥4.3/ 次【生图组】1 个分组
请求参数、示例与计费9 项参数
Seedance 视频上游公开契约
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 12 项，仍须同时满足各类单独上限。
- 本站已记录的对接方式素材使用 reference_images/reference_videos/reference_audios；通用参考时长字段是 referenceVideoDurations，线路七使用 reference_video_durations。
- 此完整型号不支持首尾帧模式。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "S-2.0稳定-903-线路十" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 此处采用哪吒已记录的限制；上游原始取值另保留在机器数据的 upstream_parameter 中。 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15；默认 15；最小 5；最大 15 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "16:9" / "9:16" / "1:1" / "4:3"；默认 "16:9" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 固定 "720p"；"720p" 本站已记录 |
reference_imagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_images，上游目录字段为 referenceImages。 最少项数 0；最多项数 9 本站已记录 |
reference_audiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_audios，上游目录字段为 referenceAudios。 最少项数 0；最多项数 3 本站已记录 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "S-2.0稳定-903-线路十",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 15,
"aspect_ratio": "16:9",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
【生图组】¥4.3 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价视频生成
S-2.5-满血-线路九
¥5/ 次【生图组】1 个分组
请求参数、示例与计费10 项参数
Seedance 视频上游公开契约
视频异步任务；当前按上游公开的此完整型号契约列出，本站透传行为待确认。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 此完整 ID 暂无可核对的本站精确适配条目；创建参数与驼峰素材字段按上游公开契约展示，哪吒透传及服务端执行规则待确认。
- 此完整型号不支持首尾帧模式。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "S-2.5-满血-线路九" 上游公开契约 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 10；最小 10；最大 30 上游公开契约 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "21:9" / "16:9" / "4:3" / "1:1" / "3:4" / "9:16"；默认 "16:9" 上游公开契约 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 固定 "720p"；"720p" 上游公开契约 |
referenceImagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 30 上游公开契约 |
referenceVideosarray | 可选 | 参考视频 URL 数组；同时满足条数、总时长及逐条时长声明要求。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 10 上游公开契约 |
referenceAudiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 10 上游公开契约 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "S-2.5-满血-线路九",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 10,
"aspect_ratio": "16:9",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
【生图组】¥5 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价视频生成
S-2.5-满血-线路十一
按公式计费1 个分组
请求参数、示例与计费11 项参数
Seedance 视频上游公开契约
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 50 项，仍须同时满足各类单独上限。
- 本站已记录的对接方式素材使用 reference_images/reference_videos/reference_audios；通用参考时长字段是 referenceVideoDurations，线路七使用 reference_video_durations。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "S-2.5-满血-线路十一" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1；最多字符 16000 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 30；最小 4；最大 30 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "adaptive" / "21:9" / "16:9" / "4:3" / "1:1" / "3:4" / "9:16"；默认 "16:9" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 固定 "720p"；"720p" 本站已记录 |
reference_imagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_images，上游目录字段为 referenceImages。 最少项数 0；最多项数 30 本站已记录 |
reference_videosarray | 可选 | 参考视频 URL 数组；同时满足条数、总时长及逐条时长声明要求。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_videos，上游目录字段为 referenceVideos。 最少项数 0；最多项数 10 本站已记录 |
reference_audiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_audios，上游目录字段为 referenceAudios。 最少项数 0；最多项数 10 本站已记录 |
referenceVideoDurationsarray | 可选 | 参考视频的逐条时长数组，单位秒，与视频数组按索引对应；本站客户端发送时使用正数，是否必须声明与总时长限制见此型号说明。 最少项数 0；最多项数 10 协议字段 · 能力依型号 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "S-2.5-满血-线路十一",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 30,
"aspect_ratio": "16:9",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价视频生成
S-2.5-满血按次-线路十一
¥5.5/ 次【生图组】1 个分组
请求参数、示例与计费10 项参数
Seedance 视频上游公开契约
线路十一按次视频：整数 4–30 秒、默认 30 秒，固定 720p；最多 30 图、10 视频、10 音频，合计 50 项。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 50 项，仍须同时满足各类单独上限。
- 本站当前公开接入说明：时长为整数 4–30 秒，默认 30 秒，固定 720p；旧上游固定 30 秒的说明不适用。
- 素材使用 referenceImages/referenceVideos/referenceAudios，合计最多 50 项；单图、双图均按普通参考处理，不自动转为首尾帧。
- 提示词必填且最多 16000 个 UTF-16 代码单元。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "S-2.5-满血按次-线路十一" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最多 16000 个 UTF-16 代码单元。 最少字符 1；最多字符 16000 本站已记录 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 30；最小 4；最大 30 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "adaptive" / "21:9" / "16:9" / "4:3" / "1:1" / "3:4" / "9:16"；默认 "16:9" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 固定 "720p"；"720p" 本站已记录 |
referenceImagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 30 本站已记录 |
referenceVideosarray | 可选 | 参考视频 URL 数组；同时满足条数、总时长及逐条时长声明要求。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 10 本站已记录 |
referenceAudiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 10 本站已记录 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "S-2.5-满血按次-线路十一",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 30,
"aspect_ratio": "16:9",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
【生图组】¥5.5 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价视频生成
S-2.5-满血稳定-线路七
按公式计费1 个分组
请求参数、示例与计费13 项参数
Seedance 视频上游公开契约
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 50 项，仍须同时满足各类单独上限。
- 参考视频需逐条提供正数时长并与数组顺序对应，累计不超过 15 秒。
- 本站已记录的对接方式素材使用 reference_images/reference_videos/reference_audios；通用参考时长字段是 referenceVideoDurations，线路七使用 reference_video_durations。
- 首尾帧必须成对出现，且不得与参考图片、视频、音频同时使用；纯参考模式的单张图片应放 reference_images。
- 本站线路七可省略参考视频时长声明；若提供则按索引对应、每项为正数，累计不超过 15 秒。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "S-2.5-满血稳定-线路七" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 4；最小 4；最大 30 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "16:9" / "9:16" / "1:1"；默认 "16:9" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "480p" / "720p" / "1080p"；默认 "720p" 本站已记录 |
reference_imagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 上游标记了互斥规则；具体组合按此型号操作说明。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_images，上游目录字段为 referenceImages。 最少项数 0；最多项数 30 本站已记录 |
reference_videosarray | 可选 | 参考视频 URL 数组；同时满足条数、总时长及逐条时长声明要求。 上游标记了互斥规则；具体组合按此型号操作说明。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_videos，上游目录字段为 referenceVideos。 最少项数 0；最多项数 10 本站已记录 |
reference_video_durationsarray | 可选 | 参考视频的逐条时长数组，单位秒，与视频数组按索引对应；本站客户端发送时使用正数，是否必须声明与总时长限制见此型号说明。 数组元素类型：number。 最少项数 0；最多项数 10 本站已记录 |
reference_audiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 上游标记了互斥规则；具体组合按此型号操作说明。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_audios，上游目录字段为 referenceAudios。 最少项数 0；最多项数 10 本站已记录 |
first_frame_urlstring | 可选 | 首帧图片公网 URL；与参考素材的互斥规则以此型号说明为准。 上游标记了互斥规则；具体组合按此型号操作说明。 未公开默认值或限制 上游公开契约 |
last_frame_urlstring | 可选 | 尾帧图片公网 URL；是否必须与首帧成对填写以此型号说明为准。 上游标记了互斥规则；具体组合按此型号操作说明。 未公开默认值或限制 上游公开契约 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "S-2.5-满血稳定-线路七",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 4,
"aspect_ratio": "16:9",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价视频生成
S-2.5-稳定满血-线路三
按公式计费1 个分组
请求参数、示例与计费11 项参数
Seedance 视频上游公开契约
视频异步任务；当前按上游公开的此完整型号契约列出，本站透传行为待确认。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 此完整 ID 暂无可核对的本站精确适配条目；创建参数与驼峰素材字段按上游公开契约展示，哪吒透传及服务端执行规则待确认。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "S-2.5-稳定满血-线路三" 上游公开契约 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
enable_audioboolean | 可选 | 是否启用生成音轨；这是本型号上游公开字段，不能当作其他型号的通用参数。 默认 true 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 4；最小 4；最大 30 上游公开契约 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "16:9" / "9:16"；默认 "16:9" 上游公开契约 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "480p" / "720p" / "1080p"；默认 "720p" 上游公开契约 |
referenceImagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 30 上游公开契约 |
referenceVideosarray | 可选 | 参考视频 URL 数组；同时满足条数、总时长及逐条时长声明要求。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 10 上游公开契约 |
referenceAudiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 最少项数 0；最多项数 10 上游公开契约 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "S-2.5-稳定满血-线路三",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 4,
"aspect_ratio": "16:9",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价视频生成
S-2.5满血-线路五
按公式计费1 个分组
图片生成
seedream-5.0
¥0.10773/ 次【生图组】1 个分组
请求参数、示例与计费10 项参数
Seedream上游公开契约
Seedream 图片生成；参考图数量采用当前结构化参数中已确认的更小上限。
- 参数按完整模型 ID 区分；上游公开值与哪吒已记录的约束分别标注，未进行付费生成验证。
- 创建与参考图生成均用 application/json；单张参考图用 image，多张用 images，两者二选一。
- resolution 选择档位，size 填比例。示例按本站实际字段生成，原上游示例与参数标志保存在机器数据中。
- 上游当前结构化 images 上限为 10，旧文字与本站配置写 14；当前表采用更小的上游 10 张限制，同时保留原始元数据。
创建图片
POST
/v1/images/generationsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "seedream-5.0" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "1k" / "2k"；默认 "1k" 本站已记录 |
sizestring | 可选 | 图片画幅比例；本页 JSON 图片示例使用比例字符串，与 resolution 分开设置。 上游取值已公开，未声明已执行全部约束校验。 此处采用哪吒已记录的限制；上游原始取值另保留在机器数据的 upstream_parameter 中。 "auto" / "1:1" / "3:2" / "2:3" / "4:3" / "3:4" / "5:4" / "4:5" / "16:9" / "9:16" / "21:9" / "9:21" / "2:1" / "1:2" / "3:1" / "1:3" 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "auto" / "1:1" / "3:2" / "2:3" / "4:3" / "3:4" / "5:4" / "4:5" / "16:9" / "9:16" / "2:1" / "1:2" / "3:1" / "1:3" / "21:9" / "9:21"；默认 "auto" 本站已记录 |
aspectRatiostring | 可选 | 上游公开的兼容比例别名；优先使用本页示例中的规范字段。 "auto" / "1:1" / "3:2" / "2:3" / "4:3" / "3:4" / "5:4" / "4:5" / "16:9" / "9:16" / "2:1" / "1:2" / "3:1" / "1:3" / "21:9" / "9:21" 本站已记录 |
ratiostring | 可选 | 上游公开的兼容比例别名；与其他比例字段择一填写。 "auto" / "1:1" / "3:2" / "2:3" / "4:3" / "3:4" / "5:4" / "4:5" / "16:9" / "9:16" / "2:1" / "1:2" / "3:1" / "1:3" / "21:9" / "9:21" 本站已记录 |
imagestring | 可选 | 单张参考图片；与 images 二选一。JSON 字符串可为公网 URL，内联图片是否可用依本型号。 未公开默认值或限制 上游公开契约 |
imagesarray | 可选 | 参考图片数组；与 image 二选一，数量遵守此型号上限。 数组元素类型：string；格式：uri-or-data-image。 最少项数 1；最多项数 10 本站已记录 |
ninteger | 可选 | 提交生成数量；任务或一次响应中实际图片数量另见结果说明。 此处采用哪吒已记录的限制；上游原始取值另保留在机器数据的 upstream_parameter 中。 固定 1；最小 1；最大 1 本站已记录 |
- 省略可选字段时的服务端行为仅以表中已公开默认值为准。
创建图片 · cURL
curl --request POST 'https://nezhai.vip/v1/images/generations' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "seedream-5.0",
"prompt": "电影感产品图：柔和自然光，主体清晰，背景简洁。",
"resolution": "1k",
"size": "16:9",
"n": 1
}'结果读取：普通图片读取 data[].url 或 data[].b64_json。MJ 任务保存 id/task_id，完成后读取 result.data.image_urls 与可选 grid_image_url。
调用入口概览
POST
/v1/images/generations文生图入口见图片指南。编辑能力、请求格式和尺寸字段因型号而异，不能一律发送 multipart。 参阅图片生成指南。
可选分组
计费
【生图组】¥0.10773 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价音频生成
suno-v5
¥0.28/ 次【生图组】2 个分组
请求参数、示例与计费8 项参数
Suno 音乐本站已记录
当前 Suno 五版本：文本描述或纯音乐，按实际返回段数保存。
- 只使用完整版本 ID；旧 suno 已关闭，不能回退到无版本别名。
- 不再接受旧 lyrics/style_text，不展示歌词或风格独立字段；3000 UTF-16 是消息合并上限。
- 返回几段就保存几段，不固定两首，也不以 n=1 丢弃第二段。
- 无时长、声线、参考图/音频输入契约；不要把文本 Chat 的 temperature/tools/max_tokens 参数复制到 Suno。
- 本次未执行付费音乐生成。
创建音乐（非流式）
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "suno-v5" 本站已记录 |
messagesarray<object> | 必填 | 1–32 条文本消息；合并文本总长最多 3000 UTF-16 code units，不是字节数。 最少项数 1；最多项数 32 本站已记录 |
messages[].rolestring | 必填 | 当前示例使用 user；其他角色的精确白名单未在最新哪吒说明列全。 未公开默认值或限制 本站已记录 |
messages[].contentstring | 必填 | 纯文本音乐描述；不支持图像、音频附件或多模态内容块。 未公开默认值或限制 本站已记录 |
ninteger | 可选 | 请求次数固定 1；不等于返回音轨必定一段。 固定 1 本站已记录 |
streamboolean | 可选 | 不支持流式；true 会被拒绝，显式 false。 固定 false 本站已记录 |
instrumentalboolean | 可选 | 可选纯音乐开关；true 表示纯音乐。未获得独立服务端默认值证据。 未公开默认值或限制 本站已记录 |
- 通过 choices[].message.content 读取实际音乐结果；不要对可返回段数作硬编码。
- 全部 messages.content 合并后验 UTF-16 长度；emoji 常占两个 code units。
创建音乐（非流式） · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "suno-v5",
"messages": [
{
"role": "user",
"content": "轻快的钢琴与吉他背景音乐，适合清晨散步。"
}
],
"instrumental": true,
"n": 1,
"stream": false
}'响应示例
{
"documented": "Chat 兼容内容承载音轨链接/描述；返回音轨数量可变，逐个提取保存"
}调用入口概览
POST
/v1/chat/completions调用入口与 Suno 指南一致；使用非流式文本消息。 参阅音频生成指南。
可选分组
计费
【生图组】¥0.28 / 次
音频生成¥0.28 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价音频生成
suno-v5.5
¥0.28/ 次音频生成2 个分组
请求参数、示例与计费8 项参数
Suno 音乐本站已记录
当前 Suno 五版本：文本描述或纯音乐，按实际返回段数保存。
- 只使用完整版本 ID；旧 suno 已关闭，不能回退到无版本别名。
- 不再接受旧 lyrics/style_text，不展示歌词或风格独立字段；3000 UTF-16 是消息合并上限。
- 返回几段就保存几段，不固定两首，也不以 n=1 丢弃第二段。
- 无时长、声线、参考图/音频输入契约；不要把文本 Chat 的 temperature/tools/max_tokens 参数复制到 Suno。
- 本次未执行付费音乐生成。
创建音乐（非流式）
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "suno-v5.5" 本站已记录 |
messagesarray<object> | 必填 | 1–32 条文本消息；合并文本总长最多 3000 UTF-16 code units，不是字节数。 最少项数 1；最多项数 32 本站已记录 |
messages[].rolestring | 必填 | 当前示例使用 user；其他角色的精确白名单未在最新哪吒说明列全。 未公开默认值或限制 本站已记录 |
messages[].contentstring | 必填 | 纯文本音乐描述；不支持图像、音频附件或多模态内容块。 未公开默认值或限制 本站已记录 |
ninteger | 可选 | 请求次数固定 1；不等于返回音轨必定一段。 固定 1 本站已记录 |
streamboolean | 可选 | 不支持流式；true 会被拒绝，显式 false。 固定 false 本站已记录 |
instrumentalboolean | 可选 | 可选纯音乐开关；true 表示纯音乐。未获得独立服务端默认值证据。 未公开默认值或限制 本站已记录 |
- 通过 choices[].message.content 读取实际音乐结果；不要对可返回段数作硬编码。
- 全部 messages.content 合并后验 UTF-16 长度；emoji 常占两个 code units。
创建音乐（非流式） · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "suno-v5.5",
"messages": [
{
"role": "user",
"content": "轻快的钢琴与吉他背景音乐，适合清晨散步。"
}
],
"instrumental": true,
"n": 1,
"stream": false
}'响应示例
{
"documented": "Chat 兼容内容承载音轨链接/描述；返回音轨数量可变，逐个提取保存"
}调用入口概览
POST
/v1/chat/completions调用入口与 Suno 指南一致；使用非流式文本消息。 参阅音频生成指南。
可选分组
计费
【生图组】¥0.28 / 次
音频生成¥0.28 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价音频生成
suno-v6
¥0.28/ 次音频生成2 个分组
请求参数、示例与计费8 项参数
Suno 音乐本站已记录
当前 Suno 五版本：文本描述或纯音乐，按实际返回段数保存。
- 只使用完整版本 ID；旧 suno 已关闭，不能回退到无版本别名。
- 不再接受旧 lyrics/style_text，不展示歌词或风格独立字段；3000 UTF-16 是消息合并上限。
- 返回几段就保存几段，不固定两首，也不以 n=1 丢弃第二段。
- 无时长、声线、参考图/音频输入契约；不要把文本 Chat 的 temperature/tools/max_tokens 参数复制到 Suno。
- 本次未执行付费音乐生成。
创建音乐（非流式）
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "suno-v6" 本站已记录 |
messagesarray<object> | 必填 | 1–32 条文本消息；合并文本总长最多 3000 UTF-16 code units，不是字节数。 最少项数 1；最多项数 32 本站已记录 |
messages[].rolestring | 必填 | 当前示例使用 user；其他角色的精确白名单未在最新哪吒说明列全。 未公开默认值或限制 本站已记录 |
messages[].contentstring | 必填 | 纯文本音乐描述；不支持图像、音频附件或多模态内容块。 未公开默认值或限制 本站已记录 |
ninteger | 可选 | 请求次数固定 1；不等于返回音轨必定一段。 固定 1 本站已记录 |
streamboolean | 可选 | 不支持流式；true 会被拒绝，显式 false。 固定 false 本站已记录 |
instrumentalboolean | 可选 | 可选纯音乐开关；true 表示纯音乐。未获得独立服务端默认值证据。 未公开默认值或限制 本站已记录 |
- 通过 choices[].message.content 读取实际音乐结果；不要对可返回段数作硬编码。
- 全部 messages.content 合并后验 UTF-16 长度；emoji 常占两个 code units。
创建音乐（非流式） · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "suno-v6",
"messages": [
{
"role": "user",
"content": "轻快的钢琴与吉他背景音乐，适合清晨散步。"
}
],
"instrumental": true,
"n": 1,
"stream": false
}'响应示例
{
"documented": "Chat 兼容内容承载音轨链接/描述；返回音轨数量可变，逐个提取保存"
}调用入口概览
POST
/v1/chat/completions调用入口与 Suno 指南一致；使用非流式文本消息。 参阅音频生成指南。
可选分组
计费
【生图组】¥0.28 / 次
音频生成¥0.28 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价音频生成
suno-v6-mini
¥0.28/ 次音频生成2 个分组
请求参数、示例与计费8 项参数
Suno 音乐本站已记录
当前 Suno 五版本：文本描述或纯音乐，按实际返回段数保存。
- 只使用完整版本 ID；旧 suno 已关闭，不能回退到无版本别名。
- 不再接受旧 lyrics/style_text，不展示歌词或风格独立字段；3000 UTF-16 是消息合并上限。
- 返回几段就保存几段，不固定两首，也不以 n=1 丢弃第二段。
- 无时长、声线、参考图/音频输入契约；不要把文本 Chat 的 temperature/tools/max_tokens 参数复制到 Suno。
- 本次未执行付费音乐生成。
创建音乐（非流式）
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "suno-v6-mini" 本站已记录 |
messagesarray<object> | 必填 | 1–32 条文本消息；合并文本总长最多 3000 UTF-16 code units，不是字节数。 最少项数 1；最多项数 32 本站已记录 |
messages[].rolestring | 必填 | 当前示例使用 user；其他角色的精确白名单未在最新哪吒说明列全。 未公开默认值或限制 本站已记录 |
messages[].contentstring | 必填 | 纯文本音乐描述；不支持图像、音频附件或多模态内容块。 未公开默认值或限制 本站已记录 |
ninteger | 可选 | 请求次数固定 1；不等于返回音轨必定一段。 固定 1 本站已记录 |
streamboolean | 可选 | 不支持流式；true 会被拒绝，显式 false。 固定 false 本站已记录 |
instrumentalboolean | 可选 | 可选纯音乐开关；true 表示纯音乐。未获得独立服务端默认值证据。 未公开默认值或限制 本站已记录 |
- 通过 choices[].message.content 读取实际音乐结果；不要对可返回段数作硬编码。
- 全部 messages.content 合并后验 UTF-16 长度；emoji 常占两个 code units。
创建音乐（非流式） · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "suno-v6-mini",
"messages": [
{
"role": "user",
"content": "轻快的钢琴与吉他背景音乐，适合清晨散步。"
}
],
"instrumental": true,
"n": 1,
"stream": false
}'响应示例
{
"documented": "Chat 兼容内容承载音轨链接/描述；返回音轨数量可变，逐个提取保存"
}调用入口概览
POST
/v1/chat/completions调用入口与 Suno 指南一致；使用非流式文本消息。 参阅音频生成指南。
可选分组
计费
【生图组】¥0.28 / 次
音频生成¥0.28 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价音频生成
suno-v6-wild
¥0.28/ 次音频生成2 个分组
请求参数、示例与计费8 项参数
Suno 音乐本站已记录
当前 Suno 五版本：文本描述或纯音乐，按实际返回段数保存。
- 只使用完整版本 ID；旧 suno 已关闭，不能回退到无版本别名。
- 不再接受旧 lyrics/style_text，不展示歌词或风格独立字段；3000 UTF-16 是消息合并上限。
- 返回几段就保存几段，不固定两首，也不以 n=1 丢弃第二段。
- 无时长、声线、参考图/音频输入契约；不要把文本 Chat 的 temperature/tools/max_tokens 参数复制到 Suno。
- 本次未执行付费音乐生成。
创建音乐（非流式）
POST
/v1/chat/completionsContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "suno-v6-wild" 本站已记录 |
messagesarray<object> | 必填 | 1–32 条文本消息；合并文本总长最多 3000 UTF-16 code units，不是字节数。 最少项数 1；最多项数 32 本站已记录 |
messages[].rolestring | 必填 | 当前示例使用 user；其他角色的精确白名单未在最新哪吒说明列全。 未公开默认值或限制 本站已记录 |
messages[].contentstring | 必填 | 纯文本音乐描述；不支持图像、音频附件或多模态内容块。 未公开默认值或限制 本站已记录 |
ninteger | 可选 | 请求次数固定 1；不等于返回音轨必定一段。 固定 1 本站已记录 |
streamboolean | 可选 | 不支持流式；true 会被拒绝，显式 false。 固定 false 本站已记录 |
instrumentalboolean | 可选 | 可选纯音乐开关；true 表示纯音乐。未获得独立服务端默认值证据。 未公开默认值或限制 本站已记录 |
- 通过 choices[].message.content 读取实际音乐结果；不要对可返回段数作硬编码。
- 全部 messages.content 合并后验 UTF-16 长度；emoji 常占两个 code units。
创建音乐（非流式） · cURL
curl --request POST 'https://nezhai.vip/v1/chat/completions' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "suno-v6-wild",
"messages": [
{
"role": "user",
"content": "轻快的钢琴与吉他背景音乐，适合清晨散步。"
}
],
"instrumental": true,
"n": 1,
"stream": false
}'响应示例
{
"documented": "Chat 兼容内容承载音轨链接/描述；返回音轨数量可变，逐个提取保存"
}调用入口概览
POST
/v1/chat/completions调用入口与 Suno 指南一致；使用非流式文本消息。 参阅音频生成指南。
可选分组
计费
【生图组】¥0.28 / 次
音频生成¥0.28 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价视频生成
wan3.0-prime-线路八
按公式计费1 个分组
请求参数、示例与计费13 项参数
WAN 视频上游公开契约
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 20 项，仍须同时满足各类单独上限。
- 参考视频需逐条提供正数时长并与数组顺序对应，累计不超过 15 秒。
- 本站已记录的对接方式素材使用 reference_images/reference_videos/reference_audios；通用参考时长字段是 referenceVideoDurations，线路七使用 reference_video_durations。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "wan3.0-prime-线路八" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 5；最小 2；最大 30 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "adaptive" / "21:9" / "16:9" / "4:3" / "1:1" / "3:4" / "9:16"；默认 "16:9" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "480p" / "720p" / "1080p"；默认 "720p" 本站已记录 |
reference_imagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_images，上游目录字段为 referenceImages。 最少项数 0；最多项数 10 本站已记录 |
reference_videosarray | 可选 | 参考视频 URL 数组；同时满足条数、总时长及逐条时长声明要求。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_videos，上游目录字段为 referenceVideos。 最少项数 0；最多项数 5 本站已记录 |
referenceVideoDurationsarray | 可选 | 参考视频的逐条时长数组，单位秒，与视频数组按索引对应；本站客户端发送时使用正数，是否必须声明与总时长限制见此型号说明。 数组元素类型：number。 最少项数 0；最多项数 5 本站已记录 |
reference_audiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_audios，上游目录字段为 referenceAudios。 最少项数 0；最多项数 5 本站已记录 |
first_frame_urlstring | 可选 | 首帧图片公网 URL；与参考素材的互斥规则以此型号说明为准。 未公开默认值或限制 上游公开契约 |
last_frame_urlstring | 可选 | 尾帧图片公网 URL；是否必须与首帧成对填写以此型号说明为准。 未公开默认值或限制 上游公开契约 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan3.0-prime-线路八",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价视频生成
wan3.0-特惠
¥3/ 次【生图组】1 个分组
请求参数、示例与计费11 项参数
WAN 视频上游公开契约
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 20 项，仍须同时满足各类单独上限。
- 参考视频需逐条提供正数时长并与数组顺序对应，累计不超过 15 秒。
- 本站已记录的对接方式素材使用 reference_images/reference_videos/reference_audios；通用参考时长字段是 referenceVideoDurations，线路七使用 reference_video_durations。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "wan3.0-特惠" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 5；最小 4；最大 30 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "9:16" / "16:9" / "1:1" / "3:4" / "4:3"；默认 "16:9" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "480p" / "720p" / "1080p"；默认 "1080p" 本站已记录 |
reference_imagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_images，上游目录字段为 referenceImages。 最少项数 0；最多项数 10 本站已记录 |
reference_videosarray | 可选 | 参考视频 URL 数组；同时满足条数、总时长及逐条时长声明要求。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_videos，上游目录字段为 referenceVideos。 最少项数 0；最多项数 5 本站已记录 |
reference_audiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_audios，上游目录字段为 referenceAudios。 最少项数 0；最多项数 5 本站已记录 |
referenceVideoDurationsarray | 可选 | 参考视频的逐条时长数组，单位秒，与视频数组按索引对应；本站客户端发送时使用正数，是否必须声明与总时长限制见此型号说明。 最少项数 0；最多项数 5 协议字段 · 能力依型号 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan3.0-特惠",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 5,
"aspect_ratio": "16:9",
"resolution": "1080p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
【生图组】¥3 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价视频生成
wan3.0-线路八
按公式计费1 个分组
请求参数、示例与计费13 项参数
WAN 视频上游公开契约
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 所有参考图片、视频、音频合计最多 20 项，仍须同时满足各类单独上限。
- 参考视频需逐条提供正数时长并与数组顺序对应，累计不超过 15 秒。
- 本站已记录的对接方式素材使用 reference_images/reference_videos/reference_audios；通用参考时长字段是 referenceVideoDurations，线路七使用 reference_video_durations。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "wan3.0-线路八" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 默认 5；最小 2；最大 30 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "adaptive" / "21:9" / "16:9" / "4:3" / "1:1" / "3:4" / "9:16"；默认 "16:9" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 "480p" / "720p" / "1080p"；默认 "720p" 本站已记录 |
reference_imagesarray | 可选 | 参考图片 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_images，上游目录字段为 referenceImages。 最少项数 0；最多项数 10 本站已记录 |
reference_videosarray | 可选 | 参考视频 URL 数组；同时满足条数、总时长及逐条时长声明要求。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_videos，上游目录字段为 referenceVideos。 最少项数 0；最多项数 5 本站已记录 |
referenceVideoDurationsarray | 可选 | 参考视频的逐条时长数组，单位秒，与视频数组按索引对应；本站客户端发送时使用正数，是否必须声明与总时长限制见此型号说明。 数组元素类型：number。 最少项数 0；最多项数 5 本站已记录 |
reference_audiosarray | 可选 | 参考音频 URL 数组；地址须在异步任务读取期间保持公网可访问。 数组元素类型：string；格式：public-http-url。 哪吒请求字段为 reference_audios，上游目录字段为 referenceAudios。 最少项数 0；最多项数 5 本站已记录 |
first_frame_urlstring | 可选 | 首帧图片公网 URL；与参考素材的互斥规则以此型号说明为准。 未公开默认值或限制 上游公开契约 |
last_frame_urlstring | 可选 | 尾帧图片公网 URL；是否必须与首帧成对填写以此型号说明为准。 未公开默认值或限制 上游公开契约 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan3.0-线路八",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价视频生成
wan3.0（1080特价）
¥7.83/ 次【生图组】1 个分组
请求参数、示例与计费13 项参数
WAN 1080P本站已记录
本站独立 WAN1080：4–30 秒，固定 1080p，公网参考素材 10/5/5。
- 精确 ID 含全角括号；不要替换成第三方 wan3.0-prime、wan3.0-线路八 或 wan3.0-特惠。
- 固定 1080p，按次计费；duration_seconds 仍是请求时长，不因计费式为按次而忽略 4–30 秒限制。
- 参考图最多 10、视频最多 5、音频最多 5；不能套第三方线路八的总数/15秒素材约束。总数、素材字节及素材时长上限没有独立证据。
- 素材必须是服务可读取的公网 URL；不发送本地路径、multipart、data URI、内部地址。纯音频参考不允许，需至少一张参考图或一个参考视频。
- 一次创建后以原 task_id 轮询；超时先查任务，禁止盲目补发创建。
- 历史十图测试仅证明当时上游 200→completed/1920×1080，不代替本站当前全链路验收；本次未调用。
创建 WAN1080 视频
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "wan3.0（1080特价）" 本站已记录 |
promptstring | 必填 | 视频文字描述；本站此精确型号长度上限未单独确认。 未公开默认值或限制 本站已记录 |
duration_secondsinteger | 可选 | 输出视频时长（秒）。 默认 5；最小 4；最大 30 本站已记录 |
resolutionstring | 可选 | 固定 1080p。 固定 "1080p" 本站已记录 |
aspect_ratiostring | 可选 | 画幅比，省略默认 16:9。 "16:9" / "9:16" / "1:1" / "4:3" / "3:4"；默认 "16:9" 本站已记录 |
reference_imagesarray<string> | 可选 | 可选公网图片 URL，最多 10 张。 最多项数 10 本站已记录 |
reference_videosarray<string> | 可选 | 可选公网视频 URL，最多 5 段。 最多项数 5 本站已记录 |
reference_audiosarray<string> | 可选 | 可选公网音频 URL，最多 5 段；不能成为唯一参考类型。 最多项数 5 本站已记录 |
- 提交得到任务 ID 后查询；reference_images/videos/audios 为 snake_case，不套线路十一 camelCase。
创建 WAN1080 视频 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan3.0（1080特价）",
"prompt": "镜头缓缓推进，清晨山谷云雾流动。",
"duration_seconds": 5,
"resolution": "1080p",
"aspect_ratio": "16:9"
}'响应示例
{
"documented": "异步任务；保存返回 id/task_id，按实际 status 查询 completed/failed"
}查询原视频任务
GET
/v1/videos/{task_id}Content-Type: none
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
task_idstring路径 | 必填 | 创建响应的原始任务 ID。 未公开默认值或限制 本站已记录 |
- 不发 model 或重新创建请求；请求体为空。
查询原视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{task_id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"documented": "任务状态与实际输出信息"
}读取已完成视频
GET
/v1/videos/{task_id}/contentContent-Type: none
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
task_idstring路径 | 必填 | 已完成任务的原始任务 ID。 未公开默认值或限制 本站已记录 |
- 先确认任务完成；按实际返回下载内容或跟随允许的下载响应。
读取已完成视频 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{task_id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin响应示例
{
"documented": "视频内容/下载响应，按实际响应头处理"
}调用入口概览
POST
/v1/videosGET
/v1/videos/{task_id}GET
/v1/videos/{task_id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
【生图组】¥7.83 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价视频生成
可灵3.0-特惠
¥1.3/ 次【生图组】1 个分组
请求参数、示例与计费11 项参数
可灵视频上游公开契约
视频异步任务；创建参数遵守本站已记录的型号限制，完成后查询并下载结果。
- 视频任务创建后保存 id/task_id，通过 /v1/videos/{id} 查询；参数不从图片或其他视频线路继承。
- 本页示例使用平铺 JSON。上游 video.v1 的 version/operation/media_inputs/options 为兼容信封，不与平铺素材字段混填。
- 本站已记录的对接方式素材使用 reference_images/reference_videos/reference_audios；通用参考时长字段是 referenceVideoDurations，线路七使用 reference_video_durations。
- 只支持可选的一张 first_frame_url，不支持尾帧、普通参考图数组、参考视频或音频。
- multi_prompt 为 2–6 段，每段含 prompt 与 duration，duration 至少 1 秒，总计不超过 15 秒。
创建视频任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
modelstring | 必填 | 哪吒目录中的完整模型 ID，按原文填写。 固定 "可灵3.0-特惠" 本站已记录 |
promptstring | 必填 | 描述主体、场景、构图、动作及需要保留或修改的内容。 最少字符 1 上游公开契约 |
duration_secondsinteger | 可选 | 输出视频时长，单位秒；按此型号的整数范围或固定值填写。 1 / 2 / 3 / 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15；默认 5；最小 1；最大 15 本站已记录 |
aspect_ratiostring | 可选 | 输出画面比例；与同义比例字段择一填写。 "16:9" / "9:16"；默认 "16:9" 本站已记录 |
resolutionstring | 可选 | 输出分辨率档位，大小写和拼写按此型号枚举填写。 固定 "720p"；"720p" 本站已记录 |
first_frame_urlstring | 可选 | 首帧图片公网 URL；与参考素材的互斥规则以此型号说明为准。 未公开默认值或限制 上游公开契约 |
multi_promptarray | 可选 | 故事板分段对象数组；2–6 段，每段至少 1 秒，各段时长合计不超过 15 秒。 数组元素类型：object。 最少项数 2；最多项数 6 上游公开契约 |
negative_promptstring | 可选 | 描述应避免出现的内容。 未公开默认值或限制 上游公开契约 |
ninteger | 可选 | 提交生成数量；任务或一次响应中实际图片数量另见结果说明。 固定 1 上游公开契约 |
- 参考素材必须能被异步任务从公网读取；URL 不要在受理后立即失效。
- 兼容信封的原始请求示例保存在 upstream_documentation，本页平铺示例不混用 media_inputs。
创建视频任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "可灵3.0-特惠",
"prompt": "让画面中的主体自然运动，镜头保持平稳。",
"duration_seconds": 5,
"aspect_ratio": "16:9",
"resolution": "720p",
"n": 1
}'结果读取：受理响应保存 id 或 task_id，查询终态后读取输出 URL；请求成功受理不等于视频已完成。
查询视频任务
GET
/v1/videos/{id}Content-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
查询视频任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"id": "video_123",
"status": "completed",
"outputs": [
{
"content_url": "https://example.com/result.webm"
}
]
}结果读取：状态一般为 queued / in_progress / completed / failed；完成后读取 outputs[].content_url 或 download_url，或使用 content 下载入口。
下载视频结果
GET
/v1/videos/{id}/contentContent-Type: 无请求体
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
idstring路径 | 必填 | 创建视频返回的 id 或 task_id，按原值保存。 未公开默认值或限制 协议字段 · 能力依型号 |
- 下载前先确认任务完成；以真实响应 Content-Type 和文件签名判断格式，不能仅凭任务元数据 mime_type=video/mp4 假定 MP4。
下载视频结果 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin调用入口概览
POST
/v1/videosGET
/v1/videos/{id}GET
/v1/videos/{id}/content视频任务入口见视频指南；参数以精确型号支持范围为准。 参阅视频生成指南。
可选分组
计费
【生图组】¥1.3 / 次
实付 = 按次基础价 × 分组倍率；保留最多 5 位小数。不同 Key 可选分组不同。图片单次产物数量依型号而异，不将所有图片请求都视为单张。
查看完整定价视频生成
视频超分（字节）
按公式计费1 个分组
请求参数、示例与计费9 项参数
视频超分本站已记录
视频超分异步任务：一条公网参考视频，1–600 秒，按此型号选择输出分辨率。
- 本站视频任务协议已核对：JSON POST /v1/videos；超分不发送 prompt。
- reference_videos 必须恰好一条公网 HTTP(S) 视频 URL，不是 multipart 文件、本地路径或 data URI。
- 标准支持 720p/1080p/2k/4k；字节不支持 720p。两者 duration_seconds 为整数 1–600，省略默认 5；resolution 省略默认 1080p。
- 本型号按处理秒数计费；请求时长与计费用量属于不同层级，实际费用以本站当前价格和最终用量为准。
- 只创建一次并保存任务 id；超时先查询原任务，失败状态保留 error.message。
- 请求契约有实现与模拟验收依据；本次没有发起新的付费超分，Key 权限和当前上游可用性仍以实际响应为准。
创建视频超分任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "视频超分（字节）" 本站已记录 |
duration_secondsinteger | 可选 | 待处理视频时长，单位秒；不接受小数。 默认 5；最小 1；最大 600 本站已记录 |
resolutionstring | 可选 | 输出分辨率；字节型号无 720p。 "1080p" / "2k" / "4k"；默认 "1080p" 本站已记录 |
reference_videosarray<string> | 必填 | 必须恰好一个服务可访问的公网 HTTP(S) 视频 URL。 最少项数 1；最多项数 1 本站已记录 |
- 把 example.com 占位替换为你可公开访问的真实视频地址。
- 不发送 prompt、aspect_ratio、reference_images、reference_audios 或任意上游 metadata。
创建视频超分任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "视频超分（字节）",
"duration_seconds": 5,
"resolution": "1080p",
"reference_videos": [
"https://example.com/reference.mp4"
]
}'响应示例
{
"documented": "{id,status}；status 为 queued/processing/completed/failed；成功附 video_url，失败附 error.message"
}查询原超分任务
GET
/v1/videos/{task_id}Content-Type: none
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
task_idstring路径 | 必填 | 创建响应的原始任务 id。 未公开默认值或限制 本站已记录 |
- GET 无 body；保留原始任务 ID，不要再次创建来代替查询。
查询原超分任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{task_id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"documented": "id/status/video_url 或 error.message"
}下载已完成的超分视频
GET
/v1/videos/{task_id}/contentContent-Type: none
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
task_idstring路径 | 必填 | 已完成超分任务的原始 id。 未公开默认值或限制 本站已记录 |
- 任务 completed 后下载；若响应已有 video_url，按实际返回下载地址处理。
- GET 无 body，下载保存二进制视频。
下载已完成的超分视频 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{task_id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin响应示例
{
"documented": "视频内容或下载响应"
}调用入口概览
POST
/v1/videosGET
/v1/videos/{task_id}GET
/v1/videos/{task_id}/content超分与视频任务共用创建、查询和下载入口；创建仅接收一条公网参考视频，无需 prompt。 参阅视频生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价视频生成
视频超分（标准）
按公式计费1 个分组
请求参数、示例与计费9 项参数
视频超分本站已记录
视频超分异步任务：一条公网参考视频，1–600 秒，按此型号选择输出分辨率。
- 本站视频任务协议已核对：JSON POST /v1/videos；超分不发送 prompt。
- reference_videos 必须恰好一条公网 HTTP(S) 视频 URL，不是 multipart 文件、本地路径或 data URI。
- 标准支持 720p/1080p/2k/4k；字节不支持 720p。两者 duration_seconds 为整数 1–600，省略默认 5；resolution 省略默认 1080p。
- 本型号按处理秒数计费；请求时长与计费用量属于不同层级，实际费用以本站当前价格和最终用量为准。
- 只创建一次并保存任务 id；超时先查询原任务，失败状态保留 error.message。
- 请求契约有实现与模拟验收依据；本次没有发起新的付费超分，Key 权限和当前上游可用性仍以实际响应为准。
创建视频超分任务
POST
/v1/videosContent-Type: application/json
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
modelstring | 必填 | 保留本条精确模型 ID；不使用上游别名或自动降级。 固定 "视频超分（标准）" 本站已记录 |
duration_secondsinteger | 可选 | 待处理视频时长，单位秒；不接受小数。 默认 5；最小 1；最大 600 本站已记录 |
resolutionstring | 可选 | 输出分辨率；字节型号无 720p。 "720p" / "1080p" / "2k" / "4k"；默认 "1080p" 本站已记录 |
reference_videosarray<string> | 必填 | 必须恰好一个服务可访问的公网 HTTP(S) 视频 URL。 最少项数 1；最多项数 1 本站已记录 |
- 把 example.com 占位替换为你可公开访问的真实视频地址。
- 不发送 prompt、aspect_ratio、reference_images、reference_audios 或任意上游 metadata。
创建视频超分任务 · cURL
curl --request POST 'https://nezhai.vip/v1/videos' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "视频超分（标准）",
"duration_seconds": 5,
"resolution": "1080p",
"reference_videos": [
"https://example.com/reference.mp4"
]
}'响应示例
{
"documented": "{id,status}；status 为 queued/processing/completed/failed；成功附 video_url，失败附 error.message"
}查询原超分任务
GET
/v1/videos/{task_id}Content-Type: none
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
task_idstring路径 | 必填 | 创建响应的原始任务 id。 未公开默认值或限制 本站已记录 |
- GET 无 body；保留原始任务 ID，不要再次创建来代替查询。
查询原超分任务 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{task_id}' \
--header "Authorization: Bearer $NEZHA_API_KEY"响应示例
{
"documented": "id/status/video_url 或 error.message"
}下载已完成的超分视频
GET
/v1/videos/{task_id}/contentContent-Type: none
| 参数 / 类型 | 必填 | 说明 / 取值 / 默认值 |
|---|---|---|
Authorizationstring请求头 | 必填 | 使用哪吒 API Key：Bearer <NEZHA_API_KEY>；不是上游平台 Key。 未公开默认值或限制 本站已记录 |
task_idstring路径 | 必填 | 已完成超分任务的原始 id。 未公开默认值或限制 本站已记录 |
- 任务 completed 后下载；若响应已有 video_url，按实际返回下载地址处理。
- GET 无 body，下载保存二进制视频。
下载已完成的超分视频 · cURL
curl --request GET 'https://nezhai.vip/v1/videos/{task_id}/content' \
--header "Authorization: Bearer $NEZHA_API_KEY" \
--location --output result.bin响应示例
{
"documented": "视频内容或下载响应"
}调用入口概览
POST
/v1/videosGET
/v1/videos/{task_id}GET
/v1/videos/{task_id}/content超分与视频任务共用创建、查询和下载入口；创建仅接收一条公网参考视频，无需 prompt。 参阅视频生成指南。
可选分组
计费
本目录不将倍率或复杂公式换算成固定价格。请在定价页选择分组查看计费规则。
查看完整定价没有找到匹配的模型
试试更短的关键词，或重置分类与搜索。
快照更新于 2026-10-24。价格以定价页和实际账单为准；不同 Key 可用模型可能不同。
错误码
| 状态 | 常见原因 | 处理 |
|---|---|---|
| 400 | 参数和模型能力不匹配 | 删掉该模型不支持的字段 |
| 401 | Key 缺失、无效或已撤销 | 检查 Bearer，必要时新建 Key |
| 402 | 余额不足 | 充值后再提交 |
| 403 | 分组或模型权限不足 | 换有权限的分组 |
| 404 | 路径错误，或任务不存在 | 检查是否多拼了 /v1；任务 404 保留原任务 ID |
| 429 | 频率或并发限制 | 稍后重试。已有任务只查询，不新建 |
| 5xx | 服务或链路暂时异常 | 已有任务继续查询；创建超时不要直接再提交 |
常见问题
为什么 /v1/models 里没有某个模型？
目录按 Key、分组和当前状态返回。用自己的 Key 再查一次，不要照抄别人的列表。
聊天失败时看到「请求没有完成，请稍后再试。」怎么办？
请稍后再试。如果还是失败，把这句话括号里的本站 request id 发给客服，不要附带 Key。
视频为什么要等？
视频是任务。保存任务 ID，按间隔查询，完成后再下载。不要重复创建。
Suno 的下载地址打不开上游域名？
下载地址应是本站 media.nezhahuabu.vip 上的 proxy-download。不要把地址改去别处。