跳转到主要内容
GET
/
api
/
v1
/
client
/
job
/
asset-info
查询 Seedance 自定义素材状态
curl --request GET \
  --url https://api.crun.ai/api/v1/client/job/asset-info \
  --header 'x-api-key: <api-key>'
{
  "code": 200,
  "message": "success",
  "data": {
    "AssetId": "asset-20260420153000-ab12c",
    "Name": "fashion-model-front",
    "AssetType": "Image",
    "Status": "Active",
    "CreateTime": "2026-04-21T02:41:43Z",
    "UpdateTime": "2026-04-21T02:41:43Z"
  }
}

​
概览

使用此接口查询已上传素材的当前状态。
  • Processing：素材仍在处理中，暂时不可使用
  • Active：素材已可用，可用于 Seedance 生成请求
  • Failed：素材处理失败，需要重新上传
Active 状态的素材目前可长期复用，没有明确过期时间。Crun 未来可能引入保留周期并定期清理素材；如有变化，会提前通知。 Crun 不会代为存储素材 ID。您的应用需要自行管理并维护素材 ID。

​
查询参数

​
asset_id
string
必填
由 Seedance 素材上传 API 返回的素材 ID。请直接传入返回的 AssetId。

​
请求示例

curl -X GET "https://api.crun.ai/api/v1/client/job/asset-info?asset_id=asset-20260420153000-ab12c"   -H "X-API-KEY: YOUR_API_KEY"

​
响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "AssetId": "asset-20260420153000-ab12c",
    "Name": "fashion-model-front",
    "AssetType": "Image",
    "Status": "Active",
    "CreateTime": 1768900378,
    "UpdateTime": 1768900415
  }
}

​
状态枚举

Status说明建议操作
Processing素材仍在处理中继续轮询
Active素材已可用可在 Seedance 请求中使用
Failed素材处理失败查看错误信息，修正后重新上传

​
相关资源

素材上传

上传您自己的图片、视频和音频素材

Seedance 2.0 图生视频

在图生视频请求中使用已激活的上传图片素材

Seedance 2.0 参考生视频

在参考生视频请求中使用已激活的上传素材

授权

​
x-api-key
string
header
必填

所有接口均需通过 API Key 进行认证。

获取 API Key：

  1. 访问 API Key 管理页面 获取你的 API Key

使用方式： 在请求头中添加：

x-api-key: YOUR_API_KEY

注意事项：

  • 请妥善保管你的 API Key，不要泄露给他人
  • 如果怀疑 API Key 已泄露，请立即在管理页面中重置

查询参数

​
asset_id
string
必填

由 Seedance 素材上传 API 返回的素材 ID。请直接传入返回的 AssetId。

响应

素材信息查询成功

​
code
enum<integer>

响应状态码

  • 200：成功，请求已成功处理
  • 401：未授权，缺少认证信息或认证无效
  • 402：额度不足，账户额度不足以完成本次操作
  • 404：资源不存在，请求的资源或接口不存在
  • 422：参数校验错误，请求参数未通过校验
  • 429：请求过于频繁，已超出当前资源的调用限制
  • 455：服务不可用，系统当前正在维护中
  • 500：服务器错误，处理请求时发生了意外错误
  • 501：生成失败，内容生成任务执行失败
  • 505：功能已禁用，请求的功能当前不可用
可用选项:
200,
401,
402,
404,
422,
429,
455,
500,
501,
505
​
message
string

响应消息；失败时为错误说明

示例:

"success"

​
data
object