​

API 接口说明

以下按类别列出各接口的用途与适用场景，便于快速选型。完整请求/响应参数与在线调试请见 API 参考 中各接口页。

---

​

任务查询

​

查询任务结果 GET /openapi/v1/aigc/task/{id}/result

根据任务 ID 查询视频/图像生成任务的状态与结果。任务状态包括：Pending（处理中）、Completed（成功，可从 urls 获取结果地址）、Failed（失败，可查看 failedMessage）。创建任务后需轮询本接口直至状态非 Pending。

---

​

视频生成 · Sora2

​

Sora2 标准版 POST /openapi/v1/aigc/video/sora2/create

使用 Sora2 标准模型根据文本提示词生成短视频，支持竖屏/横屏与分辨率等参数，适合通用短视频生成场景。

​

Sora2 Pro POST /openapi/v1/aigc/video/sora2-pro/create

使用 Sora2 Pro 模型生成视频，在画质与一致性上较标准版更强，适合对质量要求更高的场景。

​

Sora2 Stable POST /openapi/v1/aigc/video/sora2-stable/create

使用 Sora2 Stable 模型生成视频，侧重稳定性与可控性，适合需要更稳定输出的场景。

​

Sora2 Ultra POST /openapi/v1/aigc/video/sora2-ultra/create

使用 Sora2 Ultra 模型生成视频，为 Sora2 系列中的高规格版本，适合追求最高质量的场景。

---

​

视频生成 · Veo

​

Veo 3.1 POST /openapi/v1/aigc/video/veo-3.1/create

使用 Google Veo 3.1 模型根据提示词生成视频，适合需要高质量、自然运动的视频生成。

​

Veo 3.1 Fast POST /openapi/v1/aigc/video/veo-3.1-fast/create

使用 Veo 3.1 Fast 模型快速生成视频，在保证质量的前提下缩短等待时间，适合对时效要求高的场景。

​

Veo 3.1 Pro POST /openapi/v1/aigc/video/veo-3.1-pro/create

使用 Veo 3.1 Pro 模型生成视频，在画质与细节上更优，适合对成品质量要求高的场景。

---

​

视频生成 · 其他

​

Seedance 1.5 Pro POST /openapi/v1/aigc/video/seedance-1.5-pro/create

使用 Seedance 1.5 Pro 模型生成视频，适用于特定风格或场景的视频创作。

​

Kling v2.6 Pro POST /openapi/v1/aigc/video/kling-v2.6-pro/create

使用 Kling v2.6 Pro 模型生成视频，适合需要高质量、多风格支持的视频生成需求。

---

​

图像生成 · Nano Banana

​

Nano Banana Pro POST /openapi/v1/aigc/image/nano-banana-pro/create

使用 Nano Banana Pro 模型根据提示词生成图像，适合通用高清图像生成。

​

Nano Banana Pro Reverse POST /openapi/v1/aigc/image/nano-banana-pro-reverse/create

使用 Nano Banana Pro Reverse 模型生成图像，面向特定风格或反向生成场景。

​

Nano Banana 2 POST /openapi/v1/aigc/image/nano-banana-2/create

使用 Nano Banana 2 模型生成图像，在速度与质量之间取得平衡，适合大批量或实时出图场景。

---

​

图像生成 · Seedream

​

Seedream 4.0 POST /openapi/v1/aigc/image/seedream-4.0/create

使用 Seedream 4.0 模型生成图像，适用于通用图像创作与风格化需求。

​

Seedream 4.5 POST /openapi/v1/aigc/image/seedream-4.5/create

使用 Seedream 4.5 模型生成图像，在 4.0 基础上提升画质与细节，适合对图像质量要求更高的场景。