众扬汇 AI 开放平台 API 文档

Messages(思考)

OpenAPI Specification

接口:POST /v1/messages(完整地址 https://api.allyang.cn/v1/messages)

鉴权:请求头 Authorization 传令牌(取值形如 Bearer {{YOUR_API_KEY}}),也可以改用请求头 x-api-key 直接给密钥(示例 {{key}});两者均非必填。

请求头

  • Content-Type:非必填,固定 application/json。
  • Accept:非必填,原文档示例为 */*。
  • x-api-key:非必填,string,原文档示例为 {{key}}。

请求体参数(application/json)

原文档没有给出请求体的字段定义,只附了一份示例,下面按该示例整理:

  • model:string,示例值为 claude-3-7-sonnet-20250219;也可以换成带 -thinking 后缀的模型。
  • max_tokens:integer,示例值为 20000。
  • thinking:object,示例中 type 取 enabled、budget_tokens 取 16000。
  • messages:array,示例里只有一条,形如 {role: user, content: 你是谁?}。

想拿到更长的输出,可以在请求头带上 anthropic-beta: output-128k-2025-02-19;原文档说明该能力处于测试阶段,输出上限为 128K 标记。

响应

  • 200:返回成功,响应体为 JSON 对象。
  • content:内容块数组,原文档示例里同时出现思考块与文本块,形如 {"type": "thinking", "thinking": "...", "signature": "..."} 与 {"type": "text", "text": "..."}。

使用提示:本平台 Base URL 为 https://api.allyang.cn,OpenAI 兼容接口路径以 /v1 开头;示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。