> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socialvision.tisyk.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 入门指南

> 快速开始：入门指南

## API 是什么

API 是 AI 模型聚合中转平台：在兼容 OpenAI 接口风格的前提下，通过统一 Base URL 与 API Key 调用多家模型（Chat、图像、视频、音频等）。

## 接入三要素

| 项 | 说明 |
| - | - |
| **Base URL** | `https://socialvision.tisyk.xyz/v1`（OpenAI 兼容路径） |
| **API Key** | 在控制台「API 令牌」创建，请求头 `Authorization: Bearer sk-xxx` |
| **Model** | 控制台「支持模型」或 `GET /v1/models` |

## 推荐学习路径

1. [5 分钟 Quick Start（Python）](./quickstart-python)
2. [异步任务通用说明](./async-task-general)（视频 / Suno / Kling 等必读）
3. 门户「接口参考」中的各平台 OpenAPI

## 与官方 API 的关系

* **默认**：改 `base_url` 指向，模型名使用支持的 ID
* **进阶**：部分平台提供原生路径（如 `/kling/*`、`/suno/*`），见门户对应平台文档

## 常见错误

| 现象 | 可能原因 |
| - | - |
| `invalid character '<' looking for beginning of value` | Base URL 或路径错误，上游返回了 HTML |
| 401 | Key 无效或已禁用 |
| 模型不存在 | 模型名拼写错误或当前分组无权限 |

更多排错见各平台 OpenAPI 中的 `x-error-playbook`。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.