开发者文档 输入素材
输入素材
参考图、视频和音频直接写在生成请求里:URL、base64 或表单文件。
MossHub 不保存文件,也没有素材上传接口。参考图、视频和音频随生成请求一起提交,由 MossHub 原样转给上游;素材 URL 也由上游自己读取。
写在哪里
| 接口 | 位置 | 形式 |
|---|---|---|
OpenAI Images(/v1/images/edits) | 表单里的图片文件,或 JSON 的 images[].image_url | 文件、URL 或 base64 |
| 火山方舟图片 | image,一张或一组 | URL 或 base64 |
| Gemini | contents[].parts[].inlineData,含 mimeType 与 data | base64 |
| MiniMax 视频、火山方舟视频 | content 数组里 type 为 image_url、video_url 或 audio_url 的项,地址写在同名对象的 url | URL 或 base64 |
视频任务里的一张参考图:
{ "type": "image_url", "image_url": { "url": "https://example.com/first-frame.png" } }不接受的写法
下列请求直接返回 400,不会发给上游:
- 引用存放在上游的文件:OpenAI Images 的
file_id,火山方舟图片和视频任务里以mm_file://或asset://开头的地址,Gemini 的fileData与cachedContent。 - 视频任务里,内容项带的素材字段与它的
type不一致,例如type为image_url却带了video_url。
大小与计费
- 素材算在请求体里,请求体最多 32 MiB,超出返回 413;大文件请传 URL。
- 素材也计费:OpenAI Images 计输入图片 token,火山方舟图片计输入图片张数,MiniMax 视频计输入图片张数和输入视频秒数;火山方舟视频带视频输入时可能适用另一档价格。单价见控制台模型详情的「价格」。
实际可调用的模型、授权与价格以控制台为准。
页面字体:MiSans(小米,依《MiSans 字体知识产权许可协议》使用);Google Sans Flex(SIL Open Font License 1.1)。
页面字体:MiSans(小米,依《MiSans 字体知识产权许可协议》使用);Google Sans Flex(SIL Open Font License 1.1)。