纯梦网络
API DOCUMENT

大模型 API

使用纯梦 API Key 调用下方「可用模型」中列出的全部模型。请求体按对应接口格式原样传入, 只需要把请求地址换成纯梦域名。

基础信息

项目说明
鉴权Authorization: Bearer 你的纯梦APIKey
请求格式Content-Type: application/json
返回格式非流式返回 JSON;stream: true 时返回 text/event-stream。
计费请求成功后按实际输入、输出 token 计费;请求失败不扣费。
参数与额度输入、输出预算与思考配置由所选模型支持范围决定。平台不截断文本、不压低调用方预算;未传的生成参数采用模型服务默认值。

可用模型

下表与 GET /v1/models 返回一致;公开模型仅展示纯梦零售价,「—」表示暂不单独标价。

model名称最大输出预算输入价格输出价格缓存读取价格缓存写入价格建议接口
gpt-5-5GPT-5.5128,000 tokens¥0.6000 / 百万 tokens¥4.8000 / 百万 tokens——/v1/responses
gpt-6-astraGPT-6 Astra(最高思考 max)128,000 tokens¥4.5000 / 百万 tokens¥22.5000 / 百万 tokens¥0.45 / 百万 tokens¥5.625 / 百万 tokens/v1/responses
claude-opus-4-6-thinkingClaude Opus 4.6 Thinking128,000 tokens¥2.1000 / 百万 tokens¥10.5000 / 百万 tokens——/v1/chat/completions
claude-opus-5-5Claude Opus 5.5128,000 tokens¥0.9000 / 百万 tokens¥4.5000 / 百万 tokens¥0.045 / 百万 tokens¥1.125 / 百万 tokens/v1/chat/completions
claude-sonnet-4-6Claude Sonnet 4.6128,000 tokens¥1.2600 / 百万 tokens¥6.3000 / 百万 tokens——/v1/chat/completions
gemini-3.8-flashGemini 3.8 Flash65,536 tokens¥1.5000 / 百万 tokens¥5.0000 / 百万 tokens——/v1/chat/completions
gemini-3.1-proGemini 3.1 Pro65,536 tokens¥4.0000 / 百万 tokens¥24.0000 / 百万 tokens¥0.4000 / 百万 tokens—/v1/chat/completions
gemini-3.1-pro-highGemini 3.1 Pro High65,536 tokens¥1.1200 / 百万 tokens¥6.7200 / 百万 tokens¥0.1120 / 百万 tokens—/v1/chat/completions
gemini-3.1-pro-lowGemini 3.1 Pro Low65,536 tokens¥1.1200 / 百万 tokens¥6.7200 / 百万 tokens¥0.1120 / 百万 tokens—/v1/chat/completions

最大输出预算依据原厂及模型服务公开规格,包含模型的思考 tokens,并不等于可见正文长度;本平台不另加输出截断。实际答案可提前自然结束,也受上下文、账户和模型服务约束。128,000 / 65,536 等数值是规格上限,未以付费生成完整上限长度作验证。GET /v1/models 同步返回 max_output_tokens、context_window 和 limit_source。

GPT-6 Astra 默认使用最高思考 max;Responses 显式设置 reasoning.effort=max,Chat Completions 使用 reasoning_effort=max。Claude Opus 5.5 使用 /v1/chat/completions,自适应思考始终开启。

GPT-6 Astra 的上表价格适用于不超过 272,000 输入 tokens 的请求;超过该长度时,整次请求的输入与缓存价格按 2 倍、输出按 1.5 倍计算。

Gemini 3.1 Pro 系列

标准版 gemini-3.1-pro、High 版 gemini-3.1-pro-high、Low 版 gemini-3.1-pro-low 均使用 /v1/chat/completions,支持普通 JSON 与 SSE 流式调用。三种型号独立选择,不会互相替换;当前不提供 Responses 或原生 Gemini 接口。

上表列出参考单价;实际费用确认后才扣款,不按本地估算 token 提前扣费。思考 token、缓存优惠按模型服务最终结算为准,最终金额向上取整到分。未传输出预算或思考配置时采用模型默认值,显式参数按原值传递。

普通响应返回 usage、charge_cents(分)、charge_yuan(元)、billing_status;流式响应在结束前通过 puream.billing 事件返回。charged 表示已结算;pending 表示仍在核对实际费用,此时金额为null、尚未扣款,费用确认后可查询最终账单。这里返回用量与总扣费,不拆分估算的输入、缓存或输出金额。

curl -X POST "https://puream.cn/v1/chat/completions" \
  -H "Authorization: Bearer 你的纯梦APIKey" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.1-pro","messages":[{"role":"user","content":"你好"}],"stream":false}'

Responses 接口

POST https://puream.cn/v1/responses

适合 GPT-6 Astra、GPT-5.5 和 Gemini 3.8 Flash;Gemini 3.1 Pro 系列、Claude Opus 5.5 请使用 Chat Completions。请求体按 Responses 格式传入,返回体保持 Responses 格式;模型扩展参数按其支持范围传递。

GPT-6 Astra 的函数/自定义工具调用需要 Responses;该模型不支持 temperature、top_p、top_logprobs,Chat Completions 还不支持 logprobs。思考强度支持 low、medium、high、xhigh、max。GPT-6 Astra、Claude Opus 5.5 当前只开放函数或自定义工具,不开放单独计费的内置工具。

字段类型必填可填值 / 示例作用
modelstring是gpt-6-astra要调用的模型。
inputstring | array是字符串,或 role/content 数组用户输入内容。支持纯文本,也支持多模态 content 数组。
instructionsstring否任意系统提示词设置模型的整体角色、语气、规则。
max_output_tokensnumber否所选模型支持的预算按传入值执行;不填时使用模型服务默认值。
temperaturenumber否0 到 2控制输出随机性,数值越高越发散。
top_pnumber否0 到 1核采样参数,通常不要和 temperature 同时大幅调整。
textobject否format、verbosity控制文本输出格式。format 可用于 text 或 json_schema。
reasoningobject否effort: max(GPT-6 Astra 默认)Astra 支持 low、medium、high、xhigh、max;最高思考使用 max。
toolsarray否函数、搜索等工具定义让模型在回答中调用工具。
tool_choicestring | object否auto | required | none | 指定工具控制是否使用工具以及使用哪个工具。
streamboolean否true | false是否使用 SSE 流式返回。
storeboolean否true | false是否保存本次响应记录。
metadataobject否自定义键值给请求附加业务侧元数据。
curl -X POST "https://puream.cn/v1/responses" \
  -H "Authorization: Bearer 你的纯梦APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "instructions": "你是专业文案编辑。",
    "input": [
      {
        "role": "user",
        "content": [
          { "type": "input_text", "text": "把这段文案改得更自然:这里填写原文" }
        ]
      }
    ],
    "text": {
      "format": { "type": "text" },
      "verbosity": "medium"
    },
    "reasoning": {
      "effort": "max",
      "summary": "auto"
    },
    "max_output_tokens": 1200,
    "stream": false,
    "store": true
  }'

Chat Completions 接口

POST https://puream.cn/v1/chat/completions

适合 Claude Opus 5.5,也兼容其他已开放的 Chat Completions 模型。请求体按 Chat Completions 格式传入,返回体保持 Chat Completions 格式。Claude Opus 5.5 始终使用自适应思考;传 thinking.type=adaptive 或省略 thinking,可用 effort 调整深度,不要传采样参数。

字段类型必填可填值 / 示例作用
modelstring是claude-opus-5-5,也可填已开放模型要调用的模型。
messagesarray是role/content 数组对话消息列表。role 常用 system、user、assistant。
max_tokensnumber否所选模型支持的预算按传入值执行;不填时不附加固定输出上限。
max_completion_tokensnumber否所选模型支持的预算支持此字段的模型可直接传入,不自动压低。
temperaturenumber否0 到 2控制输出随机性。
top_pnumber否0 到 1核采样参数。
streamboolean否true | false是否使用 SSE 流式返回。
stream_optionsobject否include_usage: true流式返回时可要求带 usage 信息。
toolsarray否函数工具定义让模型调用外部工具。
tool_choicestring | object否auto | required | none | 指定工具控制工具调用策略。
response_formatobject否json_schema 等控制结构化输出格式。
reasoning_effortstring否low | medium | high | xhigh | max(Astra)GPT-6 Astra 默认最高 max;显式传入的受支持档位保留。
thinkingobject否typeClaude Opus 5.5 可填 adaptive;也可省略并使用模型默认思考。
effortstring否low | medium | high设置 Claude Opus 5.5 的自适应思考深度。
stopstring | array否停止词遇到指定文本时停止生成。
metadataobject否自定义键值给请求附加业务侧元数据。
curl -X POST "https://puream.cn/v1/chat/completions" \
  -H "Authorization: Bearer 你的纯梦APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "messages": [
      { "role": "system", "content": "你是专业文案编辑。" },
      { "role": "user", "content": "把这段文案改得更自然:这里填写原文" }
    ],
    "max_tokens": 1200,
    "thinking": {
      "type": "adaptive"
    },
    "effort": "medium",
    "stream": false
  }'

思考强度

接口字段推荐值说明
/v1/responsesreasoning.effortlow、medium、high、xhigh、max控制 GPT-6 Astra 思考强度;GPT-5.5 使用其自身支持范围。
/v1/responsesreasoning.summaryauto需要思考摘要时填写。
/v1/chat/completionsthinking.typeadaptiveClaude Opus 5.5 默认启用自适应思考;可省略此字段。
/v1/chat/completionseffortlow、medium、high设置 Claude Opus 5.5 思考深度。
/v1/chat/completionsreasoning_effortlow、medium、high兼容部分推理模型的思考强度字段。

错误返回

HTTP 状态码含义处理建议
401缺少或错误的纯梦 API Key检查 Authorization 请求头。
402余额不足充值后重试。
400模型未启用或配置异常确认 model 是否填写正确。
500模型调用失败查看返回的 error.message,稍后重试或联系管理员。