跳转到主要内容
POST
/
kyyReactApiServer
/
asset
/
sd2Manxue
/
assetUpload
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/asset/sd2Manxue/assetUpload \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "imageUrls": [
      "https://example.com/portrait.jpg"
    ],
    "videoUrls": [
      "https://example.com/reference.mp4"
    ],
    "audioUrls": [
      "https://example.com/bgm.mp3"
    ]
  }'
{
  "code": "0",
  "msg": null,
  "data": {
    "items": [
      {
        "assetType": "Image",
        "originalUrl": "https://example.com/portrait.jpg",
        "assetId": "asset_img_001",
        "status": "submitted"
      },
      {
        "assetType": "Video",
        "originalUrl": "https://example.com/reference.mp4",
        "assetId": "asset_video_001",
        "status": "submitted"
      }
    ],
    "failedItems": []
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.globalaiopc.com/llms.txt

Use this file to discover all available pages before exploring further.

Sd2 Manxue 批量提交素材审核

批量提交 sd2_manxue 素材审核任务。适用于涉及人脸、虚拟人像或需要先入库审核的图片、视频、音频素材。

认证

所有请求都需要在请求头中包含 Bearer token:
Authorization: Bearer {{key}}

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址,请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

请求参数

imageUrls
array
待审核图片 URL 列表。图片建议宽高比在 0.4 ~ 2.5 之间,宽高建议在 300 ~ 6000 px 之间。
videoUrls
array
待审核视频 URL 列表。
audioUrls
array
待审核音频 URL 列表。
imageUrlsvideoUrlsaudioUrls 至少传一个非空数组。

响应参数

code
string
状态码,0 表示成功。
msg
string
返回信息。失败时返回错误原因。
data.items
array
提交成功的素材列表。
data.items[].assetType
string
素材类型,可能为 ImageVideoAudio
data.items[].originalUrl
string
原始素材 URL。
data.items[].assetId
string
返回的素材 ID。
data.items[].status
string
提交状态。成功时通常为 submitted
data.failedItems
array
提交失败的素材列表,可能为空。

使用流程

1

提交审核

调用当前接口,获取每个素材对应的 assetId
2

查询状态

调用素材审核状态接口,确认素材状态是否变为 Active
3

引用素材

在创建视频任务时,使用 asset://{assetId} 的形式引用审核通过的素材。
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/asset/sd2Manxue/assetUpload \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "imageUrls": [
      "https://example.com/portrait.jpg"
    ],
    "videoUrls": [
      "https://example.com/reference.mp4"
    ],
    "audioUrls": [
      "https://example.com/bgm.mp3"
    ]
  }'
{
  "code": "0",
  "msg": null,
  "data": {
    "items": [
      {
        "assetType": "Image",
        "originalUrl": "https://example.com/portrait.jpg",
        "assetId": "asset_img_001",
        "status": "submitted"
      },
      {
        "assetType": "Video",
        "originalUrl": "https://example.com/reference.mp4",
        "assetId": "asset_video_001",
        "status": "submitted"
      }
    ],
    "failedItems": []
  }
}