开发文档
用熟悉的 OpenAI 写法接入。
图灵回路提供 OpenAI-compatible API Base URL。请求统一进入 BFF 网关，由用户、Key、余额、预算和调用日志共同完成接入闭环。
Base URL
https://api.turingloop.com.cn/v1
鉴权
Authorization: Bearer YOUR_API_KEY
Chat Completions
保持 OpenAI SDK 兼容写法
计费说明
预冻结后按实际 Token 结算
快速开始
创建 API Key 后，把 SDK 的 baseURL 指向图灵回路即可。不要在浏览器前端暴露 API Key。
Chat Completions
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.TURING_API_KEY,
baseURL: "https://api.turingloop.com.cn/v1"
});
const completion = await client.chat.completions.create({
model: "deepseek-v3.2",
messages: [{ role: "user", content: "你好，图灵回路" }]
});Base URL
所有请求统一发送到图灵回路 API Base URL。BFF 网关负责 API Key 校验、预算预冻结、上游转发和账单流水记录。
https://api.turingloop.com.cn/v1Authorization
使用 Bearer Token 鉴权。不要在前端代码中暴露 API Key，生产环境建议按业务拆分 Key。
Authorization: Bearer YOUR_TURING_API_KEY流式调用
保持 OpenAI-compatible 的 stream 参数写法，前端或服务端按 SSE 方式读取增量内容。
stream: true计费说明
余额预付，不允许欠费。大请求先按预估上限冻结，完成后按实际 Token、缓存命中和上游账单结算，差额退回。
预冻结 → 实际结算 → 差额退回错误码
常见错误包括 UPSTREAM_TIMEOUT、INSUFFICIENT_BALANCE、MODEL_NOT_ALLOWED、RATE_LIMITED。业务侧可以按 code 字段做重试、降级或提示。
SDK 示例
Node.js、Python 和 curl 均使用同一个 Base URL。服务端只保存环境变量，不把 API Key 写进前端代码。