API 文档 — DTA AI Hub

快速开始

只需 3 行代码，即可调用 35+ AI 模型：

● python

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://oneapikey.dta.cn/v1"
)

response = client.chat.completions.create(
    model="glm-5.1",
    messages=[{"role": "user", "content": "你好！"}]
)
print(response.choices[0].message.content)

● curl

curl https://oneapikey.dta.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.1",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

认证方式

所有 API 请求需要在 Header 中携带 API Key：

● Header

Authorization: Bearer sk-your-api-key

登录控制台 → 令牌管理 → 创建新令牌，即可获取 API Key。

Base URL

公网地址

https://oneapikey.dta.cn/v1

内网地址（推荐内网服务器使用）

http://192.168.7.180:3000/v1

Chat Completions

与 OpenAI 完全一致的接口格式：

POST /v1/chat/completions

请求参数

参数	类型	必填	说明
model	string	是	模型 ID，如 glm-5.1、gpt-4o
messages	array	是	对话消息数组
max_tokens	integer	否	最大生成 Token 数
temperature	float	否	随机性 0-2，默认 1
stream	boolean	否	是否流式输出，默认 false

响应示例

● response.json

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "glm-5.1",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "你好！我是AI助手，有什么可以帮你的吗？"
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 15,
    "total_tokens": 23
  }
}

可用模型

GET /v1/models

调用此接口获取当前可用的全部模型列表。部分模型一览：

glm-5.1 — 腾讯混元旗舰

hunyuan-turbos — 腾讯快速版

gpt-4o — OpenAI 旗舰

gpt-5.5 — OpenAI 最新

claude-3.5-sonnet — Anthropic 旗舰

gemini-2.5-pro — Google 旗舰

qwen3.6-plus — 阿里通义

minimax-m2.7 — MiniMax

Embeddings

POST /v1/embeddings

● python

response = client.embeddings.create(
    model="text-embedding-v3",
    input="Hello world"
)
print(response.data[0].embedding[:5])

图像生成

POST /v1/images/generations

● python

response = client.images.generate(
    model="kolors",
    prompt="一只在月光下的猫",
    n=1,
    size="1024x1024"
)
print(response.data[0].url)

错误码

状态码	说明
401	API Key 无效或未提供
403	权限不足（模型未授权）
429	请求过于频繁或额度不足
500	服务器内部错误
502/503	上游模型服务不可用

速率限制

• 免费版：60 请求/分钟

• 标准版：300 请求/分钟

• 企业版：按需配置，默认 1000 请求/分钟

超出速率限制将返回 429 状态码，建议实现指数退避重试。

SDK 示例

兼容所有支持 OpenAI API 的 SDK，只需修改 base_url：

● Node.js

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-xxx',
  baseURL: 'https://oneapikey.dta.cn/v1'
});

● Go

clientConfig := openai.DefaultConfig("sk-xxx")
clientConfig.BaseURL = "https://oneapikey.dta.cn/v1"
client := openai.NewClientWithConfig(clientConfig)