## **如需开通使用本API，请联系火山** 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_5aed9121074c11206d1359f733aad2ca.png)![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ad596bb44db69d5a1abf84ffa760d86d.png) 3. 4. 在左侧菜单中选择 **「API Key」** 模块，然后点击 **「+New」** 按钮。 5. 输入 API Key 名称后，点击 **「Create」** 按钮完成创建。 6. 创建成功后，您将获得一个 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**
|
**模板说明**
| |---|---| |**如需使用，联系火山**

|**爆款裂变1\-N\-故事板 API**

| 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 请求，通知您结果。

回调结果就是查询的响应参数 | payload 结构 |**字段名** |**类型** |**必填** |**说明** |**参考说明** | |---|---|---|---|---| |variant_count

|int

|是 |期望生成的故事板版本数。默认 1；取值范围 1–10 |1

1\-10 的int | |ref_video

|string

|是

|参考视频链接

* 支持格式：MP4/ MOV

* 文件大小：≤200MB

* 视频时长：\>5秒，≤ 60秒

* 分辨率：≥480p

* 支持的画面比例：支持 9:16 、 16:9 、 3:4 、 4:3 以及 1:1 |* "ref_video": "https://static.bytednsdoc.com/obj/example/demo_video.mp4" | |product_url |string |product_url、product_id、product_images至少存在一个有效值

|输入抖店商品链接

|商品链接和商品ID同时存在的情况，取商品ID

* "product_url": "https://www.tiktok.com/view/product/172839182"

* "product_id": "172839182"

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

|| |product_images |list ||商品图链接

* 图片数量：1–15 张

* 图片格式：JPEG / PNG

* 单张大小：≤ 8MB

* 宽高比 \>0.4 ，< 2.5

* 最小像素总数： 300 \* 300 像素

* 最大像素总数： 36,000,000 像素（即 3600万像素）

* 最短边长度：最小 300 像素

* 最长边长度：最大 6000 像素 |* "product_images": [

"https://static.example.com/product/1.jpg",

"https://static.example.com/product/2.png",

"https://static.example.com/product/3.jpg"

]

| |model_images

|list

|否

|模型参考图

* 不传默认“**智能匹配**”

* 图片大小/格式/分辨率/数量要求

* 超出校验条件时按具体原因提示错误

* 图片数量：0–3 张

图片格式：JPEG / PNG

单张大小：≤ 8MB

* 最小像素总数： 300 \* 300 像素

* 最大像素总数： 36,000,000 像素（即 3600万像素）

* 最短边长度：最小 300 像素

* 最长边长度：最大 6000 像素 |* "model_images": [

"https://static.example.com/model/model_1.jpg",

"https://static.example.com/model/model_2.jpg"

]

| |location_images

|list

|否

|场景 / 地点参考图，图片格式要求同上

* purpose = 生活服务的时候生效，最多支持3张

|* "location_images": [

"https://static.example.com/model/model_1.jpg",

"https://static.example.com/model/model_2.jpg"

]

| |purpose |string

|否

|默认（电商），枚举值：电商、生活服务

|生活服务

| |version

|string

|否

|默认（2.0\-standard），枚举值：2.0\-standard、2.0\-fast、2.0\-mini、2.5\-standard

|2.0\-standard

| |compliance_enabled |bool |否 |是否开启合规预审，默认false |false | |product_name

|string

|否 |商品名称

* ≤ 500 字符

* 商品url/id和“product_name”字段同时存在时，取传入的product_name |"有机牛奶"

| |prompt

|string

|否

|* 用户自定义创意策略 / 爆点描述。用于指导故事板的创意方向和内容生成。不传则使用系统默认策略。

* ≤ 5000字符 |“结合我的商品<商品图1\><商品图2\>，模特图<模特图2\>，场景图<场景图1\>参考提供视频的故事情节、剧情节奏、口播风格，生成视频”

| |language

|string

|是

|视频语言，影响口播、字幕等

* 支持范围如下

* 语言说明：

* zh：中文

* en: 英文

* en\-us：英语（美国）

* pt\-br: 葡萄牙语

* ja：日语

* es\-mx：西班牙语（墨西哥）

* id：印度尼西亚语

* ms：马来语

* tl：他加禄语（菲律宾语） |"language": "zh"

| |ai_product_analysis

|bool

|否

|开关，默认"关闭"（false）。

* 打开（true）：AI 自动分析商品卖点、目标受众

* 关闭（false）：不进行卖点和目标受众分析 |"ai_product_analysis": true

| |product_selling_points

|string

|否

|* 商品卖点描述

* 多个用 ; 分割就行(英文分号)

* ≤ 5000字符

* 如果product_selling_points 传入同时ai_product_analysis= true ，优先取传入的product_selling_points |"天然有机"

| |product_target_audience

|string |否 |* 商品目标受众描述

* 多个用;分割就行(英文分号)

* ≤ 1000 字符

* 如果product_target_audience 传入同时ai_product_analysis= true ，优先取传入的product_target_audience |"上班族，低头族"

| ### 响应参数 |**字段名** |**类型** |**描述** | |---|---|---| |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": "587384578", "callback_url": {YOUR_CALLBACK_URL}, "payload": { "reference_source": "auto_match", "ref_video":"", "reference_video_auto_match_duration":50, "variant_count": "5", "product_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?alkey=1128_99514375927_0_3708929819002667416_010&c_biz_combo=8&detail_schema=sslocal%3A%2F%2Fec_goods_detail%3Fbcm%3D%257B%2522bcm_share_id%2522%253A%2522090955cb-3307-404b-a6ce-72b52f2c2ef4%2522%257D%26campaign_type%3D0%26ec_s%3D127aaad4c06b12afa663ae0f7be690b48946818ec59c06_HMZoCojDcMgtbRPbmR8sPEpNYxam8RARzI%25252F2dJy5%25252F3A%25253D%26enter_from%3Dcopy%26is_from_seckill_channel%3D0%26item_id%3D0%26kol_id%3D99514375927%26meta_params%3DH4sIAAAAAAAA%252F4xbW6skyXH%252BK8sBv%252FU0eb%252F024x213qQ0GLZYKMWSXZVdnfq1O3Upc85O8yDEX4wvglsg8F6MBiMX2x8Aa3Z9c%252FZWcn%252FwuSlqrKq%252B8zsGejpivgqMjIyMjIiM%252Fvtnan6VleZUbY61ne7u7f7u67Xve16m3na%252Fm63v3u73%252B%252Fv%252BufGuP937gO4j437yOqqN1U%252Fcd5%252F9V%252Fv%252F%252B7fKZTffvMb9%252FzO4e6a1sZG9ne7t%252Fu7Urf3pleevL%252FbgY0jPS2fbTU9SwkcqTvXj6q7H5TNvV6YQEk4BJIQSgUEvikPCu15lR0wkbVAzKIdVPXmqff4b%252F%252F3H7775T99%252B81XHh%252FFYPBus7%252FLbZfVQ9UrnfX2YvvnuRUPPthTpwujDnWbm1b1pmwK3ZtR5aDAcOhsvn6zO%252Bt2wgEJJKXZ4RXGgL8igBxeaZaZVxwdKDqiDJkjUT%252F%252BKXn80S9ev3n9%252BvXrz4Zf6B%252BWqq%252Fqn%252FzwJ%252BSnf9R%252BYQ7009Ph6Qv8%252BIb%252B4PfrP%252FzjLx9%252F%252FAfgh9mfqNY8DKbrVaNPRsE4QHVZ97auJttyICSSAkoAEGOcQOaBhT6YQlW6TDSvh%252F5Y1I%252FKd3l%252Ft4Ob%252FZ3tVNPW%252BZD1Kje9toXKdFEcdHYf%252BudfNFldqi4z1dRvCKTYQIAnrXLV2Gy2FITuOdjL6DY7q0a3uuxmZco6HwqjvJ6eehpM16nnelCFvTejVh5ru2kYE61G80SVEEAEAkggoQyyTyGGFL8Rn8rPCQeAYAI%252FC%252BrUQ5sZVZr%252BXOc3Go6gIlfVUHo%252BhTL4lz5Mwz53uyt12y8775mPtj%252BrTLf10JlC2VKfTLd61xk9quOG2HODO2am6t0QbfZ3Z6NXts3NUQ9FsExv%252B8KsWs4Km90vBnmaDMErpoCxi3bMVGt0V1dBwZ8t4wgEEDBwM4j89pf%252F9t2vfv3%252B63%252F53W%252F%252BTMrfe%252F%252Brv%252Fztf37z%252Fm%252F%252FNIk6%252BRyMsro62pPqTFHY6qSa2la9crJ9%252FPm51%252BV62qYT0nbq2OrSOLvmMf64r8oFw6FbAOv%252B7Ax51lUVHSyJcJPBlhFkZZ5RlK26Xle9coaKLY%252FD6HxiOcly2zWFflatru6jin76TCH8WLflS35nO1XYS%252BL8%252Fv2mNRdbD93sJY1pu7rShTrXpQlUP5DRm1KbOQ1HXxgdRLetNW30vdtu1zqlS1Plq%252BVlsHn0CoAhYVwIIfxQnyLjRkAK%252FHNHJ1d4fCKmnb3k7L%252FvgpMddJ88nXXKqxdInffNJLKprdJ53pqumwQXh65K8V2fPi6fmjbo73vZuLm%252FD7PHP7ohHlsKtposPzbWxrbcxyXOvx2HO7ClEmBENhZZlR13hO7gFvi%252FzeVeOeoF7hDewS3HjDPmgd2j3SGSIO29mzTelcIwqdYchmeVuySgKJxz6qLYEd8gooJTJ%252F00FDuCd2ALGeKSb0bFVG4vOwh2YMsAFpI5RmmrfEccSQBOya0mu14%252F97Y0Y2uuMUYZQ3wyQ2UeE6v251YtKY1%252BXlGywlzcWhWJ7uNHeJJ3MlUefGWHwqBeSJc8Nk13wUHaVgiMKGcUAU4xoDQC%252BgiYX0DxBTAh0NT2t9989d3f%252F83UvoOTKzjp0EKko%252FArCqpSJwqgQMLR5%252BIi4DIdSHKVhZ4JJAmiY3MRlBX3KQYBgeEK4mybQCBAKCLKrDsdEv1sp0%252BndC6c6waqCJlJ6JqEl6Qy6w5JJ7umvE%252Bn76CaoVVZH6ftFhJGAJeESUKQ8%252FYUdRlRgHAuKcVcUIkAJNFaDqH6c2tUOY0W3M457gyYE%252BAtoJKIGdLmMenUl9B%252FNy22BEpAOPOfZAI6aSMMbAGGSAjMCcBcMslEAuwXQMgxIQICQSQkBBPugebJlE2vsv4Eb%252BTnkXvM%252BtMNbqsvJ9Xb1uTqAhfO2Lp8%252FDYnUHNzqOuuv%252BImEtGLEtEHJS65L6r4ooYfVPBF%252FV5U74PaZa4aefKkMG7jUxic6tgpeJ4tvwv%252F4G4eAwdBZMagHXT8K4wuig9imnbSJPh128wEOJG6rI5%252BzLcCEedTGDHMJYIjJNNdpmOC5aI2xABAhhGTgExywtofTQEkw5JjKSVAmGBOJ1EuZxxRQlIOIRHQ%252FScjyJbNYu3N0mnugk4xui6MBq7UkjxSMbhFheImWRfFLbALcuNEWgi%252BpnrBK%252FLDxbSdrUMsRkhSiQHDHECIBWMs9HhcK5NgElbyaSin5TsJR2ENnyHfb91O2%252FCLd9rGaUj5YSVP%252BdOKnqDCsp6i3PKeAvwi%252FyE9V4t9%252Bu5yye9s6czQt3aOXZgDyriAUgDkqn9B5QL%252F4WSxawY1o4KPPZ5tbxKqj5pUGkyyIyYyw4hkUxOTy2BAUJA5uQBybQUntmrEzcQySz3ldAw7EHu%252FBxEAJk9pIKh3HDozkyHDLAi4hdUJkGAZF9cEyCSPcet443W%252FCaCGzrSq17PJkwjj%252BAf75UusxR7RinfRxXCDqa26YdOwlGZ1GfLwV3BFnaLwmt5lUxOvxhw3jZCZezdkbXRJU21%252FTa6HPs7Ta7Iq7VMyoGvWKG%252FBbVpbt7Z%252FTpQv7ZNxxVACDqR6WAqo8zghq1z5zHbqKVn0sQ55wxKC6ArSXFwWMoMYSHmn8pLwIAVpJ1rjCkRXCi80TMmqbu117yfEoreReS3waCujurrtxz0%252F7yPJnh%252BjPNSIl4CojrXq7JfBy6LOF3VSnaqGMma3KFLPC%252BoopkqpsWxsdYxvGFHCEYJwpqtmNvEXc9BzEcvl1XPUImSD5IbBDQKAAwUx2yAIoVAQcUeDXCGMJVCQSkmXgg7D8yRIoA2iGyo3WEhCFJRRDFsL4XASMvRK59czz1h10J3N1NHoa%252B6gzJPtVdPWh32S9K75fbe%252Fziov07rKwFiQmDydmy5loJjMHW1V%252FjgCprzLpypJUrulgkk4m9n6XaOpCoiCGQcEzYKNyoZFu4wJuE%252Fz9nSgXF5PkZwT%252B7rNVTcsbAAZAXMd6aZR1xS2Ry9jfCs6MdWWUELlbLFDF4MP2zLOqKBASiQQi%252BHwYNSIcD0AEHIhuGSMUkEpkyHXbOvhdPZzP9OFPbTa7%252BdmtTmGwRiz7QC7fAT2UTkfleCC4EeleNDHJNWtXY%252FyepTsVObdHAEHOK0Qy8XBRRDnpjYbzyU%252BCO3MQxqWwiRPQhNGaLMgCEyWBMBYSmAcY7AkAL58hQoINlcBMH2FCbggUCnBohXKGUBXHVkZRkgI4QZsgUROa7AFHDGM3BfCGPYsggTnGz%252FdpGdBBFGgQEKp%252F4KhYMBTXEBK5voL7XLOIHWioMuYvXDMggKYQhBkEkk9izIg3RcIAOXSt4IIFwEspAcDiSVcOskHYkGWtao0ukoRhJFk5XSIrs8XOjORhLHmpgxM5Gzz5uEWBmHIlmIWEohEKwkLV0cAzFlwc8jKPmFLyahI3j4ak%252FtzmHQ2ScZmSL6eSohzlEZE06qzPSVl7RZBhARYYU51ndqKE8T4XDq0qxnNJU6dZK0DAUIk3KREDQjGoRDkCrGKG1RiRvkt1Lo9ySG6xp3KRTFEMUhMe39qisAmSaQdg8pst6v4Al1pnWh1472q7m%252B%252FyxCSiL3wbhOKwtQATIpkMG%252FClavOumubAFfLvvBqeDE1D6RiizmT6aCsPQu5xXp2zSttCWNpTWqesrOuTmY8l0mSz169zEw4uUprKTGVQzPELwNpaTRtUqmPg%252FwxqF%252FF9ldlyPw39ceW6X6MN9pW0AU2SVUu88LooXyLOaQIAYmgAFCiOQbYo3oYbIgCR110JqQRNp9FjCo7YnNJ1FjmCebpSsMXuzNuF7tu%252BdM20yoYIoCEgNEXQTiAKIIMsBdRPKAEoADIqZy%252F0RgEFL%252BAiC0xAkHcf1ojYisQcczjjlMWF%252FlXnEAmIOcUS4gwg4iO22GLSQkJ3goppUw8%252F8qIlEKMGORSckYJWyGnAmqBRsn%252BTcTpw36dpyzGpB0TR%252FeBxJYKIQWEgECXYiYuU5r2ZFRTh4mDWeiZ7VSTKdOkm3JZ%252F6RONr8qtRy9zXShjsUa7smlDUdoC3x7m3w6z%252FRlqy42eTKHXIQhLHTnD3Znni%252BAQv9drqu7aScUTdSyLyZqPNIZwa5pCJLGU0bIB3ZiISh5Q14x4hsktD20c80IseQhN3g31Ume6U8L4wHWk2r0HBR%252FhBWdX8g6lRqpXD0fdN3Y6joiNhccdRIUi1A%252BZMV9JEIMZTxu0s%252BRhnCcUOe6Gc%252BB3t7QIOvURRdjhAlKPsyl0e%252F%252B46v%252F%252B8d%252FnZzuQR3aGIvdfOIEkUjvknrK5RGdCvc9klcfxrMyEAlZfxopILrGg99dSjeLPCw6HMU80mIdCzkSTEoZz2AeBtPOln%252F%252FV3%252F97f98%252FUmpe%252FMJA580bf3Jd3%252F%252BF9%252F9%252ButP3v%252Fzfyd6pRuCACRqBCJCSCbIaD0pRQq9pibT%252BEV7TIg5nDw8fD%252F9N2FkNusBelgeLIUuBfv6zxRZGD0vT6GfYJNkz%252BdqPOSHELpKZaKqg76%252F4qQ3QsKdhnijYdo7bJpJYNzCyTp1rP1VhaozcQcu3C9QWZecF46niI54uUXsb5OHpWcv9vj6Vh%252BPNlPHtp7PEa9vVEx7O8d5vCZiY3v9rMPBbWEW9wgCR2e%252BRL7Jq1t7smteax7SIvV73Gaa9rrrLBoXQBDM2%252BvFse1wUCvxXLz%252B7PNJQhcvTcStK8aNMQaBYyagMYZm5gik4Ujy7HCYXfZL09aX%252B6Sdvruo8eKE78OcETrW2kE5WLDbZBtunyRTkMR8wh%252BKj97TXFQfL4NAGmdv2Y8RLzzbKsmTU3s0j7PDmUofCrNPY%252B7Cn9a%252BeO1xp6ZcPDemTsT59GwfE7Z3YzrZzgpMy7MMwSxZsGOyekooQUJdFbYy6lCro62Mv2o0yUuIyo7b4nFnPuU1Wd%252Bqg%252Bl10tSSf2nRBwF%252BO%252F%252BjAF00Z50Y5EqHoGlc4V%252FS42Mg39QSFExVxCTHLRmCYwCCC5WqMo9qDlylLgpVF7k%252FVplDYf803zBy1t37EQv3puLTbvxyK4TsR1H7GClNO8ad7%252Fnyu3kuZP1T6jZ52k2TNY1q6rqYjoTGpbGO4%252FM2RJnpKG88TZodFIPpgMkXi8FuILYwHqO8Xc0KKgCDcv6Lp23zJIEcobi9XKfJTa8PiwO%252B1aUr263uCQWCSnNWf%252Bpgq9ykZ%252FntUBh11LaYgtHkL9N8GMPryJidFGw5wjQu%252FYc68e%252BtxAjGuudQq5Muy%252BjXWyhdoTFyGjvO95ESHNPpOZ%252B93WanikiGKbuBmVSCW8AZh%252FwGZtYObJnAlPG4Ak3H%252BFvJEKQxf2x5JELECBkrQDhefIICETI64TSwDPNop2Yx3DJm0KcZK13xiyN14Rox6hWJXDJWl0UCxeHtS4KTkJJ4IpQAgURxjjfjNgeEdOvUir75OG7RMwlYPJoq7dN8ruHKx9CFLhsrN7CllOG4hR%252FQ8x2T%252BQXHsf10QOJKwWj59TFycsE2PX0Z50hs36a3tG5tnexX14hWmx5g2jhZ7aqAZM%252Fe%252BdQ4FSM5T0cJ8VilOWqxwDX6WWVVrySIGR4L0WJoCnvsFxVI3xrdl2O2OF5DqvK6VEvWeIysn1VvFJgGFtGY74cbzimPEyrgmBv4JT99EQBAUpEwERkrqEnkxOOUYLYSCVORNBWJUpFiKXLicYgZXYlEqUicGu8lywkgKEZIiO1sw5UFQXJqE0civfEy5cVlGzwVhZ9%252F%252BNsfp7Yempu%252Febi%252Bh7y8NvzubjP%252BYiTexA0%252FVYkP8QcG813ikV7YWDT9LCXP3U%252FzVkQg4gIBRDEHLiWcfX8UN00sEj2%252Fb5MVsKhPL%252BbZ%252BM2bT7kEr%252BUPBP6Mfg7w528%252BS05h%252Blb35jQXmqsrx%252B%252BCTQ%252F2S7W49%252F5kdZ1bXW27oTHt%252BJOa2icW737%252Bztnt3f8HAAD%252F%252F04HaeDjMwAA%26product_id%3D3708929819002667416%26promotion_id%3D3708929819002667416%26promotion_id%3D3708929819002667416%26request_additions%3D%257B%2522from_internal_feed%2522%253A%2522false%2522%252C%2522cps_track%2522%253A%2522%2522%252C%2522marketing_channel%2522%253A%2522%2522%252C%2522ecom_scene_id%2522%253A%25221098%252C1031%2522%257D%26request_page%3D1%26source_page%3Dcopy%26x_share_compress_url_params%3D1%252C1%252Cmeta_params&did=MS4wLjACAAAAVx2wJFvkDoxPX6m57wK-iz-AC_Zw9e4xq_cUyNjmMz8&entrance_info=%7B%7D&from_link=1&goods_detail=%7B%22title%22%3A%22JEEP%E5%90%89%E6%99%AE%E5%86%B2%E9%94%8B%E8%A1%A3%E5%A5%B3%E7%A7%8B%E5%86%AC%E4%B8%89%E5%90%88%E4%B8%80%E5%8F%AF%E6%8B%86%E5%8D%B8%E9%98%B2%E9%A3%8E%E9%98%B2%E6%B0%B4%E5%8A%A0%E5%8E%9A%E5%A4%B9%E5%85%8B%E7%99%BB%E5%B1%B1%E9%A3%8E%E8%A1%A3%E5%A4%96%E5%A5%97%22%2C%22sales%22%3A519%2C%22img%22%3A%7B%22uri%22%3A%22ecom-shop-material%2FCCihwzEv_m_01d2b3ab12378a73e8f91d8d6ebe7ed8_sx_139792_www800-800%22%2C%22url_list%22%3A%5B%22https%3A%2F%2Fp26-item.bytedance.com%2Fimg%2Fecom-shop-material%2FCCihwzEv_m_01d2b3ab12378a73e8f91d8d6ebe7ed8_sx_139792_www800-800~tplv-5mmsx3fupr-image.png%22%2C%22https%3A%2F%2Fp3-item.bytedance.com%2Fimg%2Fecom-shop-material%2FCCihwzEv_m_01d2b3ab12378a73e8f91d8d6ebe7ed8_sx_139792_www800-800~tplv-5mmsx3fupr-image.png%22%5D%2C%22width%22%3A100%2C%22height%22%3A100%7D%2C%22min_price%22%3A9900%2C%22max_price%22%3A19900%7D&h5_origin_type=detail_share_v2&id=3708929819002667416&origin_id=99514375927_3708929819002667416&origin_type=3002070010&sec_author_id=MS4wLjABAAAA2I9NdgAKZrz9e0tLm1csyDMNqLESPDm34TdYYqXe8-I&u_code=16aef64lh&use_link_command=1&with_sec_did=1&x_share_compress_url_params=1%2C1%2Cmeta_params&ecom_share_track_params=%7B%22is_ec_shopping%22%3A%221%22%2C%22secuid%22%3A%22MS4wLjABAAAAEujaHm_tnoOHO4SUrPeb5DgbxP3wB5CGoTXzwMR0HcY%22%2C%22enter_from%22%3A%22order_center%22%2C%22share_previous_page%22%3A%22order_center%22%2C%22share_id%22%3A%22090955cb-3307-404b-a6ce-72b52f2c2ef4_MS4wLjABAAAAEujaHm_tnoOHO4SUrPeb5DgbxP3wB5CGoTXzwMR0HcY_request_page_1%22%2C%22share_action_type%22%3A%22click%22%2C%22product_id%22%3A%223708929819002667416%22%2C%22shop_guide_id%22%3A%22%22%7D&utm_source=copy&utm_campaign=client_share&utm_medium=android&app=aweme", "model_images": [ "https://lf3-static.bytednsdoc.com/obj/eden-cn/jhteh7uhpxnult/test_image/woman/woman_2.png" ], "product_name": "", "prompt": "红色衣服", "language": "zh", "ai_product_analysis": true, "product_images": [], "product_selling_points": "", "product_target_audience": "" } }' ``` ### 响应示例（成功） ```JSON { "code": 0, "data": { "task_id": "7651875725284278323" //用来做查询任务的入参, 也可以等待callback }, "message": "success", "request_id": "20260330132131910C619A3D2F5FF87656" } ``` ### 响应示例（失败） ```JSON { "code": 1410, // 请参考6.3 通用错误码 "data": {}, "message": "template_id not exist", "request_id": "202603301322133EB7BAD7D1B156F75CF7" } ``` --- 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/HDWBd5cWRo3iwjxQg3Scj3rgnhh?contentTheme=DARK&last_doc_message_id=7622959140566371552&preview_comment_id=7622959347257215958&sourceType=feed&theme=light#doxcnUmpSxglnqmERweoRha2TNe) |包含任务详细信息的对象，见下文 QueryData 结构。 | #### queryData |**字段名** |**类型** |**描述** | |---|---|---| |task_id |string |任务的唯一 ID | |usage |double |本次任务消耗的创点数量，仅在任务成功时有效 | |payload |payload |任务详情 | #### payload #### payload 任务结果详情，不同类型任务的结果字段可能存在差异，以下字段为结果公共字段。 |**字段名** |**类型** |**描述** | |---|---|---| |storyboards |array |故事板结构的数组，包含variant_count数量的故事板 | #### storyboard 结构 |**字段名** |**类型** |**描述（含样例）** | |---|---|---| |video_duration |double |视频总时长，单位为秒。示例：28.1 | |aspect_ratio |string |画面宽高比。示例："9:16" | |bgm_description |string |背景音乐与音效描述，用于说明节奏、乐器和氛围。示例："BPM为120的轻快灵动中式国风纯音乐..." | |language |string |旁白或口播语言。示例："zh" | |storyline |string |整支视频的故事线或内容概述。示例："开篇展示弋阳手工年糕的多种形态与吃法..." | |title |string |故事板标题。示例："江西弋阳手工年糕产品推广视频" | |visual_style |string |整体视觉风格描述。示例："明亮柔和的中式美食风..." | |shots |array

|分镜数组，每个元素表示一个分镜片段。示例：[{"duration":9.8,"prompt":"【分镜1（9.8s）】...","subtitle":"江西正宗手工年糕来啦...","image_urls":["https://p9\-aio.bytedance.com/..."],"audio_urls":["https://lf3\-river\-platform\-cdn\-sign.volces.com/..."]}] | |material_list |StoryboardMaterial[] |当前分镜使用的素材列表

| #### storyboard\-shots 元素结构 |**字段名** |**类型** |**描述（含样例）** | |---|---|---| |duration |double |单个分镜时长，单位为秒。示例：9.8 | |prompt |string |分镜脚本与镜头说明。示例："【分镜1（9.8s）】：0\-1s：全景固定机位平视..." | |subtitle |string |该分镜对应的字幕或口播文案。示例："江西弋阳正宗手工年糕来啦。这可是正宗江西弋阳特产..." | |image_urls |array |该分镜依赖的图片素材 URL 列表。示例：["https://p9\-aio.bytedance.com/...","https://lf26\-river\-platform\-cdn\-sign.volces.com/..."] | |audio_urls |array |该分镜依赖的音频素材 URL 列表。示例：["https://lf3\-river\-platform\-cdn\-sign.volces.com/...","https://lf26\-river\-platform\-cdn\-sign.volces.com/..."] | ### StoryboardMaterial |**字段名** |**类型** |**描述（含样例）** | |---|---|---| |index |number |素材在image_urls、audio_urls或video_urls中的索引，下标从1开始 | |name |string |全局唯一名称，例如素材x | |name_in_prompt |string |局部名称，素材在 prompt 中的引用名称，例如图x，音频x | |type |string |素材类型，例如 image、audio、video | |group |string |素材分组，例如生活服务中的 role、location，其余默认不返回 | |url |string |素材 URL； | |description |string |素材描述 | |source_type |string |素材来源，例如 USER、AIGC | ### 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": "7651875725284278323" }' ``` ### 响应示例（任务成功） ```JSON { "code": 0, "data": { "payload": { "storyboard": { "aspect_ratio": "9:16", "bgm_description": "轻快国风纯音乐，BPM约115，采用竹笛、古筝、扬琴等中国传统民族乐器为主奏，搭配轻快的木鱼、小鼓打击节奏，整体旋律活泼愉悦，富有生活烟火气息，节奏贴合画面切换频率，契合美食种草视频轻松欢快的氛围。", "language": "zh", "shots": [ { "audio_urls": [], "duration": 10, "image_urls": [ "https://p3-aio.bytedance.com/obj/ecom-shop-material/xxx-2322", "https://p3-aio.bytedance.com/obj/ecom-shop-material/xxx-2322", "https://p3-aio.bytedance.com/obj/ecom-shop-material/xxx-2322", "https://lf26-river-service-sign.volccdn.com/river-service/tmp/c2bxxx" ], "prompt": "分镜1（10秒）：0-3秒：全景固定机位平视视角，中心构图，静态展示三宫格布局的三款年糕经典菜式，左上是<图1>的排骨炒年糕成品，右上是<图2>的桂花糖年糕成品，中下是<图3>的韩式辣炒年糕成品，每款菜式下方对应标注文字“排骨炒年糕”“桂花糖年糕”“韩式辣炒年糕”；3-10秒：三宫格平滑切换为单画面，<图4>中的20-30岁女性从画面右侧走入，到木质展示台前站定，场景为室内中式厨房，背景是木质橱柜、白色餐边柜、竹制收纳篮，地面为浅棕色木质地板，整体画面暖光烘托，食物色泽鲜亮有食欲。全程不要有字幕和BGM。全程不要有字幕和BGM。全程不要有字幕和BGM。", "subtitle": "" }, { "audio_urls": [], "duration": 10, "image_urls": [ "https://lf11-river-service-sign.volccdn.com/river-service/tmp/9fe3ff87-9683-4d07-84a4-dd.jpg", "https://p3-aio.bytedance.com/obj/ecom-shop-material/xx-940", "https://p3-aio.bytedance.com/obj/ecom-shop-material/xx-1024", "https://p3-aio.bytedance.com/obj/ecom-shop-material/xx-2000" ], "prompt": "分镜2（10秒）：0-2.5秒：特写展示<图1>，木质桌面上棕色托盘摆放着两根手工年糕、一个西红柿和三个鸡蛋，有手扶住托盘，上方标注文字“平时在家不知道吃什么”，呈现年糕的家常使用场景；2.5-5秒：切镜至黑色背景下的<图2>，一双筷子夹着一段冒着热气的年糕，画面标注“无添加剂【高温杀菌/真空包装】”“越鄉白塔湖年糕，大米加糯米，讓口感軟中帶糯，香糯爽滑有嚼勁，眞材實料”；5-7.5秒：切镜至<图3>，黑色背景下一只手将年糕弯折展示其Q弹特性，下方盘子里堆叠着多根年糕，画面标注“香糯可口舌尖中国 / CHINESE FOOD /”“手工年糕，经千百次捶打揉搓，口感Q弹香糯爽滑。制作工艺更是祖祖辈辈的传承。年糕是中华民族的传统美食，更有诗歌称：“年糕寓意稍云深，白色如银黄色金。年岁盼高时时利，虔诚默祝望财临。”；7.5-10秒：切镜至<图4>，木托盘上堆叠着大量水磨年糕，上方红色标签写有“水磨年糕”，下方标注“真空包装 2斤-5斤”“半水磨锁住米香和营养”“Q弹软糯米香足”，镜头固定展示画面内容。全程不要有字幕和BGM。全程不要有字幕和BGM。全程不要有字幕和BGM。", "subtitle": "" }, { "audio_urls": [], "duration": 8, "image_urls": [ "https://p3-aio.bytedance.com/obj/ecom-shop-material/xx455564f31b9f5dd8700830e62b005697_sx_69464_www800-800", "https://p3-aio.bytedance.com/obj/ecom-shop-material/xx12203870c081e877f26c225dc1df493c_sx_84040_www800-800", "https://p3-aio.bytedance.com/obj/ecom-shop-material/xxf0d7b55ef00f61b12e0d8acd24c82166_sx_86805_www800-800", "https://p9-aio.bytedance.com/obj/ecom-shop-material/xx223f999385fa1c0b33470f9e83f8aea8_sx_65344_www800-800", "https://p3-aio.bytedance.com/obj/ecom-shop-material/xx6823c30e860f10f19fb2f38c659b8b1e_sx_218201_www1500-2322", "https://p3-aio.bytedance.com/obj/ecom-shop-material/xxc96bde4c35f9bd8ae5798ea7132f14a2_sx_62570_www750-663", "https://p3-aio.bytedance.com/obj/ecom-shop-material/xxc5057eb834aac05df86b1377b19b6707_sx_75950_www750-569", "https://p3-aio.bytedance.com/obj/ecom-shop-material/xx991d492765e61badfe0b697796735cfe_sx_132318_www750-1011" ], "prompt": "分镜3（8秒）：0-1秒：特写展示<图1>，黑色背景下筷子夹着一段冒着热气的年糕，画面标注“糯滑Q弹”“浓醇米香”“真材实料严格选材、精求工艺”；1-2秒：切镜至<图2>，盘子里堆放着切片的年糕，背景是整根的年糕，画面标注“石磨年糕”“严格把控、传承古方、外脆里糯”“真空包装巴氏杀菌确保食物新鲜”；2-3秒：切镜至<图3>，盘子里堆叠着多根手工年糕，左上角红色标识写有“传统”，上方大字“手工年糕”，底部文字“Q弹软糯有嚼劲”；3-4秒：切镜至<图4>，两只手捏着弯折的年糕，展示其柔韧特性，右侧标注“匠心制作老工艺零添加 Craftsmanship production of old technology zero addition”；4-5秒：切镜至<图5>，木盘里堆叠着多根年糕，背景是中式木格窗，下方有书法字体“手工年糕”搭配“匠心”标识；5-6秒：切镜至<图6>，白色背景下，盘子里堆叠着多根表面莹润的手工年糕，直观展示产品外观；6-7秒：切镜至<图7>，木盘里摆放着多根年糕，背景是中式木格窗，左侧标注“传统工艺手工年糕百年匠心，中华美食守味者 | Q弹滑口，嚼劲不粘牙。”；7-8秒：切镜至<图8>，上方为盘子里堆叠的年糕，顶部标题“产品参数 PRODUCT PARAMETERS”，下方清晰展示详细产品参数内容，镜头固定展示。全程不要有字幕和BGM。全程不要有字幕和BGM。全程不要有字幕和BGM。", "subtitle": "" } ], "storyline": "开篇以三宫格形式快速展示排骨炒年糕、桂花糖年糕、韩式辣炒年糕三款不同风味的年糕成品菜式，直观呈现年糕的多样食用可能性，随后切换至温馨的中式厨房场景，美食博主出场引出后续内容，接着依次展示年糕的家常搭配场景、原料健康属性、Q弹口感特性、制作工艺、规格参数等核心卖点，全面展现年糕的高品质与多样用途，吸引美食爱好者、家庭烹饪群体的注意力。", "title": "多吃法年糕产品种草展示视频", "video_duration": 28, "visual_style": "整体采用暖色调国风美食视频风格，画面明亮通透，食物色泽饱满鲜亮富有食欲，场景多为温馨的中式家庭厨房、简约干净的产品展示背景，光影柔和，营造出家常烹饪的舒适氛围感与传统美食的文化质感。" } }, "progress": 100, "task_id": "7651875725284278323", "usage": 0 }, "message": "success", "request_id": "2026061616471584662D764FFBD659DE50" } ``` ### 响应示例（任务进行中） ```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" } ``` --- 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" } ``` --- 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 无效**：ResourceList 中的 URL 无法访问。请确保 URL 是公网可达的，且未过期。

推荐接入火山的对象存储 https://console.volcengine.com/tos, 替换原有的TOS服务, 可提高大模型审核和生成的图片拉取成功率 | |1414 |MediaSensitiveErr

|**内容安全问题**：输入内容触发了平台的安全审核策略，请更换内容后重试。 | |1415 |OutputMediaSensitiveErr |**输出包含敏感信息错误**：输出内容触发了平台的安全审核策略，请更换内容后重试。 | |1416 |InvalidMediaCountErr |**错误的媒体数量**：输入的媒体数量超出限制，请更换内容后重试。 | |1417 |ChatCompletionError |**大模型调用错误**：大模型调用失败，请稍后重试。 | |1418 |InvalidDurationBillingErr |**时长计费参数错误**：时长计费参数缺失，请检查参数后重试。 | |1419 |TemplateIdErr |**模板ID错误**：模板ID输入错误，请检查参数后重试。 | |1420 |ImageDetectionRulesError |**图片内容检测未匹配到规则错误**：图片内容不符合规则，请更换内容后重试。 | |1421 |DurationEnumError |**入参时长枚举值错误**：时长参数不符合要求，请检查参数后重试。 | |1422 |GetDouDianProductInfoError |**抖店商品信息获取失败错误：** 商品信息获取失败，请稍后重试或更换商品信息后重试。 | |1423 |VideoResolutionError |**参考视频分辨率错误**：参考视频分辨率校验失败，请更换内容后重试。 | |1424 |VideoDurationError |**参考视频时长错误**：参考视频时长校验失败，请更换内容后重试。 | |1425 |VideoFormatError |**参考视频格式错误**：参考视频格式校验失败，请更换内容后重试。 | |1426 |VideoSizeError |**参考视频大小错误**：参考视频内容大小校验失败，请更换内容后重试。 | |1427 |RefVideoError |**参考视频链接错误**：参考视频链接校验失败，请更换内容后重试。 | |1428 |LanguageEnumError |**语言枚举值错误**：语言输入参数错误，请检查参数后重试。 | |1429 |ModelImageCountError |**模型ImageCount错误，与模板配置不一致**：输入图片数量不符合模板要求，请更换内容后重试。 | |1430 |InputRatioError |**输入图片比例错误**：输入图片比例不符合模板要求，请更换内容后重试。 | |1431 |CopyrightCheckFailed |**版权校验失败**：版权校验失败，请更换内容后重试。 | |1432 |NoCopyright |**输入媒资无版权**：版权校验失败，请更换内容后重试。 | |1433 |CopyrightCheckTimeout |**版权校验超时**：版权校验超时，请稍后重试。 | |1434 |CopyrightMediaParamErr |**版权校验媒资参数错误**：版权校验失败，请更换内容后重试。 | |1435 |OutputNoCopyright |**输出媒资无版权**：版权校验失败，请更换内容后重试。 | |1436 |InputCopyrightChecking |**输入版权校验中**：任务查询正常状态，可继续轮询查询。 | |1437 |OutputCopyrightChecking |**输出版权校验中**：任务查询正常状态，可继续轮询查询。 | |1438 |InputCopyrightCheckFailed |**输入版权校验失败**：任务查询失败状态，可停止轮询。 | |1439 |OutputCopyrightCheckFailed |**输出版权校验失败**：任务查询失败状态，可停止轮询。 | |1441 |PrivateCopyrightQueryFail |**私有版权查询失败**：私有版权查询失败，请检查版权IP信息后重试。 | |1442 |PrivateCopyrightExceed |**私有版权超过5个**：私有版权数量超出限制，请检查版权IP信息后重试。 | |1443 |PrivateCopyrightNotFound |**未找到对应模型的私有版权**：服务模型未配置私有版权，请联系管理员确认。 | |1450 |InputValidationErr

|**模板入参校验失败**：

* 同时会返回 code 和 message (告知多个字段和规则)

```JSON```
```{```
``` "code": 1450,```
``` "message": "模板入参校验失败: input_schema 校验失败: 字段 /language: value must be one of \"zh\", \"en\"; 字段 /product_name: length must be >= 1, but got 0",```
```}```
| |1600 |AsyncTaskNotExist |**任务不存在**：查询的 task_id 无效。请检查 task_id 是否为 AITemplateAsyncTaskSubmit 接口成功返回的值。 | |1601 |AsyncTaskTimeoutErr |**任务超时**：任务执行超过了系统设定的最长处理时间（当前为 1 小时）。 | |2000 |AsyncTaskFailed |**任务失败**：任务在执行过程中发生未能归类的失败。 | |3000 |TaskCallbackFailed |**回调失败**：向您配置的回调地址发送结果时失败。 | |5000 |RiverWorkflowFailed |**工作流失败**：底层 AI 工作流执行失败，通常为更具体的错误（如 1412\-1414）的兜底。 | ---

Kickart