创建白名单任务

/v1/reference-whitelist/jobs

通用

提交原始参考图片 URL，创建白名单资产任务。

鉴权与连接

Base URL: https://backend:8000
Authorization: Authorization: Bearer YOUR_API_KEY
Method: POST
Path: /v1/reference-whitelist/jobs

请求 / 响应 JSON

// REQUEST

{
  "url": "https://file.example.com/tenant/1/user/7/reference/image/2026/03/26/example-upload.png",
  "name": "reference.png",
  "asset_type": "Image",
  "group_id": "group-20260326105928-nmrpk"
}

// RESPONSE

{
  "id": "asset_example",
  "object": "reference_whitelist_job",
  "status": "processing",
  "group_id": "group-20260326105928-nmrpk",
  "project_name": "default"
}

请求字段 / 响应字段

// INPUT SCHEMA

字段	类型	必填
url（必须使用文件上传 API 返回的图片链接）	string	Y
name	string	N
asset_type	string	N
group_id	string	N

// RESPONSE SCHEMA

字段	类型	必填
id	string	Y
object	string	Y
status	string	Y
group_id	string	Y
project_name	string	Y

代码示例

cURLrequest.sh

curl -X POST "https://backend:8000/v1/reference-whitelist/jobs" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "url": "https://file.example.com/tenant/1/user/7/reference/image/2026/03/26/example-upload.png",
  "name": "reference.png",
  "asset_type": "Image"
}'