> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crun.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Seedance 素材信息 API
> 查询 Seedance 自定义素材的上传状态和元数据
## 概览
使用此接口查询已上传素材的当前状态。
* `Processing`：素材仍在处理中，暂时不可使用
* `Active`：素材已可用，可用于 Seedance 生成请求
* `Failed`：素材处理失败，需要重新上传
`Active` 状态的素材目前可长期复用，没有明确过期时间。Crun 未来可能引入保留周期并定期清理素材；如有变化，会提前通知。
Crun 不会代为存储素材 ID。您的应用需要自行管理并维护素材 ID。
响应中也会返回 `URL`，即上传素材时传入的原始素材 URL。
## 查询参数
由 [Seedance 素材上传 API](/zh/models/seedance/asset-upload) 返回的素材 ID。请直接传入返回的 `AssetId`。
## 请求示例
```bash cURL theme={null} theme={null}
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"
```
```python Python theme={null} theme={null}
import requests
API_KEY = "YOUR_API_KEY"
response = requests.get(
"https://api.crun.ai/api/v1/client/job/asset-info",
params={"asset_id": "asset-20260420153000-ab12c"},
headers={"X-API-KEY": API_KEY},
)
print(response.json())
```
## 响应示例
```json Asset Active theme={null} theme={null}
{
"code": 200,
"message": "success",
"data": {
"AssetId": "asset-20260420153000-ab12c",
"Name": "fashion-model-front",
"AssetType": "Image",
"URL": "https://example.com/assets/fashion-model-front.jpg",
"Status": "Active",
"CreateTime": 1768900378,
"UpdateTime": 1768900415
}
}
```
```json Asset Failed theme={null} theme={null}
{
"code": 200,
"message": "success",
"data": {
"AssetId": "asset-20260420153000-ab12c",
"Name": "fashion-model-front",
"AssetType": "Image",
"URL": "https://example.com/assets/fashion-model-front.jpg",
"Status": "Failed",
"Error":{
"Code": "InputImageSensitiveContentDetected.PolicyViolation",
"Message": "request failed because the input image may be related to copyright restrictions"
},
"CreateTime": 1768900378,
"UpdateTime": 1768900415
}
}
```
## 状态枚举
| Status | 说明 | 建议操作 |
| ------------ | ------- | ----------------- |
| `Processing` | 素材仍在处理中 | 继续轮询 |
| `Active` | 素材已可用 | 可在 Seedance 请求中使用 |
| `Failed` | 素材处理失败 | 查看错误信息，修正后重新上传 |
## 相关资源
上传您自己的图片、视频和音频素材
在图生视频请求中使用已激活的上传图片素材
在参考生视频请求中使用已激活的上传素材
## OpenAPI
````yaml zh/models/seedance/asset-info.json get /api/v1/client/job/asset-info
openapi: 3.0.0
info:
title: Seedance 素材信息 API
description: 用于查询已上传 Seedance 素材状态和元数据的 API 文档
version: 1.0.0
contact:
name: Technical Support
email: support@crun.ai
servers:
- url: https://api.crun.ai
description: API 服务器
security:
- ApiKeyAuth: []
paths:
/api/v1/client/job/asset-info:
get:
summary: 查询 Seedance 自定义素材状态
description: 查询已上传 Seedance 素材的状态和元数据。
operationId: seedance/asset-info
parameters:
- name: asset_id
in: query
required: true
schema:
type: string
description: >-
由 [Seedance 素材上传 API](/models/seedance/asset-upload) 返回的素材
ID。请直接传入返回的 `AssetId`。
example: asset-20260420153000-ab12c
responses:
'200':
description: 素材信息查询成功
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ApiResponse'
- type: object
properties:
data:
type: object
properties:
AssetId:
type: string
description: 素材标识。
example: asset-20260420153000-ab12c
Name:
type: string
description: 素材显示名称。
example: fashion-model-front
AssetType:
type: string
description: 素材类型。
enum:
- Image
- Video
- Audio
example: Image
URL:
type: string
format: uri
description: 上传素材时传入的原始素材 URL。
example: https://example.com/assets/fashion-model-front.jpg
Status:
type: string
description: 素材处理状态。只有 `Active` 状态的素材可用于 Seedance 生成请求。
enum:
- Processing
- Active
- Failed
example: Active
Error:
type: object
default: null
description: 仅当 `Status` 为 `Failed` 时才会返回错误信息。
properties:
Code:
type: string
description: 错误码。
example: AssetProcessingFailed
Message:
type: string
description: 错误信息。
example: Asset upload failed
CreateTime:
description: 上游服务返回的素材创建时间。
type: string
example: '2026-04-21T02:41:43Z'
UpdateTime:
description: 上游服务返回的素材更新时间。
type: string
example: '2026-04-21T02:41:43Z'
example:
code: 200
message: success
data:
AssetId: asset-20260420153000-ab12c
Name: fashion-model-front
AssetType: Image
URL: https://example.com/assets/fashion-model-front.jpg
Status: Active
CreateTime: '2026-04-21T02:41:43Z'
UpdateTime: '2026-04-21T02:41:43Z'
'422':
description: 参数校验错误
'500':
$ref: '#/components/responses/Error'
components:
schemas:
ApiResponse:
type: object
properties:
code:
type: integer
enum:
- 200
- 401
- 402
- 404
- 422
- 429
- 455
- 500
- 501
- 505
description: |-
响应状态码
- **200**：成功，请求已成功处理
- **401**：未授权，缺少认证信息或认证无效
- **402**：额度不足，账户额度不足以完成本次操作
- **404**：资源不存在，请求的资源或接口不存在
- **422**：参数校验错误，请求参数未通过校验
- **429**：请求过于频繁，已超出当前资源的调用限制
- **455**：服务不可用，系统当前正在维护中
- **500**：服务器错误，处理请求时发生了意外错误
- **501**：生成失败，内容生成任务执行失败
- **505**：功能已禁用，请求的功能当前不可用
message:
type: string
description: 响应消息；失败时为错误说明
example: success
responses:
Error:
description: 服务器错误
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: |-
所有接口均需通过 API Key 进行认证。
获取 API Key：
1. 访问 [API Key 管理页面](https://crun.ai/zh/user-api-key) 获取你的 API Key
使用方式：
在请求头中添加：
x-api-key: YOUR_API_KEY
注意事项：
- 请妥善保管你的 API Key，不要泄露给他人
- 如果怀疑 API Key 已泄露，请立即在管理页面中重置
````