1. 请求Host #

• https://icp.volcengineapi.com

2. 请求Header #

• 描述：Http请求中header需增加的字段

Authorization中的信息含义：

3. 代码样例 #

Java	Golang	Python
鉴权 : getSignedKey 发起任务 : doRequest 并通过 TaskId 轮询结果: queryUntilDone	鉴权 : func getSignedKey 发起任务 :func do_request 并通过 TaskId 轮询结果: func submitAndQuery	鉴权 : def get_signed_key 发起任务 :def do_request 并通过 TaskId 轮询结果: def submit_and_query
VolcEngineApi.zip 1.11MB java -cp "out:lib/*" VolcEngineApiClient javac -encoding UTF-8 -cp "lib/*" -d out src/VolcEngineApiClient.java	api_sample_demo.go 7.10KB go run api_sample.go	api_sample.py 7.66KB python api_sample.py

1. AI模板消费 #

SubmitAiTemplateTaskAsync #

• 描述：提交AI模板消费异步任务

• Method：POST

• 请求参数

• 响应参数

• 请求示例 - ResourceList是URL 数组

{
    "ServerId": 2540571789443387,
    "PayloadJson": "{\"ResourceList\":[\"https://lfxx1.jpg\"],\"TemplateId\":\"冷冬叙事拼图\"}"
}

• 请求示例 - ResourceList是DataUri 数组

应对海外CDN提供的URL服务访问不稳定, 可以自行转换成Base64编码, 每张图编码后的字符串大小不要超过8M

{
    "ServerId": 2540571789443387,
    "PayloadJson": "{\"ResourceList\":[\"data:image/jpeg;base64,/9j/4QKGRXhpZgAATU0AKgAAAAgACAEOAAIAAAGZAAAAbgESAAMAAAABAAEAAAEaAAUAAAABAAACCAEbAAUAAAABAAACEAEoAAMAAAABAAIAAAE7AAIAAAAKAAACGAITAAMAAAABAAEAAIdpAAQAAAABAAACIgAAAABBIHZlcnkgYmVhdXRpZnVsIHNtaWxpbmcgd29tYW4gY2FsbGVkIEVsbGUgd2VhcmluZyBhIGxvbmcgd2hpdGUgc2F0aW4gZHJlc3Mgc2l0dGluZyBvbiBhIGJyZWF0aHRha2luZyBuaWNlIGJlYWNoIHNvbWV3aGVyZSBpbiBHcmVlY2UgYXQgc3Vuc2V0LCBibHVycnkgYmFja2dyb3VuZCB3aXRoIG1vdW50YWlucywgd2hpdGUgaG91c2VzIGFuZCBibHVlIHJvb2ZzLCBzaWRlIHZpZXcsIGZhbnRhc3ksIGRyZWFtaW5nLCBjaW5lbWF0aWMsIHRyZW5kaW5nIG9uIEFydFN0YXRpb24sIGF3YXJk...\"],\"TemplateId\":\"冷冬叙事拼图\"}"
}

• 响应示例

{
    "ResponseMetadata": {
        "RequestId": "2025111816192007E6ED6D440FE65D0A1F",
        "Action": "SubmitAiTemplateTaskAsync",
        "Version": "2025-11-25",
        "Service": "iccloud_muse",
        "Region": "cn-north-1",
        "Code": 0
    },
    "Result": {
        "TaskId": "7573967600885514303"
    }
}

QueryAiTemplateTaskResult #

• 描述：查询AI模板消费异步任务结果

• Method：POST

• 请求参数

• 响应参数

• 请求示例

{
    "TaskId": "7574258855660486699"
}

• 响应示例

{
    "ResponseMetadata": {
        "RequestId": "20251119123339DA1F93013A210DCD16FE",
        "Action": "QueryAiTemplateTaskResult",
        "Version": "2025-11-25",
        "Service": "iccloud_muse",
        "Region": "cn-north-1",
        "Code": 0
    },
    "Result": {
        "TaskId": "7574258855660486699",
        "Code": 0,
        "Progress": 100,
        "ResultUrl": "https://ark-content-generation-v2-cn-beijing.xxxx",
        "StartTime": "2025-11-19 12:32:51",
        "UpdateTime": "2025-11-19 12:33:21"
    }
}

2. 模板填充信息 #

• 说明

  • 构建发起任务时的填充信息

  • 参数用于任务发起时入参，参考「模板消费请求参数」

• 该参数用于模板消费任务发起时的入参「PayloadJson」

• 构造示例【需要将对象序列化为JSON字符串】

"{\"ResourceList\":[\"https://lf-xxx.jpg\"],\"TemplateId\":\"3D卡通绘\"}"

• 模板消费任务发起入口

1. ResponseMetadata #

2. AsyncTaskResult #

3. QueryTaskResult #

{
    "ResponseMetadata": {
        "RequestId"："202511221602162C79BEBEFE54155839AF"
        "Action"："SubmitAiTemplateTaskAsync"，
        "Version"： "2025-11-25"，
        "Service"： "iccloud_muse"，
        "Region"： "cn-north-1"，
        "Code"：1402，  // 错误码见下表
        "Domain"："aigc_openapi"，
        "Message"： "domain:aigc_openapi code:1402"
    }
}

使用子账号的AK/SK在调用AI特效模板接口时报错"Message": "User is not authorized to perform: #

报错表现

｛
    'CodeN'：100013，
    "Code"："AccessDenied"，
    "Message"："User is not authorized to perform：iccloud_muse:SubmitAilemplateTaskAsync on resource： "
    }
}

解决办法
需要主账户在https://console.volcengine.com/iam/policymanage里新建自定义参数配置。 iam 给子账号添加鉴权。

步骤	操作	截图
step1	点击「新建自定义策略」
step2	输入策略名，点击JSON编辑器填写Action，然后点击提交	{ "Statement": [ { "Effect": "Allow", "Action": [ "iccloud_muse:SubmitAiTemplateTaskAsync", "iccloud_muse:QueryAiTemplateTaskResult" ], "Resource": [ "*" ] } ] }
step3	点击「添加权限」，用户找到对应的子账号勾选上，然后点击提交

注意：自定义策略时，Action 可以直接填*，不列明具体接口，这样可以兼容其他接口。

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "*"
      ],
      "Resource": [
        "*"
      ]
    }
  ]
}