1. # 概述本文档为创作Agent OpenAPI 的官方接入指引。旨在帮助开发者通过 API 接口，快速、高效地集成和使用平台提供的 AI 能力，如一键成片、风格化图生图、图生视频等。 2. # 快速开始仅需两步即可完成您的首次 API 调用： 1. **申请 API Key**：在[火山-创作Agent控制台](https://console.volcengine.com/kickart/fusion/setting/api-key)获取用于OpenAPI请求的 API Key。 2. **调用接口**：根据本文档的指引，构造 HTTP 请求，并通过 API Key 进行鉴权，发起接口调用。 *\*调用 API 须确认有权使用所提交的信息及内容，承诺上传的人像素材均为已授权虚拟人像，并已阅读且同意*[《虚拟人像合规承诺函》](https://www.volcengine.com/docs/6664/2369812?lang=zh)*与*[《合规承诺函》](https://www.volcengine.com/docs/6664/2369383?lang=zh) 3. # 对外域名 **对外域名: ** [https://kickart.volces.com](https://kickart.volces.com) 4. # APIKey 申请 1. 请通过主账号登录[创作Agent首页](https://console.volcengine.com/kickart)。 2. 导航至 [kickart-apikey申请页面](https://console.volcengine.com/kickart/fusion/setting/api-key) 。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_4b006d19db2761172afee08a10ffdf0a.png) 3. 在左侧菜单中选择 **「API Key」** 模块，然后点击 **「+New」** 按钮。 4. 输入 API Key 名称后，点击 **「Create」** 按钮完成创建。 5. 创建成功后，您将获得一个 API Key。请妥善保管此密钥，它将作为您调用所有接口的唯一凭证。 **权限说明**：在调用接口前，请确保您的账户已开通相关服务的访问权限。若在调用过程中遇到权限问题，请联系您的企业管理员或火山引擎商务代表。 1. ## 鉴权方式所有 API 接口均采用基于 HTTP Header 的 Bearer Token 鉴权方案。您需要在每次请求的 Header 中附带 Authorization 和 Content\-Type 字段。 |**Header** |**说明** | |---|---| |Authorization |认证凭证。格式必须为 Bearer {API_KEY}，其中 {API_KEY} 需要替换为您在创作Agent平台申请到的真实 API Key。

**示例**: Bearer 1jkdislxdsldjgeouqllsj8ko8gssccx | |Content\-Type |请求体的内容类型。固定值为 application/json。 | --- 5. # 模板说明 |

模板 ID

模板说明

创点消耗【按成片时长计费】

| |---|---|---| |**226527799033910** |快速模式 \* 商品介绍视频

|* ≤ 15s ：0.21

* 15～30s：0.42

* 30～45s：0.64

* 45～60s：0.85 | |**942434435766526** |专业模式 \* 商品介绍视频 |* ≤ 15s ：1.75

* 15～30s：3.5

* 30～45s：5.25

* 45～60s：7 | |**229258712400375** |快速模式 \* 商品主图视频 |* ≤ 15s ：0.21

* 15～30s：0.42 | |**219738521707985** |专业模式 \* 商品主图视频 |* ≤ 15s ：1.75

* 15～30s：3.5 | 6. # 接口说明 ## 6.1 提交异步任务 ## 该接口用于提交一个一键成片API的异步处理任务。调用成功后，会立即返回一个任务 ID (task_id)，您可以使用此 ID 来查询任务的执行状态和最终结果。 * **请求方法**：POST * **请求路径**：/openapi/ai_effect/submit ### 请求参数 |**字段名** |中文 |**类型** |**必填** |**示例** |**描述** | |---|---|---|---|---|---| |template_id

|模板 ID |string |是 |60001 |要使用的模板 ID。请从“模板说明”表格中获取

| |payload |参数 |json

|是 |参考下方示例

| JSON Object，用于传递模板渲染所需的具体参数。其内部结构见下文。 | |callback_url

|回调地址 |string

|否 |回调任务结果的公网地址。

|当任务完成（无论成功或失败）时，系统会向此 URL 发送一个 POST 请求，通知您结果。

回调结果就是查询的响应参数 | |watermark

|明水印 |boolean |否 |true

默认 false |视频右下角是否添加“AI生成”水印，若需添加则传入true | |无需传入, 会读取 saas 页面中的配置

|暗水印 |无需传入

|否 |和你的 saas 中配置保持一致

|

| payload 结构 |**字段名** |类型 |**必填** |说明 |**描述 or 举例** | |---|---|---|---|---| |product_url |string |否 |输入抖店商品链接 |商品链接和商品ID同时存在的情况，取商品ID

* "product_url": "https://v.douyin.com/kqj4dPmj55k/"

* "product_id": "172839182"

获取抖店商品链接、ID请参考：[抖音商品ID、商品详情页链接怎么获取？](https://www.volcengine.com/docs/6664/1319938?lang=zh) | |product_id |string |否 |输入抖店商品ID || |duration

| int

|是

|期望视频时长，AI生成可能小部分情况存在时长差异

|商品介绍视频:

* 15

* 30

* 45

* 60

商品主图视频：

* 15

* 30 | |aspect_ratio |string |否 |视频比例，需遵循 SaaS 平台约束。默认9:16 |9:16, 16:9, 3:4, 4:3, 1:1 | |language |string |否 |视频语言，影响口播、字幕等。默认为中文。 |zh, en, pt\-br | |purpose

|string |否 |商品介绍视频支持选择一个细分分类，默认“好物推荐”，商品主图视频无

|商品介绍视频：支持选择一个细分分类

* 品牌广告

* 好物推荐

* 剧情演绎

* 测评对比

* 日常Vlog

* 开箱直拍型（仅海外）

商品主图视频：无 | |prompt |string |否 |创意指令，描述视频的核心内容、风格与卖点。

|"为一款保湿面霜制作一支突出天然成分和补水效果的视频，风格清新自然。" | |user_images

|array |否

user_images 和 user_videos 至少有一个 |用户提供的图片列表

|["https://lf3\-static.bytednsdoc.com/obj/eden\-cn/eteh7pbopxnuhf/IbcFBYHFrw20240701235334.jpg", "https://lf3\-static.bytednsdoc.com/obj/eden\-cn/eteh7pbopxnuhf/800.jpg"]

| |user_videos |array |否

user_images 和 user_videos 至少有一个 |用户提供的视频列表 |["https://lf3\-static.bytednsdoc.com/obj/eden\-cn/nulozubqbd/product/02177484069763200000000000000000000ffffac15dcc482d342.mp4"] | ### 响应参数 |**字段名** |**类型** |**描述** | |---|---|---| |code |int32 |状态码。0 表示任务已成功提交。非 0 值表示提交失败，原因见 message 字段。 | |message |string |状态描述信息。 | |request_id |string |本次请求的唯一标识符，可用于问题排查。 | |data |object |包含任务 ID 的数据对象。其结构为 **{"task_id": "..."}** 。 | ### cURL 请求示例 ```Bash curl --location 'https://kickart.volces.com/openapi/ai_effect/submit' \ --header 'Authorization: Bearer {API_KEY}' \ --header 'Content-Type: application/json' \ --data '{ "template_id": "219738521707985", "callback_url": "https://muse.console.volcengine.com/api/muse/product/13477/callback", "payload": { "user_images": [ "https://lf3-static.bytednsdoc.com/obj/eden-cn/eteh7pbopxnuhf/下载 - 2025-07-30T214748.196 (1).png", "https://lf3-static.bytednsdoc.com/obj/eden-cn/eteh7pbopxnuhf/IbcFBYHFrw20240701235334.jpg", "https://lf3-static.bytednsdoc.com/obj/eden-cn/eteh7pbopxnuhf/800x (2).jpg" ], "user_videos": [ "https://lf3-static.bytednsdoc.com/obj/eden-cn/nulozubqbd/product/02177484069763200000000000000000000ffffac15dcc482d342.mp4" ], "prompt": "制作一个产品广告片，莫奈印象派油画风格。", "duration": 15, "purpose": "好物推荐", "language": "zh", "aspect_ratio": "9:16" } } }' ``` ### 响应示例（成功） ```JSON { "code": 0, "data": { "task_id": "7621886649043206198" //用来做查询任务的入参, 也可以等待callback }, "message": "success", "request_id": "20260330132131910C619A3D2F5FF87656" } ``` ### 响应示例（失败） ```JSON { "code": 1410, // 请参考6.4 通用错误码 "data": {}, "message": "template_id not exist", "request_id": "202603301322133EB7BAD7D1B156F75CF7" } ``` ### 代码示例 |python |node |golang | |---|---|---| |```Python```
```import requests```
```import json```
``````
```API_KEY = "your_api_key_here"```
```TEMPLATE_ID = "your_template_id_here" #参考模版说明中的4个模板ID```
```CALLBACK_URL = None```
```RESOLUTION = None```
``````
```BASE_URL = "https://kickart.volces.com"```
``````
```headers = {```
``` "Authorization": f"Bearer {API_KEY}",```
``` "Content-Type": "application/json"```
```}```
``````
```url = f"{BASE_URL}/openapi/ai_effect/submit"```
``````
```payload = {```
``` # 参考 payload 结构```
```}```
``````
```data = {```
``` "template_id": TEMPLATE_ID,```
``` "payload": payload```
```}```
```if CALLBACK_URL:```
``` data["callback_url"] = CALLBACK_URL```
``````
```try:```
``` response = requests.post(url, headers=headers, data=json.dumps(data))```
``` response.raise_for_status()```
``` result = response.json()```
``` ```
``` if result.get("code") == 0 and result.get("data"):```
``` task_id = result["data"]["task_id"]```
``` else:```
``` print(f"submit task failed: {result.get('message', 'Unknown error')}")```
``````
```except requests.exceptions.RequestException as e:```
``` print(f"error: {e}")```
```except Exception as e:```
``` print(f"error: {e}")```
|```JavaScript```
```const BASE_URL = 'https://kickart.volces.com';```
``````
```const API_KEY = 'YOUR_API_KEY';```
```const TEMPLATE_ID = 'YOUR_TEMPLATE_ID'; // 参考模板说明中的4个模板ID```
```*```
```const CALLBACK_URL = 'https://your-domain.com/callback';```
``````
```async function submitTask() {```
``` const url = `${BASE_URL}/openapi/ai_effect/submit`;```
``` ```
``` const requestBody = {```
``` template_id: TEMPLATE_ID,```
``` payload: {```
``` // 参考 payload 结构```
``` },```
``` callback_url: CALLBACK_URL```
``` };```
``````
``` try {```
``` const response = await fetch(url, {```
``` method: 'POST',```
``` headers: {```
``` 'Authorization': `Bearer ${API_KEY}`,```
``` 'Content-Type': 'application/json'```
``` },```
``` body: JSON.stringify(requestBody)```
``` });```
``````
``` if (!response.ok) {```
``` throw new Error(`HTTP error! status: ${response.status}`);```
``` }```
``````
``` const result = await response.json();```
``` ```
``` return result;```
``` } catch (error) {```
``` console.error('error:', error);```
``` throw error;```
``` }```
```}```
``````
```submitTask();```
|```Go```
```package main```
``````
```import (```
``` "bytes"```
``` "encoding/json"```
``` "fmt"```
``` "io"```
``` "net/http"```
``` "time"```
```)```
``````
```func SubmitTask() {```
``` const (```
``` apiKey = "YOUR_API_KEY"```
``` templateID = "YOUR_TEMPLATE_ID"```
``` callbackURL = "YOUR_CALLBACK_URL"```
``` resolution = "1080p"```
``` )```
``````
``` resourceList := []string{"resource_url_1", "resource_url_2"}```
``````
``` requestBody := map[string]interface{}{```
``` "template_id": templateID,```
``` "payload": map[string]interface{}{```
``` "resource_list": resourceList,```
``` "resolution": resolution,```
``` },```
``` "callback_url": callbackURL,```
``` }```
``````
``` body, err := json.Marshal(requestBody)```
``` if err != nil {```
``` return```
``` }```
``````
``` url := "https://kickart.volces.com/openapi/ai_effect/submit"```
``` req, err := http.NewRequest("POST", url, bytes.NewReader(body))```
``` if err != nil {```
``` return```
``` }```
``````
``` req.Header.Set("Authorization", "Bearer "+apiKey)```
``` req.Header.Set("Content-Type", "application/json")```
``````
``` client := &http.Client{```
``` Timeout: 30 * time.Second,```
``` }```
``````
``` resp, err := client.Do(req)```
``` if err != nil {```
``` return```
``` }```
``` defer resp.Body.Close()```
``````
``` respBody, err := io.ReadAll(resp.Body)```
``` if err != nil {```
``` return```
``` }```
``````
``` var response map[string]interface{}```
``` if err := json.Unmarshal(respBody, &response); err != nil {```
``` return```
``` }```
``````
``` if data, ok := response["data"].(map[string]interface{}); ok {```
``` fmt.Printf("task_id: %s\n", data["task_id"])```
``` }```
``` fmt.Printf("response: %s\n", string(respBody))```
```}```
| ```JSON { "code": 0, "message": "success", "request_id": "2024031211223301017205503512345678", "data": { "task_id": "7573967600885514303" } } ``` --- ## 6.2 查询任务结果 ## 在提交异步任务后，您可以通过此接口，使用 task_id 来轮询任务的执行状态和最终结果（例如生成的图片或视频 URL）。 * **请求方法**：POST * **请求路径**：/openapi/ai_effect/query * **Timeout** : 3600 秒 ### 请求参数 |**字段名** |**类型** |**必填** |**示例** |**描述** | |---|---|---|---|---| |task_id |string |是 |"7573967600885514303" |要查询的任务 ID，来源于“提交异步任务”接口的成功响应。 | ### 响应参数响应体中的 code 字段指示了任务的当前状态。您需要依据此字段来判断任务是仍在进行、已成功还是已失败。 |**字段名** |**类型** |**描述** | |---|---|---| |code

|i32

|任务状态码。关键值包括：

* 0: 任务执行成功。

* 1000: 任务仍在运行中。

其他非零值表示任务失败，具体含义请参考“错误码说明”章节。 | |message |string |任务状态的文本描述。例如 "Success" 或 "AsyncTaskRunning"。 | |request_id |string |本次请求的唯一标识符。 | |data |[queryData](https://bytedance.larkoffice.com/docx/TO7cdlwIBoXhP9xJ1C6cII4Gnrd?contentTheme=DARK&last_doc_message_id=7622959140566371552&preview_comment_id=7622959347257215958&sourceType=feed&theme=light#doxcnMaJyF9OiMw0QFcjc5QktXe) |包含任务详细信息的对象，见下文 QueryData 结构。 | #### queryData |**字段名** |**类型** |**描述** | |---|---|---| |task_id |string |任务的唯一 ID | |usage |double |本次任务消耗的创点数量，仅在任务成功时有效 | |payload |[payload](https://bytedance.larkoffice.com/docx/TO7cdlwIBoXhP9xJ1C6cII4Gnrd?contentTheme=DARK&last_doc_message_id=7622959140566371552&preview_comment_id=7622959347257215958&sourceType=feed&theme=light#doxcnwyrFB4rwbhrJNqFM8yb76g) |任务详情 | #### payload 任务结果详情，不同类型任务的结果字段可能存在差异，以下字段为结果公共字段。 |**字段名** |**类型** |**描述** | |---|---|---| |result_url |string |任务结果地址 | **关于 result_url 的有效期** 请注意，响应中返回的 result_url 具有有效期，我们保证其在任务完成后 **24 小时** 内可用。为避免资源失效，请您在获取到 URL 后尽快下载所需的文件。 ### cURL 请求示例 ```Bash curl --location 'https://kickart.volces.com/openapi/ai_effect/query' \ --header 'Authorization: Bearer {API_KEY}' \ --header 'Content-Type: application/json' \ --data '{ "task_id": "7641408408654053419" }' ``` ### 响应示例（任务成功） ```JSON { "code": 0, "data": { "payload": { "produce_id": "1fe8d587-7eb3-4094-8624-1abc847e9248", "result_url": "https://lf11-river-service-sign.volccdn.com/river-service/tmp/c1da9aa0-ea65-422b-8e1e-04823913a84a.mp4?x-expires=1779242442&x-signature=3wXoQlARIoJZgYdJBp4q5IjsRvg%3D" }, "progress": 100, "task_id": "7641408408654053419", "usage": 1.75 }, "message": "success", "request_id": "2026051910015945648877F6FC74B0146A" } ``` ### 响应示例（任务进行中） ```JSON { "code": 1000, "data": { "task_id": "7618132941507395592" }, "message": "running", "request_id": "20260317183056FA38F2B3914E1A517D02" } ``` ### 响应示例（任务失败） ```JSON { "code": 1413, "data": { "task_id": "7618132941507395594" }, "message": "ResourceDownloaderError:Failed to get resource, status: 404", "request_id": "202603171842504BE68774F527685BBBC0" } ``` --- ### 代码示例 |python |node |golang | |---|---|---| |```Python```
``` import requests```
```import json```
``````
```BASE_URL = "https://kickart.volces.com"```
```API_KEY = "YOUR_API_KEY"```
```TASK_ID = "YOUR_TASK_ID"```
``````
```def query_task():```
``` url = f"{BASE_URL}/openapi/ai_effect/query"```
``` ```
``` headers = {```
``` "Authorization": f"Bearer {API_KEY}",```
``` "Content-Type": "application/json"```
``` }```
``` ```
``` data = {```
``` "task_id": TASK_ID```
``` }```
``` ```
``` try:```
``` response = requests.post(url, headers=headers, data=json.dumps(data))```
``` response.raise_for_status()```
``` ```
``` result = response.json()```
``` print(json.dumps(result, indent=2, ensure_ascii=False))```
``` ```
``` if result.get("code") == 0:```
``` print(f"task id: {result.get('data', {}).get('task_id')}")```
``` if result.get('data', {}).get('usage') is not None:```
``` print(f"usage: {result['data']['usage']:.2f}")```
``` if result.get('data', {}).get('payload'):```
``` print("result payload:")```
``` print(json.dumps(result['data']['payload'], indent=2, ensure_ascii=False))```
``` else:```
``` print(f"\nquery failed: {result.get('message')}")```
``` ```
``` except requests.exceptions.RequestException as e:```
``` print(f"error: {e}")```
``` except Exception as e:```
``` print(f"error: {e}")```
``````
```if __name__ == "__main__":```
``` query_task()```
|```JavaScript```
```const BASE_URL = 'https://kickart.volces.com';```
```const API_KEY = 'YOUR_API_KEY';```
```const TASK_ID = 'YOUR_TASK_ID';```
``````
```async function queryTask() {```
``` const url = `${BASE_URL}/openapi/ai_effect/query`;```
``` const requestBody = {```
``` task_id: TASK_ID```
``` };```
``````
``` try {```
``` const response = await fetch(url, {```
``` method: 'POST',```
``` headers: {```
``` 'Authorization': `Bearer ${API_KEY}`,```
``` 'Content-Type': 'application/json'```
``` },```
``` body: JSON.stringify(requestBody)```
``` });```
``````
``` if (!response.ok) {```
``` throw new Error(`HTTP error! status: ${response.status}`);```
``` }```
``````
``` const data = await response.json();```
``````
``` if (data.code === 0) {```
``` console.log(`task id: ${data.data.task_id}`);```
``` if (data.data.usage) {```
``` console.log(`usage: ${data.data.usage.toFixed(2)}`);```
``` }```
``` if (data.data.payload) {```
``````
``` console.log(JSON.stringify(data.data.payload, null, 2));```
``` }```
``` } else {```
``` console.log('\nquery task failed:', data.message);```
``` }```
``` } catch (error) {```
``` console.error('query task failed:', error);```
``` }```
```}```
``````
```queryTask();```
|```Go```
```package main```
``````
```import (```
``` "bytes"```
``` "encoding/json"```
``` "fmt"```
``` "io"```
``` "net/http"```
``` "time"```
```)```
``````
```func QueryTask() {```
``` const (```
``` apiKey = "YOUR_API_KEY"```
``` taskID = "YOUR_TASK_ID"```
``` )```
``````
``` requestBody := map[string]interface{}{```
``` "task_id": taskID,```
``` }```
``````
``` body, err := json.Marshal(requestBody)```
``` if err != nil {```
``````
``` return```
``` }```
``````
``` url := "https://kickart.volces.com/openapi/ai_effect/query"```
``` req, err := http.NewRequest("POST", url, bytes.NewReader(body))```
``` if err != nil {```
``` ```
``` return```
``` }```
``````
``` req.Header.Set("Authorization", "Bearer "+apiKey)```
``` req.Header.Set("Content-Type", "application/json")```
``````
``` client := &http.Client{```
``` Timeout: 30 * time.Second,```
``` }```
``````
``` resp, err := client.Do(req)```
``` if err != nil {```
``` return```
``` }```
``` defer resp.Body.Close()```
``````
``` respBody, err := io.ReadAll(resp.Body)```
``` if err != nil {```
``` return```
``` }```
``````
``` var response map[string]interface{}```
``` if err := json.Unmarshal(respBody, &response); err != nil {```
``` return```
``` }```
``````
``` if data, ok := response["data"].(map[string]interface{}); ok {```
``` fmt.Printf("task_id: %s\n", data["task_id"])```
``` if usage, ok := data["usage"]; ok {```
``` fmt.Printf("usage: %.2f\n", usage)```
``` }```
``` if payload, ok := data["payload"]; ok {```
``` fmt.Printf("task result: %v\n", payload)```
``` }```
``` }```
``` fmt.Printf("response: %s\n", string(respBody))```
```}```
| ## 6.3 取消异步任务 ## 在提交异步任务后，您可以通过此接口，使用 task_id 来轮询任务的执行状态、处理进度和最终结果（例如生成的图片或视频 URL）。 * **请求方法**：POST * **请求路径**：/openapi/ai_effect/cancel * **Timeout** : 3600 秒 ### 请求参数 |**字段名** |**类型** |**必填** |**示例** |**描述** | |---|---|---|---|---| |task_id |string |是 |"7573967600885514303" |要取消的任务 ID，来源于“提交异步任务”接口的成功响应。 | ### 响应参数响应体中的 code 字段指示了任务是否取消成功，您需要依据此字段来判断任务是否已经成功取消或发起重试。 |**字段名** |**类型** |**描述** | |---|---|---| |code

|i32

|任务状态码。关键值包括：

* 0：取消成功

* 1602：任务已取消

* 1603：任务已结束，不可取消

* 1604：任务取消失败，稍后重试

其他非零值表示任务失败，具体含义请参考“错误码说明”章节。 | |message |string |任务状态的文本描述。例如 "Success"。 | |request_id |string |本次请求的唯一标识符。 | ### cURL 请求示例 ```Bash curl --location 'https://kickart.volces.com/openapi/ai_effect/cancel' \ --header 'Authorization: Bearer {API_KEY}' \ --header 'Content-Type: application/json' \ --data '{ "task_id": "7620360162389278779" }' ``` ### 响应示例（取消成功） ```JSON { "code": 0, "message": "success", "request_id": "202603171105302BE4CA2F5B03C331AEBD" } ``` ### 响应示例（取消失败） ```JSON { "code": 1604, "message": "river cancel failed", "request_id": "202603171842504BE68774F527685BBBC0" } ``` --- ### 代码示例 |python |node |golang | |---|---|---| ## 6.4错误码说明所有接口的响应体中都包含 code 和 message 字段，用于指示请求的处理结果。当 code 为 0 时，表示业务处理成功。非 0 值表示出现了异常。 ### 通用错误码 |错误码 |错误类型(标记用, 不会返回) |描述与处理建议 | |---|---|---| |1300 |AuthFailed

|**认证失败**：API Key 无效、过期或未激活。请检查您的 API Key 是否正确，或在火山引擎控制台确认其状态。 | |1400 |ParamErr

|**参数错误**：请求中包含无效或缺失的参数。请对照文档检查请求体结构、字段类型和必填项。 | |1401 |ConcurrentErr

|**并发超限**：您当前的并发请求数超过了约定的上限。请降低请求频率，或联系商务代表调整并发额度。 | |1403 |QuotaErr |**无权限**：您的账户没有调用此接口的权限。请联系企业管理员为您开通相关服务的访问权限。 | |1402

|InsufficientPoints

|**创点不足**：账户余额不足以支付本次任务消耗。请及时充值。 | |1418 |InvalidDurationBillingErr |**无效时长参数**：入参时长参数不满足接口入参要求 | |1500 |InternalErr |**内部错误**：服务端发生未知错误。请记录 request_id 并联系技术支持。 | ### 接口特定错误码 #### /openapi/ai_effect/submit & /openapi/ai_effect/query & /openapi/ai_effect/cancel |错误码 |错误类型(标记用, 不会返回) |描述与处理建议 | |---|---|---| |0 |Success |**任务成功**：任务处理完成，结果已生成。 | |1000 |AsyncTaskRunning

|**任务运行中**：任务正在处理，请稍后通过 AITemplateAsyncTaskQuery 接口轮询结果。 | |1410 |TemplateIdNotExist

|**模板不存在**：请求的 template_id 无效或对应的模板未上线。请通过 ListTemplateInfo 接口获取可用的模板列表。 | |1411 |InputResolutionErr |**分辨率错误**：请求的 Resolution 不在模板支持的 resolutions 列表内。 | |1412 |ImageFormatErr |**图片格式错误**：输入的图片格式不受支持或文件已损坏。建议使用常见的 JPEG 或 PNG 格式。 | |1413 |InvalidMediaUrlErr |**媒体 URL 无效**：payload.user_images 中的 URL 无法访问。请确保 URL 是公网可达的，且未过期。 | |1414 |MediaSensitiveErr |**内容安全问题**：输入内容触发了平台的安全审核策略。请更换内容后重试。 | |1415 |OutputMediaSensitiveErr |**内容安全问题**：输出内容触发了平台的安全审核策略。请更换内容后重试。 | |1417 |ChatCompletionError |**大模型调用错误：** 大模型在调用时抛出的异常，请根据具体的错误信息进行重试。 | |1418 |InvalidDurationBillingErr |时长计费参数错误 | |1419 |TemplateIdErr |模板ID传错 | |1420 |ImageDetectionRulesError |输入图片内容检测未匹配到规则错误(如人脸大小, 宠物等) | |1421 |DurationEnumError

|**入参时长枚举值错误：** 入参时长参数不满足接口入参枚举值要求 | |1600 |AsyncTaskNotExist |**任务不存在**：查询的 task_id 无效。请检查 task_id 是否为 AITemplateAsyncTaskSubmit 接口成功返回的值。 | |1601 |AsyncTaskTimeoutErr |**任务超时**：任务执行超过了系统设定的最长处理时间（当前为 1 小时）。 | |1602 |AsyncTaskCanceled |**任务已取消**：任务已取消 | |1603 |AsyncTaskEnded |**任务已结束**：任务已处于成功/失败状态，不可取消 | |1604 |AsyncTaskCancelFailed |**任务取消失败**：任务取消失败，请稍后重试 | |2000 |AsyncTaskFailed |**任务失败**：任务在执行过程中发生未能归类的失败。 | |5000 |RiverWorkflowFailed |**工作流失败**：底层 AI 工作流执行失败，通常为更具体的错误（如 1412\-1414）的兜底。 |