图灵回路
ENAPI 密钥

开发文档

用常见 SDK 接入。

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

调用地址

https://api.turing.yun/v1

鉴权方式

Bearer 后接你的 API 密钥

对话接口

按常见 SDK 接入

计费说明

预冻结后按实际用量结算

快速开始

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

对话接口
import OpenAI from "openai";

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

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

网关同时兼容 Anthropic Messages API 规范（/v1/messages）：Claude Code、Anthropic SDK 等客户端可直接接入，请求会路由到你在 model 字段指定的模型。OpenAI 兼容对话接口不受影响，可按需选用。

Anthropic Messages
POST/v1/messages
OpenAI Chat Completions
POST/v1/chat/completions
图像接口

模型固定 gpt-image-2，兼容 OpenAI 图像接口：文生图用 /images/generations，基于底图编辑用 /images/edits。

POST文生图https://api.turing.yun/v1/images/generations
POST图片编辑https://api.turing.yun/v1/images/edits
文生图（generations）
import OpenAI from "openai";

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

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

也可用 curl 直传文件（multipart）：

curl https://api.turing.yun/v1/images/edits \
  -H "Authorization: Bearer $TURILOOP_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image=@input.png" \
  -F "prompt=把背景换成夜晚的霓虹街道" \
  -F "size=3840x2160"

常用参数：prompt 描述词（必填）· size 尺寸最高 3840x2160 · quality 画质 low / medium / high · n 张数（当前为 1）· response_format url 或 b64_json · 编辑时 image 为底图（必填）。客户端超时建议 ≥ 300 秒。

调用地址

所有请求统一发送到图灵回路 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.turing.yun/v1"
)

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

视频生成（HappyHorse）

HappyHorse 系列支持文生视频（t2v）、图生视频（i2v）、参考生视频（r2v）与视频编辑（video-edit），按输出时长计费：720P 与 1080P 两档、按秒计价（详见定价页）。视频为异步任务：先创建任务拿到 task_id，再轮询查询结果。

1. 创建视频任务
curl -X POST "https://api.turiloop.com/v1/video/generations" \n  -H "Authorization: Bearer $TURILOOP_API_KEY" \n  -H "Content-Type: application/json" \n  -d {
    "model": "happyhorse-1.1-t2v",
    "prompt": "A corgi surfing on a sunny beach, cinematic",
    "size": "1280*720",
    "seconds": "3"
  }
2. 轮询任务结果（生成通常需要 1~3 分钟）
curl "https://api.turiloop.com/v1/videos/{task_id}" \n  -H "Authorization: Bearer $TURILOOP_API_KEY"

# status: queued -> in_progress -> completed
# 完成后响应体的 metadata.url 即生成的 MP4（链接有时效，请及时下载）

计费：按 seconds × 所选分辨率档的每秒单价，任务创建成功时结算；任务失败自动全额退款。请求字段：size 传像素分辨率 "1280*720"（720P）或 "1920*1080"（1080P）；seconds 为字符串，3-15 秒。模型选择：文生视频 happyhorse-1.1-t2v（仅需 prompt）；图生视频 happyhorse-1.1-i2v（加 image 传首帧图 URL）；参考生视频 happyhorse-1.1-r2v（加 images 数组传 1-9 张参考图 URL）；视频编辑 happyhorse-1.0-video-edit。任务状态：queued / in_progress / completed / failed。