xmsmartlink Docs

外观

审核素材用于 Seedance-2 ​

这个流程会依次调用审核域和主 API 域。两组基础地址和鉴权请求头不能混用。

第一步：提交素材审核 ​

Base URL：https://identity.xmsmartlink.com

bash
curl -X POST 'https://identity.xmsmartlink.com/api/asset/upload/async' \
  -H 'Content-Type: application/json' \
  -H 'X-Access-Token: YOUR_ACCESS_TOKEN' \
  -H 'X-Track-Id: 0123456789abcdef0123456789abcdef' \
  -d '{
    "images": ["https://example.com/reference.jpg"],
    "asset_type": "Image"
  }'

保存响应中的 task_id。

第二步：查询审核结果 ​

bash
curl -X GET 'https://identity.xmsmartlink.com/api/task/YOUR_TASK_ID' \
  -H 'X-Access-Token: YOUR_ACCESS_TOKEN' \
  -H 'X-Track-Id: fedcba9876543210fedcba9876543210'

查询成功后会返回完整的任务状态和每条素材的审核结果，例如：

json
{
  "code": 0,
  "task_id": "asset-task-20260421174640-kqkcc",
  "status": "completed",
  "total_count": 1,
  "done_count": 1,
  "result": {
    "items": [
      {
        "submit_review_status": 1,
        "asset_url": "Asset://asset-20260421174640-kqkcc",
        "downstream_final_url": "https://signed.example.com/temporary-file"
      }
    ]
  }
}

只有当顶层 status 为 completed，且准备使用的 result.items 条目中 submit_review_status 为 1 时，才能进入第三步。否则必须停止流程，并根据任务或条目中的错误信息处理失败。

视频生成应使用稳定的 asset_url。downstream_final_url 通常带签名和有效期，不适合作为长期素材标识。

第三步：创建 Seedance-2 任务 ​

切换到主 API Base URL 和 Bearer Token：

bash
curl -X POST 'https://vip.xmsmartlink.com/v1/task/create' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "doubao-seedance-2.0",
    "content": [
      {
        "type": "text",
        "text": "使用已审核的参考图生成一段产品展示视频。"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "Asset://asset-20260421174640-kqkcc"
        },
        "role": "reference_image"
      }
    ],
    "ratio": "16:9",
    "duration": 8
  }'

保存响应中的 id，再按 Seedance-2 查询 获取结果。

鉴权对照 ​

阶段Base URL鉴权
素材审核和查询https://identity.xmsmartlink.comX-Access-Token、X-Track-Id
Seedance-2 创建和查询https://vip.xmsmartlink.comAuthorization: Bearer ...

常见错误 ​

  • 使用 Bearer Token 调用审核接口。
  • 使用 X-Access-Token 调用 Seedance-2。
  • 将临时的 downstream_final_url 当作稳定素材标识。
  • 审核任务未成功时提前创建视频任务。
  • 创建请求超时后直接重复提交，造成重复任务。

相关文档 ​