主题
统一生成接口
原生 OpenAPI 支持图片与视频生成。首次接入可先运行快速开始中的免费测试示例,再按实时配置选择正式模型。
Base URL:https://api.video.aistarslab.com/openapi,下方路径均相对于此地址。
通用说明
接口使用 API Key 鉴权,模型与价格从实时配置读取。
鉴权、统一响应、生成类型和任务状态见通用约定。计费类型与公式见计费与退款。
推荐调用流程
- 调用
GET /generation/config获取当前可用图片/视频线路、模型、质量档位、价格和能力。 - 图片生成从
imageConfig中选择channel、model、aspectRatio、quality。 - 视频生成从
videoConfig中选择channel、model、aspectRatio、quality、duration、mode。 - 调用
POST /generation/create/image或POST /generation/create/video创建任务。 - 使用创建接口返回的
taskId调用状态接口轮询结果,多任务同时查询时请使用批量状态接口。
轮询建议
- 建议每 10~15 秒轮询一次,直到任务进入成功或失败终态。
- 多个任务同时查询时,优先使用
POST /generation/status/batch批量状态接口,减少整体请求次数。遇到错误时按错误处理与轮询处理。
接口导航
计费公式与退款规则已移至计费与退款。
测试线路
为方便下游在正式环境联调生成协议,平台提供隐藏测试线路:
表格较宽时,可左右滑动查看完整内容。
| 类型 | channel | model |
|---|---|---|
| 视频测试 | test | test-video |
| 图片测试 | test | test-image |
- 测试线路不会出现在
GET /generation/config返回中。 - 创建测试任务不会扣积分、不会落库、不会调用上游。
- 视频测试任务 ID 以
test_video_开头,图片测试任务 ID 以test_image_开头。 - 查询测试任务会固定返回成功状态
3和测试输出 URL。 - 测试线路仅用于联调鉴权、创建、轮询和结果解析,不代表真实生成能力。
测试视频请求示例
json
{
"channel": "test",
"model": "test-video",
"prompt": "测试视频生成接口",
"aspectRatio": "16:9",
"quality": "720p",
"duration": 5,
"mode": "text2video"
}测试图片请求示例
json
{
"channel": "test",
"model": "test-image",
"prompt": "测试图片生成接口",
"aspectRatio": "16:9",
"quality": "1K",
"n": 1
}