服务端调用示例
使用统一封装调用 JSON API 和 SSE。
支持 Java / Node.js 标签切换的完整示例见从创建应用到首次调用。
通用封装
当前未发布独立官方 SDK。可直接使用运行环境的 HTTP 客户端；完整 JavaScript 封装见 能力调用的服务端统一封装。
JSON 请求
const url = new URL('/openapi/v1/echo', process.env.THINKWHEEL_GATEWAY_ORIGIN);
url.searchParams.set('model', 'education-ocr');
const response = await fetch(url, {
method: 'POST',
headers: {
Authorization: 'Bearer ' + process.env.THINKWHEEL_ACCESS_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({ message: 'hello' }),
});
if (!response.ok) throw new Error(`调用失败：${response.status}`);
const result = await response.json();echo 和 message 是本地 Demo 示例，真实业务路径及字段需按具体能力约定替换。
SSE 读取
对支持 SSE 的接口请求后读取 response.body，并使用流式 TextDecoder 解码。网络分块不等于完整 SSE 事件，解析事件时应保留跨块残留内容，按空行识别事件边界。不要先调用 response.json() 再读取同一响应流。
错误与取消
使用 AbortController 取消请求。401、403、503 的含义见 错误码；不要把未知失败的业务请求直接自动重试。