​

CastarAI API 文档介绍

本文档是 CastarAI 开放平台 的官方 API 参考与接入指南，面向需要将视频生成、图像生成能力集成到自有产品中的开发者。

​

文档说明

• 内容范围：包含认证方式、调用流程、以及全部开放接口的请求/响应说明与在线调试入口。
• 适用场景：适用于服务端调用（如后端服务、脚本、工作流等），所有请求需携带有效的 API Key。
• 能力概览：提供多款主流模型的接口——视频（Sora2、Veo、Kling、Seedance 等）与 图像（Nano Banana、Seedream 等），可按业务需求选择对应接口。

建议先阅读下方「快速开始」完成鉴权与首次调用，再通过左侧 API 参考 查看具体接口并试用「Try it」调试。

---

​

快速开始

​

1. 获取 API Key

请前往 CastarAI 官网 开发者后台申请并获取 API Key。

​

2. 认证方式

所有接口请求均需在 HTTP Header 中携带 API Key：

​

3. 频率限制

• 默认：每分钟 10 次请求。
• 如需更高配额，请联系商务或于开发者后台申请。

---

​

典型调用流程

1. 创建任务：调用对应「视频生成」或「图像生成」接口，传入参数（如 prompt、model 等），接口返回任务 ID。
2. 轮询结果：使用返回的 taskId 调用 「查询任务结果」 接口，根据 status（Pending / Completed / Failed）判断是否完成。
3. 获取资源：当 status 为 Completed 时，从响应中的 urls 获取生成结果的访问地址。

---

​

文档导航

• API 接口说明：按类别列出各接口的简要说明与适用场景，便于快速选型。
• API 参考：完整接口列表与参数说明，支持在页面内「Try it」发起请求、查看响应。