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

# 多协议与多格式接入说明

> 当前项目不是只有一种协议。为降低接入成本，公开文档优先提供统一格式；同时保留少量模型原生格式或专用格式。

## 1. OpenAI 兼容格式

适合大多数新接入场景，优先考虑：

* `POST /v1/chat/completions`
* `POST /v1/responses`
* `GET /v1/responses/{response_id}`
* `POST /v1/images/generations`
* `POST /v1/images/edits`
* `POST /v1/videos`
* `GET /v1/videos/{task_id}`

特点：

* SDK 生态成熟
* 字段风格统一
* 适合多模型切换

## 2. 模型原生格式

当模型本身需要专用字段、专用任务结构或原生查询协议时，公开原生接口：

* Seedance：`/api/v3/contents/generations/tasks`
* MiniMax / Hailuo：`minimax-h3` 和 `hailuo-2.3` 可使用 `/v1/videos`，也可通过 `/api/v3/contents/generations/tasks` 的任务格式接入
* HappyHorse：`/api/v1/services/aigc/video-generation/video-synthesis` 和 `/api/v1/tasks/{task_id}`
* Vidu：`/ent/v2/text2video`、`/ent/v2/img2video`、`/ent/v2/start-end2video`、`/ent/v2/reference2video` 和 `/ent/v2/tasks/{task_id}/creations`
* Omni 与 Veo：`gemini-omni` 使用 `/v1/videos` 或 `/api/v3/contents/generations/tasks`；Veo 原生预留路径为 `/v1beta/models/{model}:predictLongRunning` 和 `/v1beta/{operation_name}`
* Gemini 图片生成：`/v1beta/models/{model}:generateContent`
* 音乐生成：`/suno/submit/music` 和 `/suno/fetch/{task_id}`，支持提示词描述模式、轻音乐/纯伴奏、歌词高级模式

`gemini-omni` 是对外公开的视频模型名，不需要关心内部上游模型；视频调用优先使用 `/v1/videos`，也可使用 Seedance 任务格式 `/api/v3/contents/generations/tasks`。`mode=t2v/r2v/edit` 分别表示文生视频、参考生成和视频编辑，时长字段会自动匹配到 4 / 6 / 8 / 10 秒档。

适合：

* 模型特有字段较多
* 需要原生请求体结构
* 需要保持与上游官方格式接近

## 3. 模型专用视频接口

当前还公开少量模型专用接口，例如：

* `POST /kling/v1/videos/text2video`
* `POST /kling/v1/videos/image2video`
  适合：
* 已经基于对应模型专用协议集成
* 需要使用该模型专用参数模式

## 4. 选择建议

1. 新项目优先使用 OpenAI 兼容格式。
2. 如果兼容格式无法覆盖模型特有字段，再切换到原生格式。
3. 长任务接口应明确区分“创建接口”和“查询接口”，保存 `task_id` 或 `operation_name`。
4. 同一模型存在多种调用格式时，以对应接口页的支持字段为准，不要混用请求体。