# API 总指南

把总指南或 AI 阅读链接交给 AI，根据你的需求查找平台能力、接口、鉴权与详细接入文档。

本平台通过统一站点提供多种模型协议的调用入口，以及账号、API Key、任务结果、用量和价格查询接口。请根据任务选择协议，再按对应接口详情完成接入。

本指南由本站已发布的接口目录生成，共 109 条接口文档条目；同一路径的不同协议用法可能分别列出。它不是运行时可用性或上游实测通过的承诺。

API 基础地址: https://api.tu-zi.com

指南更新日期: 2026-11-04

固定 AI 阅读链接: https://api.tu-zi.com/docs/api/overview.md

## 如何根据用户需求使用本指南

1. 先确认用户想完成的任务、输入与预期输出；不明确时询问缺失的信息。
2. 根据下方能力地图和任务路线选择候选接口，再查完整接口索引。
3. 打开候选接口的 AI 详情链接，读取鉴权、参数、代码示例、响应、错误与限制后再编写代码。索引不包含完整请求结构，不要猜测字段。
4. 查询当前可用模型、端点支持、账号权限与价格。厂商介绍中的型号不代表本站或当前账号一定可调用。
5. 异步任务按同一协议的提交、查询和结果流程处理；WebSocket、SSE 与普通 JSON 不能相互替代。成功受理不代表生成完成。
6. 如果无法联网或打不开详情，请明确说明，并让用户从对应接口页面复制接入指南，不要声称已读取未访问的内容。

这里只提供文档与示例。实际执行付费生成、创建或删除密钥等操作前，先确认用户的操作意图；示例使用环境变量，不要求用户把真实凭证贴进对话。

## 能力地图

| 用户需求 | 对应能力与指南 |
| --- | --- |
| 聊天、写作、代码、文本推理 | [使用指南](https://api.tu-zi.com/docs/use-cases/text-reasoning.md) · text |
| 生成图片、修改图片 | [使用指南](https://api.tu-zi.com/docs/use-cases/image-generation.md) · images |
| 生成视频、图片转视频 | [使用指南](https://api.tu-zi.com/docs/use-cases/video-generation.md) · video |
| 语音合成、录音转文字、实时语音与同声传译、音乐 | [使用指南](https://api.tu-zi.com/docs/use-cases/audio.md) · speech / realtime / music |
| 知识库、向量检索、结果重排 | [使用指南](https://api.tu-zi.com/docs/use-cases/rag.md) · retrieval |
| 工具调用与应用编排 | [使用指南](https://api.tu-zi.com/docs/use-cases/agents.md) · text |

能力组合仍由应用实现：例如知识库需要自行处理数据与检索编排，不能把它当作一个未声明的完整业务接口。账号信息、密钥管理、用量日志、价格与充值记录接口见下方对应分组。

## 接入与鉴权

- 模型调用使用模型 API Key；账号管理使用账号系统令牌，不能混用。具体认证头和例外以每条接口详情为准。
- 使用系统令牌时，可先调用身份初始化接口获取用户 ID；后续账号接口通常还需要 New-Api-User。身份初始化不接受模型密钥或浏览器 Cookie 替代系统令牌。
- 标注“可匿名”的接口可能根据登录状态返回不同数据；模型范围、用户分组和价格需要按当前账号核对。
- 接口索引中的 JSON、multipart、WebSocket 表示请求传输类型；流式返回与异步完成方式请阅读详情。

## 常见任务路线

- 接入聊天或文本生成：[获取可调用模型](https://api.tu-zi.com/docs/api/reference-models-list.md) → [OpenAI Chat Completions](https://api.tu-zi.com/docs/api/reference-relay-openai.md)
- 标准视频任务：提交、查询、下载：[OpenAI Video](https://api.tu-zi.com/docs/api/reference-relay-openai-video.md) → [查询统一视频或图片任务](https://api.tu-zi.com/docs/api/reference-relay-video-fetch.md) → [下载视频任务结果](https://api.tu-zi.com/docs/api/reference-relay-video-content.md)
- Kling 图片转视频：提交与查询：[Kling Image to Video](https://api.tu-zi.com/docs/api/reference-relay-kling-video-image.md) → [查询 Kling videos 任务](https://api.tu-zi.com/docs/api/reference-relay-kling-videos-fetch.md)
- 生成音乐与查询结果：[Suno Music Generation](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-music.md) → [查询 Suno v2 任务](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-fetch.md)
- 用系统令牌确认身份、创建模型密钥、查看用量：[初始化账号身份（获取用户 ID）](https://api.tu-zi.com/docs/api/reference-account-bootstrap.md) → [创建 API Key](https://api.tu-zi.com/docs/api/reference-token-create.md) → [查询使用日志](https://api.tu-zi.com/docs/api/reference-usage-logs.md)

不要混用不同供应商的任务 ID、查询路径或结果字段。图片上传形式、支持模型、任务状态与轮询间隔请读取所选接口的完整说明。

## 完整接口索引

### 文本生成 (6)

| 接口与文档 | 方法、路径与传输 | 鉴权 | 用途 |
| --- | --- | --- | --- |
| [Anthropic Messages](https://api.tu-zi.com/docs/api/reference-relay-anthropic) · [AI](https://api.tu-zi.com/docs/api/reference-relay-anthropic.md) | `POST /v1/messages` · json | 模型调用 API Key | 兼容 Anthropic Messages 协议，适合 Claude 等模型原生接入。 |
| [Gemini Generate Content](https://api.tu-zi.com/docs/api/reference-relay-gemini) · [AI](https://api.tu-zi.com/docs/api/reference-relay-gemini.md) | `POST /v1beta/models/{model}:generateContent` · json | 模型调用 API Key | 兼容 Gemini 原生协议，适合直接走 generateContent 风格请求。 |
| [JEV SystemOne](https://api.tu-zi.com/docs/api/reference-relay-systemone) · [AI](https://api.tu-zi.com/docs/api/reference-relay-systemone.md) | `POST /v1/systemone` · json | 模型调用 API Key | JEV 原生决策接口。提交 state 与 questions，保留上游原生答案结构；Community 可能将答案包在 data.answers 中。仅支持同步 JSON 请求，不使用 Chat Completions 的 messages 或 stream。 |
| [OpenAI Chat Completions](https://api.tu-zi.com/docs/api/reference-relay-openai) · [AI](https://api.tu-zi.com/docs/api/reference-relay-openai.md) | `POST /v1/chat/completions` · json | 模型调用 API Key | 兼容 OpenAI Chat Completions 协议，适合大多数对话类接入场景。 |
| [OpenAI Responses](https://api.tu-zi.com/docs/api/reference-relay-openai-response) · [AI](https://api.tu-zi.com/docs/api/reference-relay-openai-response.md) | `POST /v1/responses` · json | 模型调用 API Key | 兼容 OpenAI Responses 协议，适合多模态与结构化输出新接口。 |
| [OpenAI Responses Compact](https://api.tu-zi.com/docs/api/reference-relay-openai-response-compact) · [AI](https://api.tu-zi.com/docs/api/reference-relay-openai-response-compact.md) | `POST /v1/responses/compact` · json | 模型调用 API Key | Responses 上下文压缩接口，用于压缩已有对话，返回可继续使用的输出项；不支持流式返回。 |

### 图片生成与编辑 (7)

| 接口与文档 | 方法、路径与传输 | 鉴权 | 用途 |
| --- | --- | --- | --- |
| [Black Forest Labs FLUX](https://api.tu-zi.com/docs/api/reference-relay-bfl-image) · [AI](https://api.tu-zi.com/docs/api/reference-relay-bfl-image.md) | `POST /flux/v1/flux-3-image` · json | 模型调用 API Key | 本站 FLUX 原生兼容入口，只支持 flux-3-image；其他 FLUX 模型使用模型详情列出的协议。 |
| [Gemini Image Generation](https://api.tu-zi.com/docs/api/reference-relay-gemini-image) · [AI](https://api.tu-zi.com/docs/api/reference-relay-gemini-image.md) | `POST /v1beta/models/{model}:generateContent` · json | 模型调用 API Key | Gemini 原生图片生成协议，通过 generateContent 返回文本与图片内容。 |
| [Image Generation](https://api.tu-zi.com/docs/api/reference-relay-image-generation) · [AI](https://api.tu-zi.com/docs/api/reference-relay-image-generation.md) | `POST /v1/images/generations` · json | 模型调用 API Key | 图像生成接口，适合文生图场景。 |
| [Kling Image Generation](https://api.tu-zi.com/docs/api/reference-relay-kling-image) · [AI](https://api.tu-zi.com/docs/api/reference-relay-kling-image.md) | `POST /kling/v1/images/generations` · json | 模型调用 API Key | 可灵官方图片生成异步任务接口。 |
| [Midjourney 提交绘图](https://api.tu-zi.com/docs/api/reference-relay-midjourney) · [AI](https://api.tu-zi.com/docs/api/reference-relay-midjourney.md) | `POST /mj/submit/imagine` · json | 模型调用 API Key | 通过本站兼容入口创建图像任务。 |
| [OpenAI Image Edit](https://api.tu-zi.com/docs/api/reference-relay-image-edit) · [AI](https://api.tu-zi.com/docs/api/reference-relay-image-edit.md) | `POST /v1/images/edits` · multipart | 模型调用 API Key | OpenAI 图片编辑协议，需要使用 Multipart 上传原图。 |
| [异步图片生成](https://api.tu-zi.com/docs/api/reference-relay-image-generation-async) · [AI](https://api.tu-zi.com/docs/api/reference-relay-image-generation-async.md) | `POST /v1/videos` · json | 模型调用 API Key | 本站异步图片扩展入口：使用图片参数创建任务，再查询图片结果。虽然路径为 /v1/videos，任务生成的是图片。 |

### 视频生成 (3)

| 接口与文档 | 方法、路径与传输 | 鉴权 | 用途 |
| --- | --- | --- | --- |
| [Kling Image to Video](https://api.tu-zi.com/docs/api/reference-relay-kling-video-image) · [AI](https://api.tu-zi.com/docs/api/reference-relay-kling-video-image.md) | `POST /kling/v1/videos/image2video` · json | 模型调用 API Key | 可灵官方图生视频异步任务接口。 |
| [Kling Text to Video](https://api.tu-zi.com/docs/api/reference-relay-kling-video-text) · [AI](https://api.tu-zi.com/docs/api/reference-relay-kling-video-text.md) | `POST /kling/v1/videos/text2video` · json | 模型调用 API Key | 可灵官方文生视频异步任务接口。 |
| [OpenAI Video](https://api.tu-zi.com/docs/api/reference-relay-openai-video) · [AI](https://api.tu-zi.com/docs/api/reference-relay-openai-video.md) | `POST /v1/videos` · json | 模型调用 API Key | 视频生成接口，适合文生视频场景。 |

### 语音处理 (3)

| 接口与文档 | 方法、路径与传输 | 鉴权 | 用途 |
| --- | --- | --- | --- |
| [OpenAI Audio Transcription](https://api.tu-zi.com/docs/api/reference-relay-audio-transcription) · [AI](https://api.tu-zi.com/docs/api/reference-relay-audio-transcription.md) | `POST /v1/audio/transcriptions` · multipart | 模型调用 API Key | 语音转文字接口，需要使用 Multipart 上传音频文件。 |
| [OpenAI Audio Translation](https://api.tu-zi.com/docs/api/reference-relay-audio-translation) · [AI](https://api.tu-zi.com/docs/api/reference-relay-audio-translation.md) | `POST /v1/audio/translations` · multipart | 模型调用 API Key | 音频翻译接口，需要使用 Multipart 上传音频文件。 |
| [OpenAI Text to Speech](https://api.tu-zi.com/docs/api/reference-relay-audio-speech) · [AI](https://api.tu-zi.com/docs/api/reference-relay-audio-speech.md) | `POST /v1/audio/speech` · json | 模型调用 API Key | 文本转语音接口，返回音频二进制内容。 |

### 实时交互 (2)

| 接口与文档 | 方法、路径与传输 | 鉴权 | 用途 |
| --- | --- | --- | --- |
| [Gemini Live WebSocket](https://api.tu-zi.com/docs/api/reference-relay-gemini-live) · [AI](https://api.tu-zi.com/docs/api/reference-relay-gemini-live.md) | `GET /v1beta/live?model={model}` · websocket | 模型调用 API Key | Gemini 原生双向 WebSocket 会话。支持文本、音频、图片和视频输入；模型以 AUDIO 返回，并可通过 outputAudioTranscription 获取同步文本。 |
| [同声传译 WebSocket](https://api.tu-zi.com/docs/api/reference-relay-seed-interpretation) · [AI](https://api.tu-zi.com/docs/api/reference-relay-seed-interpretation.md) | `GET /v1/realtime?model={model}` · websocket | 模型调用 API Key | 使用 Protobuf 二进制帧进行同声传译。 |

### 音乐与声音 (27)

| 接口与文档 | 方法、路径与传输 | 鉴权 | 用途 |
| --- | --- | --- | --- |
| [Suno Add Instrumental](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-add-instrumental) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-add-instrumental.md) | `POST /suno/v2/add-instrumental` · json | 模型调用 API Key | 给人声轨配上完整伴奏。 |
| [Suno Add Vocals](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-add-vocals) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-add-vocals.md) | `POST /suno/v2/add-vocals` · json | 模型调用 API Key | 给纯伴奏加上人声演唱。 |
| [Suno Audio Upload](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-upload) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-upload.md) | `POST /suno/v2/upload` · json | 模型调用 API Key | 上传音频以供其他动作引用。 |
| [Suno Cover](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-cover) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-cover.md) | `POST /suno/v2/cover` · json | 模型调用 API Key | 保留旋律骨架，换一种风格重新演绎。 |
| [Suno Extension](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-extend) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-extend.md) | `POST /suno/v2/extend` · json | 模型调用 API Key | 从指定秒数继续写下去，风格与原曲保持一致。 |
| [Suno Full Stem Separation](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-stems-all) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-stems-all.md) | `POST /suno/v2/stems-all` · json | 模型调用 API Key | 一次拆出全部乐器与人声分轨。 |
| [Suno Lyric Timings](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-aligned-lyrics) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-aligned-lyrics.md) | `POST /suno/v2/aligned-lyrics` · json | 模型调用 API Key | 取歌词逐句的时间轴与整首的波形数据，可用于逐句高亮和绘制音轨图。 |
| [Suno Lyric Writing](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-lyrics) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-lyrics.md) | `POST /suno/v2/lyrics` · json | 模型调用 API Key | 根据主题生成歌词，一次给两份候选。 |
| [Suno MIDI Export](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-gen-midi) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-gen-midi.md) | `POST /suno/v2/gen-midi` · json | 模型调用 API Key | 把曲目转换成 MIDI。 |
| [Suno Mashup](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-mashup) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-mashup.md) | `POST /suno/v2/mashup` · json | 模型调用 API Key | 把两首曲目融合成一首新作。 |
| [Suno Model Training](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-create-model) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-create-model.md) | `POST /suno/v2/create-model` · json | 模型调用 API Key | 用 6 到 24 段音频训练属于你的风格模型。 |
| [Suno Multi-format Export](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-download) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-download.md) | `POST /suno/v2/download` · json | 模型调用 API Key | 导出 mp3、m4a 或 wav。 |
| [Suno Music Generation](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-music) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-music.md) | `POST /suno/v2/music` · json | 模型调用 API Key | 用一句话描述，或自己写歌词，生成完整歌曲，一次出两首。 |
| [Suno Reference Generation](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-inspo) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-inspo.md) | `POST /suno/v2/inspo` · json | 模型调用 API Key | 以一到四段音频作为风格参考来创作。 |
| [Suno Remaster](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-remaster) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-remaster.md) | `POST /suno/v2/remaster` · json | 模型调用 API Key | 在保持原曲结构的前提下重新制作。 |
| [Suno Sample Rework](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-sample) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-sample.md) | `POST /suno/v2/sample` · json | 模型调用 API Key | 截取一段采样，以它为素材生成新曲。 |
| [Suno Section Rewrite](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-replace-section) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-replace-section.md) | `POST /suno/v2/replace-section` · json | 模型调用 API Key | 只重写指定的时间区间，其余部分保持不变。 |
| [Suno Segment Merge](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-concat) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-concat.md) | `POST /suno/v2/concat` · json | 模型调用 API Key | 把续写产生的多段合并为完整曲目。 |
| [Suno Sound Effects](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-sounds) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-sounds.md) | `POST /suno/v2/sounds` · json | 模型调用 API Key | 生成单次音效或可循环音效，可指定节拍与调性。 |
| [Suno Speed Adjustment](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-adjust-speed) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-adjust-speed.md) | `POST /suno/v2/adjust-speed` · json | 模型调用 API Key | 调整播放速度，可选择是否保持音高。 |
| [Suno Stem Layering](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-add-stem) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-add-stem.md) | `POST /suno/v2/add-stem` · json | 模型调用 API Key | 在现有曲目上再加一条乐器轨。 |
| [Suno Style Expansion](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-upsample-tags) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-upsample-tags.md) | `POST /suno/v2/upsample-tags` · json | 模型调用 API Key | 把几个简短标签扩写成详细的风格描述。 |
| [Suno Upload & Cover](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-upload-cover) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-upload-cover.md) | `POST /suno/v2/upload-cover` · json | 模型调用 API Key | 上传你自己的音频，换一种风格重新演绎。 |
| [Suno Upload & Extend](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-upload-extend) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-upload-extend.md) | `POST /suno/v2/upload-extend` · json | 模型调用 API Key | 上传你自己的音频，从指定位置接着写。 |
| [Suno Vocal Separation](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-stems) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-stems.md) | `POST /suno/v2/stems` · json | 模型调用 API Key | 从成曲里分离出主人声，或指定某一条乐器轨。 |
| [Suno Voice Capture](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-persona) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-persona.md) | `POST /suno/v2/persona` · json | 模型调用 API Key | 从一首曲目提取音色，供后续创作复用。 |
| [Suno Voice Cloning](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-create-voice) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-create-voice.md) | `POST /suno/v2/create-voice` · json | 模型调用 API Key | 用一段音频克隆出可复用的音色。 |

### 向量与检索 (2)

| 接口与文档 | 方法、路径与传输 | 鉴权 | 用途 |
| --- | --- | --- | --- |
| [Embeddings](https://api.tu-zi.com/docs/api/reference-relay-embeddings) · [AI](https://api.tu-zi.com/docs/api/reference-relay-embeddings.md) | `POST /v1/embeddings` · json | 模型调用 API Key | 向量化接口，适合检索、相似度匹配与 RAG 场景。 |
| [Jina Rerank](https://api.tu-zi.com/docs/api/reference-relay-jina-rerank) · [AI](https://api.tu-zi.com/docs/api/reference-relay-jina-rerank.md) | `POST /v1/rerank` · json | 模型调用 API Key | 适合排序与召回重排场景，输入 query 与 documents 后返回相关性结果。 |

### 可用模型 (5)

| 接口与文档 | 方法、路径与传输 | 鉴权 | 用途 |
| --- | --- | --- | --- |
| [Gemini 兼容入口模型列表](https://api.tu-zi.com/docs/api/reference-models-gemini-openai) · [AI](https://api.tu-zi.com/docs/api/reference-models-gemini-openai.md) | `GET /v1beta/openai/models` · json | 模型调用 API Key | Gemini 兼容入口模型列表，结果限于当前凭证的可访问范围。 |
| [Gemini 格式模型列表](https://api.tu-zi.com/docs/api/reference-models-gemini) · [AI](https://api.tu-zi.com/docs/api/reference-models-gemini.md) | `GET /v1beta/models` · json | 模型调用 API Key | Gemini 格式模型列表，结果限于当前凭证的可访问范围。 |
| [分页查询模型广场信息](https://api.tu-zi.com/docs/api/reference-models-pricing-paged) · [AI](https://api.tu-zi.com/docs/api/reference-models-pricing-paged.md) | `GET /api/pricing/models` · json | 可匿名；登录后可能不同 | 分页查询模型广场信息。仅返回当前账号可见的数据。 |
| [查询模型元信息](https://api.tu-zi.com/docs/api/reference-model-detail) · [AI](https://api.tu-zi.com/docs/api/reference-model-detail.md) | `GET /v1/models/{model}` · json | 模型调用 API Key | 获取可调用模型。字段和权限以本站接口实现为准。 |
| [获取可调用模型](https://api.tu-zi.com/docs/api/reference-models-list) · [AI](https://api.tu-zi.com/docs/api/reference-models-list.md) | `GET /v1/models` · json | 模型调用 API Key | 获取可调用模型。字段和权限以本站接口实现为准。 |

### 图片与视频任务 (7)

| 接口与文档 | 方法、路径与传输 | 鉴权 | 用途 |
| --- | --- | --- | --- |
| [下载视频任务结果](https://api.tu-zi.com/docs/api/reference-relay-video-content) · [AI](https://api.tu-zi.com/docs/api/reference-relay-video-content.md) | `GET /v1/videos/{task_id}/content` · json | 模型调用 API Key | 下载视频任务结果。以下为本站公开接口契约。 |
| [按请求 ID 查询图片结果](https://api.tu-zi.com/docs/api/reference-relay-image-result) · [AI](https://api.tu-zi.com/docs/api/reference-relay-image-result.md) | `GET /v1/images/generations/result` · json | 模型调用 API Key | 按请求 ID 查询图片结果。以下为本站公开接口契约。 |
| [查询 FLUX 原生图片任务](https://api.tu-zi.com/docs/api/reference-relay-flux-fetch) · [AI](https://api.tu-zi.com/docs/api/reference-relay-flux-fetch.md) | `GET /flux/v1/get_result` · json | 模型调用 API Key | 查询 FLUX 原生图片任务。以下为本站公开接口契约。 |
| [查询 Kling images 任务](https://api.tu-zi.com/docs/api/reference-relay-kling-images-fetch) · [AI](https://api.tu-zi.com/docs/api/reference-relay-kling-images-fetch.md) | `GET /kling/v1/images/{kind}/{task_id}` · json | 模型调用 API Key | 查询 Kling images 任务。以下为本站公开接口契约。 |
| [查询 Kling videos 任务](https://api.tu-zi.com/docs/api/reference-relay-kling-videos-fetch) · [AI](https://api.tu-zi.com/docs/api/reference-relay-kling-videos-fetch.md) | `GET /kling/v1/videos/{kind}/{task_id}` · json | 模型调用 API Key | 查询 Kling videos 任务。以下为本站公开接口契约。 |
| [查询 Midjourney 任务](https://api.tu-zi.com/docs/api/reference-relay-midjourney-fetch) · [AI](https://api.tu-zi.com/docs/api/reference-relay-midjourney-fetch.md) | `GET /mj/task/{task_id}/fetch` · json | 模型调用 API Key | 查询 Midjourney 任务。以下为本站公开接口契约。 |
| [查询统一视频或图片任务](https://api.tu-zi.com/docs/api/reference-relay-video-fetch) · [AI](https://api.tu-zi.com/docs/api/reference-relay-video-fetch.md) | `GET /v1/videos/{task_id}` · json | 模型调用 API Key | 查询统一视频或图片任务。以下为本站公开接口契约。 |

### 音乐任务 (2)

| 接口与文档 | 方法、路径与传输 | 鉴权 | 用途 |
| --- | --- | --- | --- |
| [批量查询 Suno v2 任务](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-fetch-batch) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-fetch-batch.md) | `POST /suno/v2/fetch` · json | 模型调用 API Key | 批量查询 Suno v2 任务。以下为本站公开接口契约。 |
| [查询 Suno v2 任务](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-fetch) · [AI](https://api.tu-zi.com/docs/api/reference-relay-suno-v2-fetch.md) | `GET /suno/v2/fetch/{task_id}` · json | 模型调用 API Key | 查询 Suno v2 任务。以下为本站公开接口契约。 |

### 其他任务与结果 (2)

| 接口与文档 | 方法、路径与传输 | 鉴权 | 用途 |
| --- | --- | --- | --- |
| [查询 Kling audio 任务](https://api.tu-zi.com/docs/api/reference-relay-kling-audio-fetch) · [AI](https://api.tu-zi.com/docs/api/reference-relay-kling-audio-fetch.md) | `GET /kling/v1/audio/{kind}/{task_id}` · json | 模型调用 API Key | 查询 Kling audio 任务。以下为本站公开接口契约。 |
| [查询当前账号任务记录](https://api.tu-zi.com/docs/api/reference-task-list) · [AI](https://api.tu-zi.com/docs/api/reference-task-list.md) | `GET /api/task/self` · json | 系统令牌＋用户 ID，或登录态 | 查询当前账号任务记录，结果限于当前凭证的可访问范围。 |

### 账号信息 (8)

| 接口与文档 | 方法、路径与传输 | 鉴权 | 用途 |
| --- | --- | --- | --- |
| [初始化账号身份（获取用户 ID）](https://api.tu-zi.com/docs/api/reference-account-bootstrap) · [AI](https://api.tu-zi.com/docs/api/reference-account-bootstrap.md) | `GET /api/user/self/bootstrap` · json | 仅账号系统令牌 | 已有系统令牌但不知道用户 ID 时，先调用此接口。 |
| [局部修改个人资料](https://api.tu-zi.com/docs/api/reference-account-patch) · [AI](https://api.tu-zi.com/docs/api/reference-account-patch.md) | `PATCH /api/user/self` · json | 系统令牌＋用户 ID，或登录态 | 局部修改个人资料。以下为本站公开接口契约。 |
| [获取个人信息](https://api.tu-zi.com/docs/api/reference-account-self) · [AI](https://api.tu-zi.com/docs/api/reference-account-self.md) | `GET /api/user/self` · json | 系统令牌＋用户 ID，或登录态 | 获取个人信息。字段和权限以本站接口实现为准。 |
| [获取等级与限制](https://api.tu-zi.com/docs/api/reference-account-level-limits) · [AI](https://api.tu-zi.com/docs/api/reference-account-level-limits.md) | `GET /api/user/self/level_limits` · json | 系统令牌＋用户 ID，或登录态 | 获取等级与限制，结果限于当前凭证的可访问范围。 |
| [获取账号分组与倍率](https://api.tu-zi.com/docs/api/reference-account-groups) · [AI](https://api.tu-zi.com/docs/api/reference-account-groups.md) | `GET /api/user/self/groups` · json | 系统令牌＋用户 ID，或登录态 | 获取账号分组与倍率，结果限于当前凭证的可访问范围。 |
| [获取账号可选模型](https://api.tu-zi.com/docs/api/reference-account-models) · [AI](https://api.tu-zi.com/docs/api/reference-account-models.md) | `GET /api/user/models` · json | 系统令牌＋用户 ID，或登录态 | 获取账号可选模型，结果限于当前凭证的可访问范围。 |
| [读取当前系统令牌](https://api.tu-zi.com/docs/api/reference-account-system-token-current) · [AI](https://api.tu-zi.com/docs/api/reference-account-system-token-current.md) | `GET /api/user/token/current` · json | 系统令牌＋用户 ID，或登录态 | 读取当前系统令牌。仅返回当前账号可见的数据。 |
| [重新生成系统令牌](https://api.tu-zi.com/docs/api/reference-account-system-token-rotate) · [AI](https://api.tu-zi.com/docs/api/reference-account-system-token-rotate.md) | `GET /api/user/token` · json | 系统令牌＋用户 ID，或登录态 | 重新生成系统令牌。仅返回当前账号可见的数据。 |

### API Key 管理 (14)

| 接口与文档 | 方法、路径与传输 | 鉴权 | 用途 |
| --- | --- | --- | --- |
| [修改 API Key](https://api.tu-zi.com/docs/api/reference-token-update) · [AI](https://api.tu-zi.com/docs/api/reference-token-update.md) | `PUT /api/token/` · json | 系统令牌＋用户 ID，或登录态 | 修改 API Key。字段和权限以本站接口实现为准。 |
| [创建 API Key](https://api.tu-zi.com/docs/api/reference-token-create) · [AI](https://api.tu-zi.com/docs/api/reference-token-create.md) | `POST /api/token/` · json | 系统令牌＋用户 ID，或登录态 | 创建 API Key。字段和权限以本站接口实现为准。 |
| [删除 API Key](https://api.tu-zi.com/docs/api/reference-token-delete) · [AI](https://api.tu-zi.com/docs/api/reference-token-delete.md) | `DELETE /api/token/{id}` · json | 系统令牌＋用户 ID，或登录态 | 删除 API Key。字段和权限以本站接口实现为准。 |
| [局部修改 API Key](https://api.tu-zi.com/docs/api/reference-token-patch) · [AI](https://api.tu-zi.com/docs/api/reference-token-patch.md) | `PATCH /api/token/{id}` · json | 系统令牌＋用户 ID，或登录态 | 只更新显式提供的字段；未提供字段保持原值，0 和 false 会被保留。 |
| [批量修改 API Key](https://api.tu-zi.com/docs/api/reference-token-batch-update) · [AI](https://api.tu-zi.com/docs/api/reference-token-batch-update.md) | `POST /api/token/batch/update` · json | 系统令牌＋用户 ID，或登录态 | 批量修改 API Key，结果限于当前凭证的可访问范围。 |
| [批量创建 API Key](https://api.tu-zi.com/docs/api/reference-token-batch-create) · [AI](https://api.tu-zi.com/docs/api/reference-token-batch-create.md) | `POST /api/token/batch/create` · json | 系统令牌＋用户 ID，或登录态 | 创建 API Key。字段和权限以本站接口实现为准。 |
| [批量删除 API Key](https://api.tu-zi.com/docs/api/reference-token-batch-delete) · [AI](https://api.tu-zi.com/docs/api/reference-token-batch-delete.md) | `POST /api/token/batch` · json | 系统令牌＋用户 ID，或登录态 | 批量删除 API Key，结果限于当前凭证的可访问范围。 |
| [批量获取 API Key 明文](https://api.tu-zi.com/docs/api/reference-token-batch-reveal) · [AI](https://api.tu-zi.com/docs/api/reference-token-batch-reveal.md) | `POST /api/token/batch/keys` · json | 系统令牌＋用户 ID，或登录态 | 批量获取 API Key 明文，结果限于当前凭证的可访问范围。 |
| [搜索 API Key](https://api.tu-zi.com/docs/api/reference-token-search) · [AI](https://api.tu-zi.com/docs/api/reference-token-search.md) | `GET /api/token/search` · json | 系统令牌＋用户 ID，或登录态 | 查询 API Key 列表。字段和权限以本站接口实现为准。 |
| [查询 API Key 信息](https://api.tu-zi.com/docs/api/reference-token-detail) · [AI](https://api.tu-zi.com/docs/api/reference-token-detail.md) | `GET /api/token/{id}` · json | 系统令牌＋用户 ID，或登录态 | 查询 API Key 信息。字段和权限以本站接口实现为准。 |
| [查询 API Key 列表](https://api.tu-zi.com/docs/api/reference-token-list) · [AI](https://api.tu-zi.com/docs/api/reference-token-list.md) | `GET /api/token/` · json | 系统令牌＋用户 ID，或登录态 | 查询 API Key 列表。字段和权限以本站接口实现为准。 |
| [查询当前 Key 用量](https://api.tu-zi.com/docs/api/reference-token-usage) · [AI](https://api.tu-zi.com/docs/api/reference-token-usage.md) | `GET /api/usage/token/` · json | 模型调用 API Key | 查询当前 Key 用量。字段和权限以本站接口实现为准。 |
| [获取 API Key 可选分组](https://api.tu-zi.com/docs/api/reference-token-groups) · [AI](https://api.tu-zi.com/docs/api/reference-token-groups.md) | `GET /api/token/group` · json | 系统令牌＋用户 ID，或登录态 | 获取 API Key 可选分组。以下为本站公开接口契约。 |
| [获取完整 API Key](https://api.tu-zi.com/docs/api/reference-token-reveal) · [AI](https://api.tu-zi.com/docs/api/reference-token-reveal.md) | `POST /api/token/{id}/key` · json | 系统令牌＋用户 ID，或登录态 | 获取完整 API Key。字段和权限以本站接口实现为准。 |

### 用量与日志 (19)

| 接口与文档 | 方法、路径与传输 | 鉴权 | 用途 |
| --- | --- | --- | --- |
| [兼容累计用量](https://api.tu-zi.com/docs/api/reference-legacy-billing-usage) · [AI](https://api.tu-zi.com/docs/api/reference-legacy-billing-usage.md) | `GET /v1/dashboard/billing/usage` · json | 模型调用 API Key | 兼容累计用量。兼容旧版客户端的只读接口。 |
| [兼容额度信息](https://api.tu-zi.com/docs/api/reference-legacy-billing-subscription) · [AI](https://api.tu-zi.com/docs/api/reference-legacy-billing-subscription.md) | `GET /v1/dashboard/billing/subscription` · json | 模型调用 API Key | 兼容额度信息。兼容旧版客户端的只读接口。 |
| [导出个人任务记录 CSV](https://api.tu-zi.com/docs/api/reference-task-export) · [AI](https://api.tu-zi.com/docs/api/reference-task-export.md) | `GET /api/task/self/export` · json | 系统令牌＋用户 ID，或登录态 | 导出个人任务记录 CSV。仅返回当前账号可见的数据。 |
| [导出当前 Key 用量 CSV](https://api.tu-zi.com/docs/api/reference-usage-token-export) · [AI](https://api.tu-zi.com/docs/api/reference-usage-token-export.md) | `GET /api/log/token/export` · json | 模型调用 API Key | 导出当前 Key 用量 CSV，结果限于当前凭证的可访问范围。 |
| [导出账号用量 CSV](https://api.tu-zi.com/docs/api/reference-usage-export) · [AI](https://api.tu-zi.com/docs/api/reference-usage-export.md) | `GET /api/log/self/export` · json | 系统令牌＋用户 ID，或登录态 | 导出账号用量 CSV，结果限于当前凭证的可访问范围。 |
| [手动刷新未开始任务](https://api.tu-zi.com/docs/api/reference-task-poll) · [AI](https://api.tu-zi.com/docs/api/reference-task-poll.md) | `POST /api/task/{task_id}/poll` · json | 系统令牌＋用户 ID，或登录态 | 手动刷新未开始任务。仅返回当前账号可见的数据。 |
| [按请求 ID 查询个人日志](https://api.tu-zi.com/docs/api/reference-usage-request-logs) · [AI](https://api.tu-zi.com/docs/api/reference-usage-request-logs.md) | `GET /api/log/self/request/{request_id}` · json | 系统令牌＋用户 ID，或登录态 | 按请求 ID 查询个人日志。仅返回当前账号可见的数据。 |
| [旧日志搜索（已废弃）](https://api.tu-zi.com/docs/api/reference-usage-search-deprecated) · [AI](https://api.tu-zi.com/docs/api/reference-usage-search-deprecated.md) | `GET /api/log/self/search` · json | 系统令牌＋用户 ID，或登录态 | 已废弃入口，不可用于新接入。 |
| [查询个人 Midjourney 任务记录](https://api.tu-zi.com/docs/api/reference-task-midjourney-list) · [AI](https://api.tu-zi.com/docs/api/reference-task-midjourney-list.md) | `GET /api/mj/self` · json | 系统令牌＋用户 ID，或登录态 | 查询个人 Midjourney 任务记录。仅返回当前账号可见的数据。 |
| [查询个人月度日志归档](https://api.tu-zi.com/docs/api/reference-usage-monthly-archives) · [AI](https://api.tu-zi.com/docs/api/reference-usage-monthly-archives.md) | `GET /api/log/self/archive` · json | 系统令牌＋用户 ID，或登录态 | 查询个人月度日志归档。仅返回当前账号可见的数据。 |
| [查询个人看板消费汇总](https://api.tu-zi.com/docs/api/reference-usage-dashboard-stats) · [AI](https://api.tu-zi.com/docs/api/reference-usage-dashboard-stats.md) | `GET /api/data/dashboard_consumption_stats` · json | 系统令牌＋用户 ID，或登录态 | 查询个人看板消费汇总。仅返回当前账号可见的数据。 |
| [查询个人额度历史](https://api.tu-zi.com/docs/api/reference-usage-quota-history) · [AI](https://api.tu-zi.com/docs/api/reference-usage-quota-history.md) | `GET /api/data/self` · json | 系统令牌＋用户 ID，或登录态 | 查询个人额度历史。仅返回当前账号可见的数据。 |
| [查询个人高级用量统计](https://api.tu-zi.com/docs/api/reference-usage-advanced-statistics) · [AI](https://api.tu-zi.com/docs/api/reference-usage-advanced-statistics.md) | `GET /api/log/self/advanced_stat` · json | 系统令牌＋用户 ID，或登录态 | 查询个人高级用量统计。仅返回当前账号可见的数据。 |
| [查询使用日志](https://api.tu-zi.com/docs/api/reference-usage-logs) · [AI](https://api.tu-zi.com/docs/api/reference-usage-logs.md) | `GET /api/log/self` · json | 系统令牌＋用户 ID，或登录态 | 查询使用日志。字段和权限以本站接口实现为准。 |
| [查询分来源消费汇总](https://api.tu-zi.com/docs/api/reference-usage-consumption-stats) · [AI](https://api.tu-zi.com/docs/api/reference-usage-consumption-stats.md) | `GET /api/data/consumption_stats` · json | 系统令牌＋用户 ID，或登录态 | 查询分来源消费汇总。仅返回当前账号可见的数据。 |
| [查询当前 API Key 用量日志](https://api.tu-zi.com/docs/api/reference-usage-token-logs) · [AI](https://api.tu-zi.com/docs/api/reference-usage-token-logs.md) | `GET /api/log/token` · json | 模型调用 API Key | 查询使用日志。字段和权限以本站接口实现为准。 |
| [查询请求的图片或任务结果](https://api.tu-zi.com/docs/api/reference-usage-request-result) · [AI](https://api.tu-zi.com/docs/api/reference-usage-request-result.md) | `GET /api/log/get-request` · json | 模型调用 API Key | 按请求 ID 查询图片结果。以下为本站公开接口契约。 |
| [获取用量汇总](https://api.tu-zi.com/docs/api/reference-usage-summary) · [AI](https://api.tu-zi.com/docs/api/reference-usage-summary.md) | `GET /api/log/self/stat` · json | 系统令牌＋用户 ID，或登录态 | 汇总当前账号已记录的调用、错误、token 和额度。 |
| [获取用量统计](https://api.tu-zi.com/docs/api/reference-usage-statistics) · [AI](https://api.tu-zi.com/docs/api/reference-usage-statistics.md) | `GET /api/log/self/stat` · json | 系统令牌＋用户 ID，或登录态 | 获取用量统计。字段和权限以本站接口实现为准。 |

### 价格与充值 (2)

| 接口与文档 | 方法、路径与传输 | 鉴权 | 用途 |
| --- | --- | --- | --- |
| [查询充值记录](https://api.tu-zi.com/docs/api/reference-topup-records) · [AI](https://api.tu-zi.com/docs/api/reference-topup-records.md) | `GET /api/user/topup/self` · json | 系统令牌＋用户 ID，或登录态 | 查询充值记录。字段和权限以本站接口实现为准。 |
| [获取模型价格](https://api.tu-zi.com/docs/api/reference-model-pricing) · [AI](https://api.tu-zi.com/docs/api/reference-model-pricing.md) | `GET /api/pricing` · json | 可匿名；登录后可能不同 | 获取模型价格。字段和权限以本站接口实现为准。 |

## 模型、价格与错误处理

- [模型广场](https://api.tu-zi.com/pricing)：核对当前型号、端点与展示价格；账号实际权限以鉴权查询结果为准。
- [首次接入](https://api.tu-zi.com/docs/use-cases/getting-started.md)、[协议与端点选择](https://api.tu-zi.com/docs/use-cases/endpoint-matrix.md)、[排障指南](https://api.tu-zi.com/docs/use-cases/troubleshooting.md)。
- 同时检查 HTTP 状态和协议正文中的业务状态。429 应退避；付费生成、创建任务和修改密钥不要盲目重试。
- 本索引仅覆盖已发布的对外接入文档，不自动公开后台内部路由，不包含真实密钥、账号数据或用户请求。
- AI 阅读链接需要联网且有权访问本站。内网测试地址通常不能被外部 AI 访问，此时使用复制总指南及对应接口指南。

内容版本: b176462ac4630cd8be7c0db2ccd5bd260e01c9c2aed4bb325abdd8e6b11d67d1