文档/快速上手

开发者快速上手

开启您的 TurningAPI 之旅。我们提供极简的接口，助您快速调用全球顶尖的 AI 模型。

创建并导出 API 密钥

访问控制台创建密钥。完成后，在您的开发环境终端执行以下命令：

# 导出环境变量到当前会话

export TURNING_API_KEY="your_api_key_here"

安全提示

所有 API 请求都必须在 HTTP Header 中包含您的 API Key 进行认证：Authorization: Bearer YOUR_API_KEY。请勿在客户端代码中暴露您的 API Key，建议使用环境变量或安全的密钥管理服务。

安装 SDK 并运行 API 调用

使用官方 SDK 可以大幅简化鉴权与响应处理。选择您熟悉的语言开始：

$npm install turning-api

import TurningAPI from "turning-api";
const client = new TurningAPI();

const response = await client.responses.create({
  model: "gpt-5-nano",
  input: "为你最爱的猫起一个超酷的名字。"
});

console.log(response.output_text);

响应示例

{
  "code": 200,
  "message": "Success",
  "trace_id": "b19a828a-4a88-447a-94a8-8b2d3e4b5e6f",
  "data": {
    "output_text": "闪电侠、小霸王、星尘..."
  }
}

错误处理

TurningAPI 使用标准的 HTTP 响应代码来指示 API 请求的成功或失败。

HTTP 状态码	错误码	描述
400	40001	请求参数格式错误或缺失
401	40101	API Key 无效或未提供
403	40301	无权访问该 API
404	40401	未找到匹配的记录
429	42901	请求频率超限
500	50001	服务内部错误

速率限制

为确保服务的稳定性，我们对 API 调用频率进行了限制。

标准套餐

100 请求/分钟

专业套餐

1000 请求/分钟

企业套餐

无限制（专属集群）

核心能力解析

生成文本

利用最先进的模型进行内容创作、总结、翻译或代码编写。支持流式输出，实现毫秒级响应。

const response = await client.responses.create({
  model: "gpt-5-nano",
  input: "为你最爱的猫起一个超酷的名字。"
});

发送 API 请求

使用 RESTful API 直接调用，所有请求都需要在 Header 中包含认证信息。

curl -X POST https://api.turning.info/v1/person/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "张三",
    "id_card": "110101199003071234"
  }'