图像与视频参数

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

GET https://api.apione.ai/v1/models/{model}/params

参数检查表

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

参数响应可能包含 billingMode、chargeModes 和模型声明的请求字段。媒体模型可能按请求、按张、按秒或组合规则计费。实际扣费还会受到 API Key 分组倍率影响。提交前查看模型广场和控制台价格，完成后以请求明细和账单为准。

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

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

curl -sS "https://api.apione.ai/v1/models/YOUR_MEDIA_MODEL/params" \
  -H "Authorization: Bearer YOUR_APIONE_API_KEY"

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

分辨率描述像素或清晰度档位，画幅描述宽高比例。两者不能互相替代。例如同为 16:9，不同模型可能支持不同像素档位；同一分辨率档位也可能只允许部分画幅。验证时至少覆盖：默认值、最小值、最大值、横屏、竖屏和不支持的组合。记录实际输出宽高，不能只相信文件名。

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

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

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

每个用例记录请求 ID、任务 ID、实际参数、输出媒体信息、耗时和费用。这样才能判断“接口接受参数”和“结果真正符合要求”是否一致。下一步：图像生成、图像编辑、视频生成任务、请求跟踪、超时与重试。