# 💬 关于 TikHub AI API

# TikHub AI 代理文档

## 概述

TikHub AI Proxy 通过单一 API 密钥提供对多个领先 AI 模型的统一访问，具备集中计费、速率控制和使用监控功能。

该服务允许开发者和团队在不修改应用程序逻辑的情况下，在不同 AI 提供商之间无缝切换。

> **TikHub AI Proxy 目前处于 BETA（测试）阶段。** 如果您遇到任何问题，或希望申请支持更多模型，请联系我们。

---

## 快速开始

### 1. 创建账户并获取 API 密钥

💡 前往 👉 [https://ai.tikhub.io](https://ai.tikhub.io) 注册

注册完成后，从控制台生成您的 API 密钥。

### 2. 查看支持的模型

您的 TikHub API 密钥可访问定价页面上列出的所有模型：

💡 [https://ai.tikhub.io/pricing](https://ai.tikhub.io/pricing)

请参考此页面了解模型可用性、定价及使用限制。

### 3. 获取您的 API 密钥

从开发者控制台获取您的 API 密钥：

💡 [https://ai.tikhub.io/console/token](https://ai.tikhub.io/console/token)

请妥善保管此密钥，因为所有 API 请求都需要使用它。

---

## 迁移现有集成

如果您已经在使用官方 AI 提供商的 API（OpenAI、Claude、Gemini 等），迁移至 TikHub AI Proxy **无需修改任何代码**。

### 迁移步骤

1. 将 **基础 URL** 更新为：

   ```
   https://ai.tikhub.io
   ```

2. 用您的 TikHub API 密钥替换现有的 API 密钥

3. 保持所有请求格式不变

> **重要的 SDK 兼容性说明：**
> TikHub AI Proxy **不兼容官方 SDK**（OpenAI Python SDK、Anthropic SDK、Google AI SDK 等）。您必须使用**直接的 HTTP/HTTPS 请求**来与 AI Proxy API 交互。

---

## 全新集成

如果您目前尚未与任何官方 AI 提供商进行集成，请参考以下端点文档，从零开始使用 TikHub AI Proxy。

---

## 支持的平台与模型

TikHub AI Proxy 目前在六个提供商之间统一提供了 **76 个模型**，并统一封装为兼容 OpenAI、Anthropic 和 Google 格式的接口。

| 平台 | 端点风格 | 说明 |
|---|---|---|
| **OpenAI** | `/v1/responses`、`/v1/chat/completions`、`/v1/images/generations` | GPT-4、GPT-4.1、GPT-4o、GPT-5 系列，O1/O3/O4 推理模型，图像生成 |
| **Anthropic（Claude）** | `/v1/messages`（原生格式） | Opus、Sonnet、Haiku——包括扩展思考（extended-thinking）版本 |
| **DeepSeek** | `/v1/chat/completions` | Chat、Reasoner（R1）、V3 系列、OCR |
| **Google（Gemini）** | `/v1beta/models/{model}:generateContent` | 文本/对话模型及图像生成模型 |
| **Moonshot（Kimi）** | `/v1/chat/completions`（兼容 OpenAI 格式） | 对话补全 |
| **阿里巴巴（Qwen）** | `/v1/chat/completions`（兼容 OpenAI 格式） | 对话补全 |
| **视频生成** | 专用视频端点 | Sora 2 / Sora 2 Pro、Veo、Kling、Seedance |

如需获取完整且实时更新的模型列表（含定价与速率限制），请调用 `GET /v1/models` 或查看[定价页面](https://ai.tikhub.io/pricing)。

### OpenAI

**GPT-4 系列：** `gpt-4-vision-preview`

**GPT-4.1 系列：** `gpt-4.1`、`gpt-4.1-2025-04-14`、`gpt-4.1-mini`、`gpt-4.1-mini-2025-04-14`、`gpt-4.1-nano`、`gpt-4.1-nano-2025-04-14`

**GPT-4o 系列：** `gpt-4o`、`gpt-4o-2024-05-13`、`gpt-4o-2024-08-06`、`gpt-4o-2024-11-20`、`gpt-4o-mini`、`gpt-4o-mini-2024-07-18`

**GPT-5 系列：** `gpt-5`、`gpt-5-2025-08-07`、`gpt-5-mini`、`gpt-5-nano`、`gpt-5.1`、`gpt-5.2`、`gpt-5.3-codex`、`gpt-5.4`

**O 系列（推理模型）：** `o1`、`o1-2024-12-17`、`o3`、`o3-2025-04-16`、`o3-mini`、`o3-mini-2025-01-31`、`o4-mini`、`o4-mini-2025-04-16`

**图像生成：** `gpt-image-2`、`gpt-image-2-vip`

### Anthropic（Claude）

**可用模型：** `claude-opus-4-8`、`claude-opus-4-7`、`claude-opus-4-7-thinking`、`claude-opus-4-6`、`claude-opus-4-6-thinking`、`claude-haiku-4-5-20251001`、`claude-haiku-4-5-20251001-thinking`、`claude-opus-4-5-20251101`、`claude-opus-4-5-20251101-thinking`、`claude-sonnet-4-5-20250929`、`claude-sonnet-4-5-20250929-thinking`

通过原生 Anthropic Messages API 格式（`/v1/messages`）访问，使用 `x-api-key` 请求头进行身份验证。

### DeepSeek

**对话：** `deepseek-chat`

**推理：** `deepseek-reasoner`、`deepseek-r1`、`deepseek-r1-250528`

**蒸馏模型：** `deepseek-r1-distill-llama-70b`、`deepseek-r1-distill-llama-8b`

**V3 系列：** `deepseek-v3`、`deepseek-v3-fast`、`deepseek-v3.1`、`deepseek-v3.1-fast`、`deepseek-v3.1-terminus`、`deepseek-v3.2`、`deepseek-v3.2-exp`、`deepseek-v3.2-fast`

**其他：** `deepseek-ocr`

### Google（Gemini）

**文本/对话模型：** `gemini-3-flash-preview`

**图像生成模型：** `gemini-2.5-flash-image`、`gemini-3-pro-image-preview`

通过原生 Gemini `generateContent` 格式访问，使用 `x-goog-api-key` 请求头进行身份验证。若需图像生成，请将 `generationConfig.responseModalities` 设置为 `["image", "text"]`。

### Moonshot（Kimi）与阿里巴巴（Qwen）

Kimi 和 Qwen 模型均可通过兼容 OpenAI 格式的 `/v1/chat/completions` 端点访问——只需将 `model` 设置为所需的 Kimi 或 Qwen 模型名称即可。

> ⚠️ **说明：** 截至本文撰写时，官方文档站点（ai-docs.tikhub.io）中 Kimi 和 Qwen 的专属端点页面显示的是从 DeepSeek 页面复制过来的占位内容，而非各自独立的模型列表。如需获取准确、最新的模型标识符，请在[定价页面](https://ai.tikhub.io/pricing)的 **Provider（提供商）** 筛选器中查看阿里巴巴（Alibaba）/ Moonshot 分类，或调用 `GET /v1/models` 查询。

### 视频生成

视频生成通过专用的任务型端点（创建 → 轮询/列表 → 获取结果）提供支持，涵盖：

- **Sora** —— 例如 `sora-2`（文本/图像转视频）
- **Veo** —— Google 的视频生成模型
- **Kling** —— 文本转视频及图像转视频
- **Seedance** —— 基于任务的视频生成

具体请求格式请参考文档中的 `VideoCreateRequest`、`VeoGenerateRequest`、`KlingText2VideoRequest`、`KlingImage2VideoRequest` 及 `SeedanceTaskRequest` 数据结构。

---

## 身份验证

### 标准身份验证

大多数端点使用 Bearer Token 身份验证：

```
Authorization: Bearer YOUR_API_KEY
```

### 特定提供商的身份验证

部分 API 需要使用不同的请求头：

**Claude Messages API**

```
x-api-key: YOUR_API_KEY
```

**Gemini API**

```
x-goog-api-key: YOUR_API_KEY
```

---

## 基础 URL

所有 API 请求均应发送至：

```
https://ai.tikhub.io
```

---

## 支持

如需技术支持、文档咨询或账户相关帮助，请访问：

🌐 [https://ai.tikhub.io](https://ai.tikhub.io)
📩 team@tikhub.io

我们的团队将尽快回复。