主题
模型配置
所有请求均需携带 API Key。基础地址及响应格式见通用约定。
获取图片与视频配置
作用:查询当前已上架的图片和视频生成配置。
请求:GET /generation/config
请求示例
bash
curl 'https://api.video.aistarslab.com/openapi/generation/config' \
-H "Authorization: Bearer $AISTARSLAB_API_KEY"输入参数
无。
返回参数
HTTP 200 且 response.code=0 时,response.data:
表格较宽时,可左右滑动查看完整内容。
| 属性名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| imageConfig | array<ChannelConfig<ImageModelConfig>> | 是 | 图片生成配置列表 |
| videoConfig | array<ChannelConfig<VideoModelConfig>> | 是 | 视频生成配置列表 |
ChannelConfig
表格较宽时,可左右滑动查看完整内容。
| 属性名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| channel | string | 是 | 线路编码,创建任务时原样提交 |
| title | string | 是 | 展示标题 |
| description | string | 否 | 线路说明 |
| defaultOption | boolean | 是 | 是否为默认线路 |
| models | array<T> | 是 | 当前线路下可用模型;图片配置为 ImageModelConfig,视频配置为 VideoModelConfig |
ImageModelConfig
表格较宽时,可左右滑动查看完整内容。
| 属性名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型编码,创建任务时原样提交 |
| label | string | 是 | 展示名称 |
| qualities | array<ImageQualityOption> | 是 | 质量/清晰度选项 |
| aspectRatios | array<string> | 是 | 支持的画幅比例 |
| n | Range | 是 | 生成数量能力 |
| inputImagesMax | integer | 是 | 输入参考图片数量上限 |
VideoModelConfig
表格较宽时,可左右滑动查看完整内容。
| 属性名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型编码,创建任务时原样提交 |
| label | string | 是 | 展示名称 |
| qualities | array<VideoQualityOption> | 是 | 质量/清晰度选项 |
| modes | array<string> | 是 | 支持的生成模式 |
| aspectRatios | array<string> | 是 | 支持的画幅比例 |
| duration | Range | 是 | 时长能力 |
| inputImagesMax | integer | 是 | 输入参考图片数量上限 |
| inputVideosMax | integer | 是 | 输入参考视频数量上限 |
| inputAudiosMax | integer | 是 | 输入参考音频数量上限 |
Range
表格较宽时,可左右滑动查看完整内容。
| 属性名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| min | integer | 否 | 最小值 |
| max | integer | 否 | 最大值 |
| options | array<integer> | 否 | 离散选项,存在时优先使用 |
Range 使用规则:
options非空时,调用方必须从options中选择一个值,忽略min/max的连续区间含义。options为空或不存在时,调用方应使用min到max范围内的整数值。min或max为空表示该方向不限制;实际是否可用仍以创建接口校验结果为准。
ImageQualityOption
表格较宽时,可左右滑动查看完整内容。
| 属性名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| quality | string | 是 | 质量/清晰度编码,创建任务时原样提交 |
| pricing | Pricing | 是 | 当前质量/清晰度的计费规则 |
VideoQualityOption
表格较宽时,可左右滑动查看完整内容。
| 属性名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| quality | string | 是 | 质量/清晰度编码,创建任务时原样提交 |
| pricing | VideoPricing | 是 | 当前质量/清晰度的计费规则 |
Pricing
表格较宽时,可左右滑动查看完整内容。
| 属性名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | string | 是 | 计费类型,见计费与退款 |
| credits | integer | 是 | 积分数;按秒计费时表示每秒积分 |
VideoPricing
包含 Pricing 的全部字段,并额外包含:
表格较宽时,可左右滑动查看完整内容。
| 属性名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| inputVideoMultiplier | number | 是 | 请求包含参考视频 inputVideos 时,基础积分使用的倍率 |
计费公式和退款规则见计费与退款。
配置响应示例
以下仅用于说明字段结构,实际可用配置以接口实时返回为准:
json
{
"code": 0,
"msg": "success",
"data": {
"imageConfig": [
{
"channel": "21",
"title": "图片生成线路",
"description": "支持文生图和参考图生成",
"defaultOption": true,
"models": [
{
"model": "example-image-model",
"label": "Example Image",
"qualities": [
{
"quality": "1K",
"pricing": {"type": "fixed_total", "credits": 100}
}
],
"aspectRatios": ["1:1", "16:9", "9:16"],
"n": {"min": 1, "max": 1, "options": null},
"inputImagesMax": 9
}
]
}
],
"videoConfig": [
{
"channel": "12",
"title": "视频生成线路",
"description": "支持文生视频和参考图视频",
"defaultOption": true,
"models": [
{
"model": "example-video-model",
"label": "Example Video",
"qualities": [
{
"quality": "720p",
"pricing": {
"type": "per_second",
"credits": 52,
"inputVideoMultiplier": 1.5
}
}
],
"modes": ["text2video", "image2video"],
"aspectRatios": ["16:9", "9:16", "1:1"],
"duration": {"min": 4, "max": 15, "options": null},
"inputImagesMax": 9,
"inputVideosMax": 3,
"inputAudiosMax": 5
}
]
}
]
}
}