公共接口 | APIMP

概述

公共接口（Common API）提供与具体模型无关的平台能力，目前分为两类：文件上传 用于把本地素材喂给需要 URL 输入的生成接口；任务管理 用于查询异步任务状态以及通过 Webhook 接收回调。

鉴权

所有公共接口都使用与 AI 模型接口一致的 Bearer Token 鉴权： Authorization: Bearer sk-xxxxxx，与平台颁发的令牌相同。

三种上传方式，返回结构完全一致：图片保留 72 小时，视频保留 24 小时；文件名由服务端生成，统一写入 temp/ 前缀目录。

multipart/form-data 直传本地文件，最常用。

把 Base64 字符串（含 data URL）解码后上传。

平台从远程 URL 拉取文件后上传到对象存储。

图片、视频等任务式接口共用同一套状态查询与回调机制。

GET /api/generate/status/{task_id}，图片 / 视频任务通用。

通过 input.metadata.callback_url 把上游回调透传给你的服务。