文档/SDKs 和库

SDKs 和库

通过我们官方维护的 SDK，您可以几行代码内完成 TurningAPI 的集成。SDK 已经处理了认证、错误处理和重试逻辑，让您的开发工作更加轻松。

官方 SDK

我们提供官方维护的 SDK，支持多种编程语言和运行环境。

TypeScript / JavaScript

v1.4.2

支持 Node.js, Deno, Bun 以及浏览器端环境。提供完整的 TypeScript 类型定义，支持异步调用和流式输出。

安装

npm install turning-api

示例

import TurningAPI from "turning-api";

const client = new TurningAPI({
  apiKey: process.env.TURNING_API_KEY
});

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

console.log(response.output_text);

GitHub 文档

Python SDK

v2.0.1

兼容 Python 3.8+。支持异步调用模型及流式输出。提供完整的类型提示和错误处理。

安装

pip install turning-api

示例

from turning_api import TurningAPI
import os

client = TurningAPI(api_key=os.getenv("TURNING_API_KEY"))

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

print(response.output_text)

GitHub 文档

HTTP 客户端库

如果您不想使用官方 SDK，也可以使用任何支持 HTTP 请求的库直接调用 REST API。以下是常见语言的示例：

const axios = require('axios');

const url = 'https://api.turning.info/v1/person/verify';
const headers = {
  'Authorization': 'Bearer YOUR_API_KEY',
  'Content-Type': 'application/json'
};
const data = {
  name: '张三',
  id_card: '110101199003071234',
  phone: '13800138000'
};

axios.post(url, data, { headers })
  .then(res => console.log(res.data))
  .catch(err => console.error(err));

SDK 特性

自动认证

SDK 自动处理 API Key 的认证，您只需要在初始化时配置一次即可。

自动重试

内置智能重试机制，自动处理临时性错误和网络问题。

类型安全

完整的 TypeScript 类型定义，提供智能代码补全和类型检查。

高性能

优化的网络请求和连接池管理，确保最佳性能。

开始使用

选择适合您项目的 SDK，按照上面的安装说明开始使用。如果您需要更多帮助，可以查看快速上手指南。

查看快速上手查看 API 参考