# mote API 文档

> 平台 API 提供文本、媒体生成、文件与素材能力；另提供厂商原生和 APIMart 兼容入口。

[完整文档](llms-full.txt)

## 平台 API

- [快速开始](md/overview.md): 复制本页命令，几分钟内跑通：查询可用模型、生成一张图片、提交并轮询视频或 3D 任务、下载结果，并按报错对照表自行排查。
- [地址与鉴权](md/access.md): 平台 API 共用的当前地址与虚拟密钥，适用于文本调用、媒体生成以及文件和素材操作。
- [接口与状态总览](md/endpoints.md): 平台 API 的文本、媒体生成、任务、文件与素材接口及结果位置速查。
- [模型列表](md/models.md): 查询当前虚拟密钥可用的模型：图片、视频和 3D 用 GET /media/v1/models；GET /v1/models 是含全部类型的通用目录，文本模型从中筛选；含返回示例、字段说明、名称映射和各媒体模型的输入方式；参数取值见各生成页。
- [文本模型调用](md/llm-api.md): 用 Chat Completions、Responses、Messages、Gemini 四种标准协议调用文本模型。
- [文本模型规格](md/llm-catalog.md): 文本模型的规格参考，包含上下文窗口、最大输出长度及协议说明；实际可调用型号以密钥目录为准。
- [媒体请求约定](md/media-access.md): 平台 API 中图片、视频和 3D 请求的公共规则：公共字段、任务等待、幂等重放与重试。
- [图片生成](md/media-images.md): 用 Seedream、Nano Banana / Gemini 或 GPT Image 生成和编辑图片：参数、完整请求、统一任务查询与产物下载。
- [GPT Image 生成与编辑](md/gpt-images.md): GPT Image 2、Sunburst 与 Flare 的两种接入方式：统一媒体任务，以及直接 Images API 的 JSON 参考图、Base64 取图和能力边界。
- [视频生成](md/media-videos.md): 用 Seedance、可灵或 MiniMax H3 生成视频：文生、首帧、首尾帧和多模态参考的输入方式，各模型的参数取值，以及提交、查询和完成后的完整响应。
- [3D 生成](md/media-3d.md): 用混元 3D 或 Tripo 生成 3D 模型：文生、单图、多视图和草图的输入方式，各模型的选项取值，以及提交、查询、下载模型文件的完整流程和响应。
- [任务查询与结算](md/media-tasks.md): 图片、视频和 3D 任务提交后的查询与处理：轮询频率、每种状态的含义和完整响应、产物下载与链接过期处理，以及如何读懂费用状态。
- [任务回调](md/task-callbacks.md): 在任务状态变化时接收通知，校验平台签名，安全去重，再按平台任务 ID 查询结果。
- [参考文件与素材](md/media-files.md): 在同一企业内管理临时参考文件与需审核的厂商素材，用文件 ID 或素材 ID 参与生成。
- [文件与素材约定](md/business-auth.md): 平台 API 中文件和素材操作的输入方式、类型与大小限制、响应格式和错误处理。
- [上传素材](md/business-assets.md): 用虚拟密钥直接上传图片、视频、音频到企业火山素材库，查询审核状态、列出和删除素材。
- [上传文件](md/business-files.md): 上传图片、视频、音频，取得 7 天内有效的下载地址。
- [媒体错误处理](md/media-errors.md): 媒体接口报错排查与处理：错误响应格式、每个错误码的 HTTP 状态和处理方式、常见报错原文对照，以及什么时候该重试、什么时候不能重新提交。

## 厂商原生兼容

- [地址与 SDK](md/official.md): 厂商原生接口的 Base URL、请求路径和 SDK 配置，按所用厂商选择接入方式。
- [方舟文本](md/native-ark-text.md): 使用火山方舟 Chat Completions 路径和 Ark SDK 调用文本模型，读取文本响应或流式增量。
- [Seedream 图片](md/native-seedream.md): Ark 原生格式的同步图片生成，含参考图编辑和 5 Pro 图层拆分。
- [Seedance 视频](md/native-seedance.md): Seedance 2.0 / 2.5 原生视频生成、样片转正式视频、联网搜索及任务列表、查询与取消/删除。
- [Gemini / Nano Banana](md/native-gemini.md): Gemini generateContent 原生图片接口，含同步与 SSE 图片读取、保存和中断处理。
- [MiniMax H3 视频](md/native-h3.md): MiniMax-H3 视频生成、提示词增强、768P 到 2K 再生成，以及任务查询和取消/删除。
- [腾讯混元与 Tripo 3D](md/native-tencent-3d.md): 使用腾讯原生协议提交和查询 3D 生成任务，取得限时下载链接。
- [可灵 / Kling 视频](md/native-kling.md): 可灵 3.0、Turbo、Omni 与动作控制的现代原生请求，以及批量、外部 ID 和游标任务查询。
- [可灵主体与音色](md/native-kling-resources.md): 创建、查询、复用与删除可灵主体和音色，含平台资源 ID、费用及结果未知处理。
- [Midjourney 图片](md/native-mj.md): Midjourney 兼容入口：新版 Imagine 与 U/V 工作流，以及无版本头的旧兼容契约。
- [原生错误处理](md/native-errors.md): 各原生入口的错误包装与常见 HTTP 状态。

## APIMart 兼容

- [地址与接口](md/apimart-access.md): 配置 APIMart 客户端，使用平台虚拟密钥查询模型、提交生成并读取结果。
- [模型列表与名称映射](md/apimart-models.md): 获取当前虚拟密钥可用的 APIMart 模型，了解返回字段及公共名称、平台模型和旧别名的对应关系。
- [图片生成](md/apimart-images.md): 统一异步图片提交：字段、各模型限制与尺寸换算。
- [视频生成](md/apimart-videos.md): 统一异步视频提交：字段白名单、默认值与各模型示例。
- [任务查询与结算](md/apimart-tasks.md): 提交响应、任务状态、结果地址与人民币结算字段。
- [结果下载](md/apimart-content.md): 无需鉴权读取签名下载地址，或带鉴权下载图片、视频二进制；均支持 Range。
- [HTTP 错误](md/apimart-errors.md): 统一错误包装、error.type 对照，以及提交结果待确认时的处理。
- [限流与兼容边界](md/apimart-limits.md): 读取限流、图片队列与执行参数，以及当前未提供的能力。