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

# 图像与视频参数

> 通过模型参数接口确认尺寸、时长、画幅、分辨率和输出格式。

图像与视频模型没有一套适用于全部供应商的固定参数。使用前调用：

```text theme={null}
GET https://api.apione.ai/v1/models/{model}/params
```

## 参数检查表

| 参数类型 | 需要确认的内容 |
| - | - |
| 分辨率 | 模型支持的档位和宽高限制 |
| 时长 | 可选秒数、默认值和计费单位 |
| 画幅 | 横屏、竖屏、方形及自定义比例支持 |
| 水印 | 是否支持关闭、默认行为和合规要求 |
| 码率 | 是否可设置，或由模型自动决定 |
| 输出格式 | URL、Base64、图片格式、MP4、MOV 等支持情况 |
| 参考素材 | URL、Base64、文件标识、数量和大小限制 |
| 生成模式 | 文生图、图像编辑、文生视频、图生视频或参考视频 |

> [!WARNING]
>
> 参数名相同也不代表枚举相同。例如 `resolution`、`quality`、`mode` 在不同模型中可能有不同含义。

## 计费

参数响应可能包含 `billingMode`、`chargeModes` 和模型声明的请求字段。媒体模型可能按请求、按张、按秒或组合规则计费。

实际扣费还会受到 API Key 分组倍率影响。提交前查看模型广场和控制台价格，完成后以请求明细和账单为准。

## MOV 与其他输出格式

只有模型参数明确支持时才请求 MOV 或其他指定格式。如果模型只返回 MP4，不要通过修改文件扩展名伪装成 MOV；需要时在下载后使用合适的转码工具处理。

## 如何读取参数接口

先请求完整 JSON，不要只依赖文档中的静态截图：

```bash theme={null}
curl -sS "https://api.apione.ai/v1/models/YOUR_MEDIA_MODEL/params" \
  -H "Authorization: Bearer YOUR_APIONE_API_KEY"
```

重点查看模型声明的请求字段、类型、枚举、默认值，以及 `billingMode`、`chargeModes` 等计费信息。参数接口没有返回的字段，不应假设一定支持。

## 分辨率与画幅

分辨率描述像素或清晰度档位，画幅描述宽高比例。两者不能互相替代。例如同为 16:9，不同模型可能支持不同像素档位；同一分辨率档位也可能只允许部分画幅。

验证时至少覆盖：默认值、最小值、最大值、横屏、竖屏和不支持的组合。记录实际输出宽高，不能只相信文件名。

## 时长

视频时长可能是固定枚举、范围或由模型自动决定。确认单位是秒、帧还是其他形式，并检查时长是否直接影响费用。请求较长视频前，先用最短时长验证提示词和镜头运动。

## 水印

检查模型是否提供水印控制、默认是否带水印、关闭水印是否需要额外权限。即使接口允许关闭，也要遵守素材授权、平台标识和当地法规要求。

## 码率

多数生成模型可能自动决定码率。只有参数接口明确列出码率字段时才传入。需要稳定交付规格时，可先生成，再在自己的媒体处理流程中转码并验证画质、帧率和音视频同步。

## MP4 与 MOV

| 需求 | 建议 |
| - | - |
| 模型原生支持目标格式 | 使用参数接口列出的格式值 |
| 只返回 MP4，业务需要 MOV | 下载后使用媒体工具转封装或转码 |
| 修改扩展名 | 不可取，容器格式不会因此改变 |
| 判断真实格式 | 检查 MIME、文件头和媒体探测结果 |

## 参数测试矩阵

| 维度 | 最少测试 |
| - | - |
| 分辨率 | 默认、最低、最高、不支持值 |
| 时长 | 最短、常用、最长、越界值 |
| 画幅 | 横屏、竖屏、方形、非法组合 |
| 水印 | 默认行为、显式开关（如支持） |
| 码率 | 默认与自定义值（如支持） |
| 格式 | 默认、MP4、MOV 或其他已声明格式 |
| 素材 | 无素材、单图、多图或视频参考（按模型能力） |

每个用例记录请求 ID、任务 ID、实际参数、输出媒体信息、耗时和费用。这样才能判断“接口接受参数”和“结果真正符合要求”是否一致。

下一步：[图像生成](https://apione.ai/docs/api/images-generations.md)、[图像编辑](https://apione.ai/docs/api/images-edits.md)、[视频生成任务](https://apione.ai/docs/api/videos.md)、[请求跟踪、超时与重试](https://apione.ai/docs/api/request-reliability.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.