Skip to content

统一生成接口 ​

原生 OpenAPI 支持图片与视频生成。首次接入可先运行快速开始中的免费测试示例,再按实时配置选择正式模型。

Base URL:https://api.video.aistarslab.com/openapi,下方路径均相对于此地址。

通用说明 ​

接口使用 API Key 鉴权,模型与价格从实时配置读取。

鉴权、统一响应、生成类型和任务状态见通用约定。计费类型与公式见计费与退款。

推荐调用流程 ​

  1. 调用 GET /generation/config 获取当前可用图片/视频线路、模型、质量档位、价格和能力。
  2. 图片生成从 imageConfig 中选择 channel、model、aspectRatio、quality。
  3. 视频生成从 videoConfig 中选择 channel、model、aspectRatio、quality、duration、mode。
  4. 调用 POST /generation/create/image 或 POST /generation/create/video 创建任务。
  5. 使用创建接口返回的 taskId 调用状态接口轮询结果,多任务同时查询时请使用批量状态接口。

轮询建议 ​

  • 建议每 10~15 秒轮询一次,直到任务进入成功或失败终态。
  • 多个任务同时查询时,优先使用 POST /generation/status/batch 批量状态接口,减少整体请求次数。遇到错误时按错误处理与轮询处理。

接口导航 ​

模型配置

创建图片

创建视频

查询任务:详情、状态与批量

查询积分

计费公式与退款规则已移至计费与退款。

测试线路 ​

为方便下游在正式环境联调生成协议,平台提供隐藏测试线路:

表格较宽时,可左右滑动查看完整内容。

类型channelmodel
视频测试testtest-video
图片测试testtest-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
}

星辰 AI · 图片与视频生成 API