接口简介

查询生成物接口

根据任务 ID 查询任务对应的生成物信息，可获取任务运行状态、用量、生成资源地址（视频 / 素材 URL、封面、带水印地址），生成资源链接仅 24 小时有效，需要业务侧及时下载保存资源。

取消生成物接口

取消指定任务ID，取消还没开始执行的任务。

接口详情

查询生成物接口详情

http调用

请求方式：GET

请求路径：https://ai.ctaigw.cn/v1/tasks/{id}/creations

请求头

响应参数

取消生成物接口详情

http调用

请求方式：POST

请求路径：https://ai.ctaigw.cn/v1/tasks/{id}/cancel

请求头

响应参数

取消任务成功返回空值取消任务失败返回错误码

请求/响应示例

查询生成物接口示例

请求

curl -X GET https://ai.ctaigw.cn/v1/tasks/{your_id}/creations \
-H "Content-Type: application/json" \
-H "Authorization: Token ${YOUR_APP_KEY}" \

响应

{
    "id": "your_task_id",
    "state": "success",
    "resolution": "1080p",
    "duration": 5,
    "payload": "",
    "creations": [
        {
            "id": "your_creations_id",
            "url": "your_generated_results_url",
            "cover_url": "your_generated_results_cover_url",
            "watermarked_url": "your_generated_results_watermarked_url"
        }
    ]
}

取消生成物接口示例

请求

curl -X POST https://ai.ctaigw.cn/v1/tasks/{your_id}/cancel \
-H "Content-Type: application/json" \
-H "Authorization: Token ${YOUR_APP_KEY}" \

成功响应

{}

异常响应

{
    "error": {
        "code": "Invalid_request",
        "type": "BadRequest",
        "message": "task state is scheduled, can not cancel",
    }
}