图灵回路图灵回路
API 密钥

开发文档

用常见 SDK 接入。

请求进入图灵回路，账号、密钥和账单集中管理。

调用地址

https://api.turiloop.com/v1

鉴权方式

Bearer 后接你的 API 密钥

对话接口

按常见 SDK 接入

计费说明

预冻结后按实际用量结算

快速开始

创建密钥后，把 baseURL 指向图灵回路；密钥放在服务端。

对话接口
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.TURILOOP_API_KEY,
  baseURL: "https://api.turiloop.com/v1"
});

const completion = await client.chat.completions.create({
  model: "deepseek-v4-pro",
  messages: [{ role: "user", content: "你好，图灵回路" }]
});
Claude 接口

Claude 可按原生 Anthropic 路径调用，也可继续使用 OpenAI 兼容对话接口。

Anthropic 原生
POST/v1/messages
OpenAI 兼容
POST/v1/chat/completions
图像接口
POST图像生成https://api.turiloop.com/v1/images/generations
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.TURILOOP_API_KEY,
  baseURL: "https://api.turiloop.com/v1"
});

const image = await client.images.generate({
  model: "gpt-image-2",
  prompt: "一张高端科技感产品海报",
  size: "1024x1024",
  n: 1
});

调用地址

所有请求统一发送到图灵回路 API 地址，由网关校验、转发并记录流水。

https://api.turiloop.com/v1

鉴权方式

使用 Bearer 密钥鉴权。密钥只放服务端。

Authorization: Bearer YOUR_TURILOOP_API_KEY

流式调用

继续使用 stream 参数，按 SSE 读取增量内容。

stream: true

计费说明

余额预付，不允许欠费。大请求先冻结，完成后按实际用量结算。

预冻结 → 实际结算 → 差额退回

错误码

常见错误包括余额不足、模型不可用、限流和服务超时。业务侧可按 HTTP 状态码和 code 字段处理。

400请求格式错误检查 JSON 结构和必填字段。
401鉴权失败确认密钥是否正确、过期或被停用。
402余额不足充值后自动恢复，联系管理员充值。
403模型不可用模型可能被停用或不在当前分组。
429请求限流降低并发或升级到更高分组。
500服务内部错误重试一次，持续报错请联系管理员。
502上游不可用上游服务暂时中断，稍后重试。
504请求超时缩短 max_tokens 或选择更快的模型。

SDK 示例

Node.js、Python 和 curl 使用同一个调用地址和密钥。密钥只放在服务端环境变量。

Python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TURILOOP_API_KEY"],
    base_url="https://api.turiloop.com/v1"
)

chat = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[{"role": "user", "content": "你好"}]
)
print(chat.choices[0].message.content)
curl
curl https://api.turiloop.com/v1/chat/completions \
  -H "Authorization: Bearer $TURILOOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'