数眼智能
官网主页控制台API文档
条款与协议
官网主页控制台API文档
条款与协议
  1. 豆包Seedance视频生成
  • 快速开始
    • 平台简介
    • 控制台(入门)
    • API key
    • Base URL
  • 开发工具接入
    • OpenClaw
    • Claude Code
    • Claude Code IDE
    • Codex
    • OpenCode
    • Cline
    • Grok CLI
    • Gemini CLI
    • N8N
    • AutoClaw
    • 其他工具
  • AI大模型API
    • 文本生成API
      • 对话补全 Chat Completions
    • 视频生成接口API
      • 豆包Seedance视频生成
        • 00-概述
        • 01-创建视频生成任务
        • 02-查询视频生成任务
        • 03-查询视频生成任务列表
        • 04-取消或删除视频生成任务
        • Seedance 私域素材库 API
      • 海螺Hailuo视频生成
        • 00-概述
        • 01-文生视频-T2V
        • 02-图生视频-I2V
        • 03-首尾帧生成视频-FL2V
        • 04-主体参考视频-S2V
        • 05-查询任务状态
        • 06-视频下载
        • 07-附录-运镜指令与回调
      • MiniMax-H3视频生成
        • 00-概述
        • 01-创建视频生成任务
        • 02-创建视频再生成任务
        • 03-创建H3-Context-IR任务
        • 04-查询任务
        • 05-查询任务列表
        • 06-取消或删除任务
      • 可灵AI视频生成-新版接口
        • 00-概述
        • 01-文生视频
        • 02-图生视频
        • 03-Omni视频生成
        • 04-动作控制
        • 05-查询任务
      • 可灵AI视频生成-原版接口
        • 00-概述
        • 01-文生视频
        • 02-图生视频
        • 03-视频Omni
        • 04-多图参考生视频
        • 05-动作控制
        • 06-多模态视频编辑
        • 07-视频延长
        • 08-对口型
        • 09-数字人
        • 10-文生音效
        • 11-视频配音效
        • 12-语音合成
        • 13-音色克隆
        • 14-图像识别
        • 15-主体管理
        • 16-视频特效
      • Vidu视频生成
        • 00-概述
        • 01-文生视频
        • 02-图生视频
        • 03-参考生视频
        • 04-首尾帧
        • 05-智能多帧
        • 06-场景特效模板
        • 07-模板成片
        • 08-查询任务
      • 即梦视频生成
        • 00-概述
        • 01-3.0Pro视频生成
        • 02-720P文生视频
        • 03-720P图生视频-首帧
        • 04-720P图生视频-首尾帧
        • 05-720P图生视频-运镜
        • 06-1080P文生视频
        • 07-1080P图生视频-首帧
        • 08-1080P图生视频-首尾帧
        • 09-错误码
      • 万相视频生成
        • 00-概述
        • 01-文生视频
        • 02-图生视频
        • 03-参考生视频
        • 04-视频编辑
        • 05-首尾帧生视频
        • 06-动作迁移与视频换人
        • 07-数字人视频
        • 08-通用视频编辑-VACE
        • 09-查询任务
      • HappyHorse
        • HappyHorse-文生视频
        • HappyHorse-图生视频-基于首帧
        • HappyHorse-参考生视频
        • HappyHorse-视频编辑
    • 通用图像生成API
      • 图像生成接口文档
    • Rerank重排序模型
      • 重排序
  • 搜索/阅读API
    • 网页阅读API
      • Web Reader API
    • 联网搜索API
      • 搜索API
      • 搜索+阅读API
    • 模态卡API
      • 天气
        • 天气模态卡
        • 城市 ID 对照表
        • 天气查询API
      • 搜索 API(旧)
      • 热搜 API
    • 文件OCR解析API
      • PDF文件
      • URL解析
  • 进阶与系统接口
    • CODE&错误码
    • HTTP注意事项
    • 身份验证
    • 接入指南
    • 在线调试
    • 数据更新相关
    • API 密钥与额度查询接口
    • API 密钥管理接口文档
    • 额度与密钥查询
    • Models(列出模型)
    • 查询账户信息
  1. 豆包Seedance视频生成

Seedance 私域素材库 API

Seedance 私域素材库 API 文档#

版本:v1.1  |  更新日期:2026-11-02  |  适用环境:数眼智能公有云

目录#

1. 概述
2. 接入准备
3. 通用协议
4. 素材组接口
4.1 创建素材组 CreateAssetGroup
4.2 查询素材组列表 ListAssetGroups
4.3 查询素材组详情 GetAssetGroup
4.4 更新素材组 UpdateAssetGroup
4.5 删除素材组 DeleteAssetGroup
5. 素材接口
5.1 上传素材 CreateAsset
5.2 查询素材列表 ListAssets
5.3 查询素材详情 GetAsset
5.4 更新素材 UpdateAsset
5.5 删除素材 DeleteAsset
6. 在视频生成中引用素材
6.1 提交视频生成任务
6.2 查询视频生成结果
7. 端到端调用示例
8. 素材状态机
9. 错误码参考
10. 使用限制
10.1 素材文件规格
10.2 时效性
10.3 计费说明
11. 常见问题
12. 变更记录

1. 概述#

Seedance 私域素材库用于集中托管视频生成要反复使用的素材。您可以通过 API 或控制台的「SD素材库」页面上传图片、视频、音频,托管完成后在视频生成请求中通过 asset://<AssetId> 引用,无需每次重复上传原始文件。

核心能力#

能力说明
素材组管理按业务维度对素材进行分组,支持增删改查
素材托管支持 Image / Video / Audio 三类资源的异步上传、状态查询、引用与删除
账号隔离所有资源以账号为隔离边界,同一账号下的所有 API Key 共享同一套素材库,跨账号资源不可互访
内容审核素材上传后自动进行内容安全审核,仅审核通过(Active 状态)的素材可参与视频生成

典型场景#

角色一致性:将稳定的人像素材上传为参考图,保证多镜头主角外观一致。
品牌资产复用:Logo、产品图、背景音乐等长期使用的素材统一托管,避免重复上传。
批量生成:素材一次上传、多次引用,节省重复下载与审核耗时。

2. 接入准备#

2.1 服务地址#

环境地址
数眼智能https://platform.shuyanai.com
私有化部署由部署方提供,按合同约定

2.2 获取 API Key#

登录控制台,在「模型 API Key」页面(www.shuyanai.com/admin/tokens)创建 Key。建议为不同业务线分配独立 Key,便于审计与限流。

2.3 鉴权方式#

所有请求必须在 HTTP 头中携带 API Key:
Authorization: Bearer sk-xxx
鉴权失败响应示例:
场景HTTP 状态码响应体
未提供 Key401{"error":{"code":"","message":"未提供令牌 (request id: ...)","type":"server_error"}}
Key 无效或已禁用401{"error":{"code":"","message":"无效的令牌 (request id: ...)","type":"server_error"}}

3. 通用协议#

3.1 请求路由#

素材库接口统一通过 Query 参数 Action 区分操作类型:
POST https://platform.shuyanai.com/seedance?Action=<ActionName>&Version=2024-01-01
参数说明
Action操作名称,区分大小写。如 CreateAssetGroup、ListAssets
VersionAPI 版本号,当前固定为 2024-01-01
视频生成接口路径独立,不走 Action 路由:
POST /seedance/api/v3/contents/generations/tasks
GET  /seedance/api/v3/contents/generations/tasks/{task_id}

3.2 请求格式#

Content-Type:application/json
字段命名:素材库接口使用 PascalCase(如 GroupId、AssetType);视频生成接口使用 snake_case(如 image_url、generate_audio)

3.3 响应格式#

成功响应:业务数据位于 Result 中。
创建、查询详情、更新、删除接口:
{
  "Result": {
    "Id": "group-20260624152835-lb6rn"
  }
}
列表接口(ListAssetGroups、ListAssets)额外返回 ResponseMetadata:
{
  "ResponseMetadata": {
    "Action": "ListAssetGroups",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Items": [],
    "TotalCount": 0,
    "PageNumber": 1,
    "PageSize": 10
  }
}
失败响应有两种形态:
形态一 — 网关层错误(鉴权失败、资源归属校验、参数缺失等,不含 ResponseMetadata):
{
  "error": "resource not found or not owned by user"
}
形态二 — 业务层错误(参数校验、业务规则等,含 ResponseMetadata.Error):
{
  "ResponseMetadata": {
    "RequestId": "...",
    "Action": "CreateAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing",
    "Error": {
      "Code": "MissingParameter.Name",
      "Message": "The required parameter Name is missing."
    }
  }
}

3.4 资源 ID 格式#

资源类型格式示例
素材组group-<YYYYMMDDHHmmss>-<随机后缀>group-20260624152835-lb6rn
素材asset-<YYYYMMDDHHmmss>-<随机后缀>asset-20260624152850-mftbb
视频任务cgt-<YYYYMMDDHHmmss>-<随机后缀>cgt-20260624152927-ptz2s

4. 素材组接口#

素材组是素材的逻辑容器,用于按业务维度对素材进行分类管理。

4.1 创建素材组 CreateAssetGroup#

创建一个素材分组容器。
请求:
POST /seedance?Action=CreateAssetGroup&Version=2024-01-01
请求参数:
参数类型必填说明
Namestring是素材组名称,1 ~ 64 字符
Descriptionstring否素材组描述,最长 256 字符
GroupTypestring否素材组类型,默认 AIGC,当前仅支持 AIGC
请求示例:
响应参数:
参数类型说明
Result.Idstring新建素材组 ID
响应示例:
{
  "Result": {
    "Id": "group-20260624152835-lb6rn"
  }
}

4.2 查询素材组列表 ListAssetGroups#

分页查询当前账号名下的素材组。系统自动按账号隔离,无需传入账号相关参数。
请求:
POST /seedance?Action=ListAssetGroups&Version=2024-01-01
请求参数:
参数类型必填说明
PageNumberinteger否页码,默认 1,从 1 开始
PageSizeinteger否每页条数,默认 10,最大 100
Filter.Namestring否名称模糊匹配
Filter.Statusesstring[]否状态过滤:Processing / Active / Failed
请求示例:
响应参数:
参数类型说明
Result.TotalCountinteger命中总数
Result.PageNumberinteger当前页码
Result.PageSizeinteger当前页大小
Result.Items[]array素材组列表
Result.Items[].Idstring素材组 ID
Result.Items[].Namestring素材组名称
Result.Items[].Descriptionstring素材组描述
Result.Items[].GroupTypestring类型,固定 AIGC
Result.Items[].Statusstring素材组状态:Processing / Active / Failed
响应示例:
{
  "ResponseMetadata": {
    "Action": "ListAssetGroups",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 10,
    "Items": [
      {
        "Id": "group-20260624152835-lb6rn",
        "Name": "brand_visual_lib",
        "Description": "品牌视觉资产库",
        "GroupType": "AIGC",
        "Status": "Active"
      }
    ]
  }
}

4.3 查询素材组详情 GetAssetGroup#

查询单个素材组的详细信息。
请求:
POST /seedance?Action=GetAssetGroup&Version=2024-01-01
请求参数:
参数类型必填说明
Idstring是素材组 ID
请求示例:
响应参数:字段含义同 ListAssetGroups 的 Items[]。
响应示例:
{
  "Result": {
    "Id": "group-20260624152835-lb6rn",
    "Name": "brand_visual_lib",
    "Description": "品牌视觉资产库",
    "GroupType": "AIGC",
    "Status": "Active"
  }
}

4.4 更新素材组 UpdateAssetGroup#

更新素材组的名称或描述。GroupType 创建后不可变更。
请求:
POST /seedance?Action=UpdateAssetGroup&Version=2024-01-01
请求参数:
参数类型必填说明
Idstring是素材组 ID
Namestring否新名称,1 ~ 64 字符
Descriptionstring否新描述,最长 256 字符
请求示例:
响应示例:
{
  "Result": {
    "Id": "group-20260624152835-lb6rn"
  }
}

4.5 删除素材组 DeleteAssetGroup#

删除素材组。建议删除前先调用 ListAssets 确认组内素材已不再使用。
请求:
POST /seedance?Action=DeleteAssetGroup&Version=2024-01-01
请求参数:
参数类型必填说明
Idstring是素材组 ID
请求示例:
响应示例:
{
  "Result": {
    "Id": "group-20260624152835-lb6rn"
  }
}

5. 素材接口#

5.1 上传素材 CreateAsset#

从公网 URL 拉取资源并入库。本接口为异步接口,返回成功仅表示任务已受理;需轮询 GetAsset 直至状态变为 Active 后方可在视频生成中引用。
请求:
POST /seedance?Action=CreateAsset&Version=2024-01-01
请求参数:
参数类型必填说明
GroupIdstring是所属素材组 ID
URLstring是素材公网可访问地址
AssetTypestring是素材类型:Image / Video / Audio
Namestring否素材名称,1 ~ 64 字符。仅用于 ListAssets 模糊搜索,不会被带入模型推理
请求示例:
响应参数:
参数类型说明
Result.Idstring新建素材 ID
响应示例:
{
  "Result": {
    "Id": "asset-20260624152850-mftbb"
  }
}
提示:上传后请轮询素材状态。图片资源通常 3 ~ 10 秒内变为 Active,视频和音频可能需要更长时间。

5.2 查询素材列表 ListAssets#

分页查询素材,支持按素材组、状态、名称过滤。系统自动按账号隔离。
请求:
POST /seedance?Action=ListAssets&Version=2024-01-01
请求参数:
参数类型必填说明
Filter.GroupIdsstring[]否按素材组 ID 过滤
Filter.Statusesstring[]否状态过滤:Processing / Active / Failed
Filter.Namestring否名称模糊匹配
PageNumberinteger否页码,默认 1
PageSizeinteger否每页条数,默认 10,最大 100
说明:请求体中 Filter 为嵌套对象,参数表中使用点号表示层级关系。例如 Filter.Statuses 对应请求体中的 {"Filter": {"Statuses": [...]}}。
请求示例:
响应参数:
参数类型说明
Result.TotalCountinteger命中总数
Result.PageNumberinteger当前页码
Result.PageSizeinteger当前页大小
Result.Items[]array素材列表
Result.Items[].Idstring素材 ID
Result.Items[].Namestring素材名称
Result.Items[].Descriptionstring素材描述
Result.Items[].URLstring上传素材时提交的源地址
Result.Items[].AssetTypestring素材类型
Result.Items[].GroupIdstring所属素材组 ID
Result.Items[].Statusstring状态:Processing / Active / Failed
响应示例:
{
  "ResponseMetadata": {
    "Action": "ListAssets",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 10,
    "Items": [
      {
        "Id": "asset-20260624152850-mftbb",
        "Name": "产品主图",
        "Description": "",
        "URL": "https://example.com/product-photo.png",
        "AssetType": "Image",
        "GroupId": "group-20260624152835-lb6rn",
        "Status": "Active"
      }
    ]
  }
}

5.3 查询素材详情 GetAsset#

查询单个素材的详细信息,主要用于上传后轮询素材处理状态。
请求:
POST /seedance?Action=GetAsset&Version=2024-01-01
请求参数:
参数类型必填说明
Idstring是素材 ID
请求示例:
响应参数:字段含义同 ListAssets 的 Items[]。
响应示例(Active 状态):
{
  "Result": {
    "Id": "asset-20260624152850-mftbb",
    "Name": "产品主图",
    "Description": "",
    "URL": "https://example.com/product-photo.png",
    "AssetType": "Image",
    "GroupId": "group-20260624152835-lb6rn",
    "Status": "Active"
  }
}
轮询策略建议:
阶段间隔说明
首次查询3 秒后图片通常 3 ~ 10 秒完成
后续查询指数退避至 10 秒视频 / 音频可能需要更长时间
超时退出5 分钟超时仍为 Processing,请检查源 URL 可访问性

5.4 更新素材 UpdateAsset#

更新素材名称。素材的 URL、类型、所属素材组均不可变更,如需更换请删除后重新上传。
请求:
POST /seedance?Action=UpdateAsset&Version=2024-01-01
请求参数:
参数类型必填说明
Idstring是素材 ID
Namestring否新名称,1 ~ 64 字符
请求示例:
响应示例:
{
  "Result": {
    "Id": "asset-20260624152850-mftbb"
  }
}

5.5 删除素材 DeleteAsset#

删除素材,不可恢复。已被进行中的视频生成任务引用的素材不建议立即删除,否则可能导致生成失败。
请求:
POST /seedance?Action=DeleteAsset&Version=2024-01-01
请求参数:
参数类型必填说明
Idstring是素材 ID
请求示例:
响应示例:
{
  "Result": {
    "Id": "asset-20260624152850-mftbb"
  }
}

6. 在视频生成中引用素材#

素材状态变为 Active 后,可在 Seedance 视频生成接口中通过 asset://<AssetId> 引用。

6.1 提交视频生成任务#

请求:
POST /seedance/api/v3/contents/generations/tasks
请求参数:
参数类型必填说明
modelstring是模型名称,如 doubao-seedance-2-0-260128
contentarray是内容数组,包含文本描述和素材引用
content[].typestring是内容类型:text、image_url、video_url、audio_url
content[].textstring条件当 type=text 时必填,视频描述文本
content[].rolestring条件素材角色,如 reference_image、reference_video、reference_audio
content[].image_url.urlstring条件当 type=image_url 时必填,支持 asset://<AssetId> 或公网 URL
ratiostring否画面比例,如 16:9、9:16、1:1
durationinteger否视频时长(秒),如 5、10
watermarkboolean否是否添加水印,默认 false
generate_audioboolean否是否生成有声视频,默认 true
完整参数见01-创建视频生成任务。
素材引用方式:在 content 数组中通过 asset://<AssetId> 传入素材,在 prompt 文本中使用"图片 1、视频 1、音频 1"等序号指代(序号为该素材在同类素材中的出现顺序)。请勿在 prompt 中直接使用 Asset ID。
请求示例:
响应示例:
{
  "id": "cgt-20260624152927-ptz2s"
}

6.2 查询视频生成结果#

视频生成为异步任务,提交后需轮询查询结果。
请求:
GET /seedance/api/v3/contents/generations/tasks/{task_id}
请求示例:
响应参数:
参数类型说明
idstring任务 ID
modelstring使用的模型
statusstring任务状态:queued / running / succeeded / failed / cancelled / expired
content.video_urlstring视频下载链接(succeeded 时返回),有效期 24 小时
usage.completion_tokensinteger生成消耗的 Token 数
usage.total_tokensinteger总消耗 Token 数
created_atinteger任务创建时间(Unix 时间戳,秒)
updated_atinteger任务更新时间(Unix 时间戳,秒)
seedinteger本次生成的随机种子
resolutionstring输出分辨率,如 720p
ratiostring画面比例
durationinteger视频时长(秒)
framespersecondinteger帧率,默认 24
service_tierstring服务等级
execution_expires_afterinteger任务超时阈值(秒),默认 172800(48 小时)
generate_audioboolean是否生成有声视频
完整字段说明见02-查询视频生成任务。
响应示例(运行中):
{
  "id": "cgt-20260624152927-ptz2s",
  "model": "doubao-seedance-2-0-260128",
  "status": "running",
  "created_at": 1782286167,
  "updated_at": 1782286167,
  "service_tier": "default",
  "execution_expires_after": 172800,
  "generate_audio": true,
  "draft": false,
  "priority": 0
}
响应示例(生成成功):
{
  "id": "cgt-20260624152927-ptz2s",
  "model": "doubao-seedance-2-0-260128",
  "status": "succeeded",
  "content": {
    "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/.../video.mp4?X-Tos-Algorithm=..."
  },
  "usage": {
    "completion_tokens": 108900,
    "total_tokens": 108900
  },
  "created_at": 1782286167,
  "updated_at": 1782286432,
  "seed": 77923,
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "framespersecond": 24,
  "service_tier": "default",
  "execution_expires_after": 172800,
  "generate_audio": true,
  "draft": false,
  "priority": 0
}
轮询策略建议:
阶段间隔说明
初始5 秒排队期间查询可能只返回 id,视同排队中继续轮询
后续10 秒720p / 5 秒视频通常 3 ~ 5 分钟完成,分辨率越高、时长越长耗时越久

7. 端到端调用示例#

以下脚本演示完整的「创建素材组 → 上传素材 → 等待就绪 → 生成视频 → 获取结果」流程。
前置依赖:需安装 jq 命令行 JSON 工具。

8. 素材状态机#

8.1 素材状态流转#

            CreateAsset
                │
                ▼
        ┌───────────────┐    审核失败     ┌──────────┐
        │  Processing   │ ───────────────►│  Failed  │(不可恢复)
        └───────┬───────┘                 └──────────┘
                │ 审核通过
                ▼
        ┌───────────────┐
        │    Active     │  ── 可在视频生成中通过 asset:// 引用
        └───────┬───────┘
                │ DeleteAsset
                ▼
            (已删除)
状态含义可执行操作
Processing处理中,正在拉取源文件并进行内容审核仅可 GetAsset 轮询、DeleteAsset
Active审核通过,可用全量操作;可 asset:// 引用
Failed审核失败或源文件不可访问仅可 DeleteAsset

8.2 视频任务状态流转#

queued ──► running ──► succeeded
  │            │
  │            ├──► failed
  │            └──► expired(超过 execution_expires_after 仍未完成)
  └──► cancelled(仅排队中的任务可取消)
状态含义
queued排队中,等待调度
running生成中
succeeded生成成功,content.video_url 可用
failed生成失败
cancelled已取消
expired已过期(任务超时)

9. 错误码参考#

9.1 网关层错误#

网关层错误不包含 ResponseMetadata,直接返回错误信息。
HTTP 状态码错误信息触发场景处理建议
401未提供令牌请求未携带 Authorization 头检查请求头是否正确设置
401无效的令牌Key 错误、过期或已被禁用在控制台确认 Key 状态,必要时重新创建
400Id is required查询详情、更新、删除接口未传 Id补充 Id
400unsupported action: <Action>Action 名称错误检查 URL 中的 Action 参数
403resource not found or not owned by user素材或素材组不存在,或不属于当前账号检查资源 ID 与 Key 的归属关系
403group not found or not owned by user上传素材时 GroupId 不存在或不属于当前账号检查 GroupId
500素材分组创建失败,所有渠道均不可用,请稍后重试创建素材组失败(缺少 Name 等必填参数时也返回此错误)先检查请求参数,再重试

9.2 业务层错误#

业务层错误包含 ResponseMetadata,错误信息位于 ResponseMetadata.Error 中。
Error.Code说明处理建议
MissingParameter.<字段名>缺少必填参数根据 Message 补充对应字段
InvalidParameter.<字段名>参数格式或取值不合法检查参数值是否符合约束
InvalidActionOrVersionAction 名称或 Version 版本号错误检查 URL 中的 Action 和 Version 参数
SubscriptionRequired未开通所需权益在控制台完成授权签署
业务层错误响应示例:
{
  "ResponseMetadata": {
    "RequestId": "202606241529096954A62A765732A09755",
    "Action": "CreateAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing",
    "Error": {
      "Code": "MissingParameter.Name",
      "Message": "The required parameter Name is missing."
    }
  }
}

9.3 重试策略#

错误类型是否可重试建议
HTTP 5xx可重试指数退避,最多 3 ~ 5 次
网络超时可重试指数退避,最多 3 ~ 5 次
401 鉴权失败不可重试检查 Key 配置
403 资源不属当前用户不可重试检查资源 ID
MissingParameter.*不可重试修正请求参数
InvalidParameter.*不可重试修正请求参数

10. 使用限制#

10.1 素材文件规格#

图片素材
限制项要求
格式jpeg、png、webp、bmp、tiff、gif、heic、heif
文件大小< 30 MB
宽高比(宽/高)(0.4, 2.5)
宽高长度300 ~ 6,000 px
视频素材
限制项要求
格式mp4、mov
文件大小≤ 50 MB
分辨率480p、720p、1080p
时长2 ~ 15 秒
宽高比(宽/高)[0.4, 2.5]
宽高长度300 ~ 6,000 px
总像素数(宽 × 高)409,600 ~ 2,086,876
帧率24 ~ 60 FPS
音频素材
限制项要求
格式wav、mp3
文件大小≤ 15 MB
时长2 ~ 15 秒

10.2 时效性#

项目有效期说明
素材长期删除前一直可引用
视频生成结果(content.video_url)24 小时请及时下载或转存
视频任务 ID7 天从 created_at 开始计算,超时后不可查询

10.3 计费说明#

视频生成按 usage.completion_tokens 计费,具体费率请参见模型广场(www.shuyanai.com/admin/models)。
素材库的存储与审核当前不单独计费。

11. 常见问题#

Q:素材上传后一直处于 Processing 状态?
A:请检查源 URL 是否可被公网正常访问。若 URL 需要登录认证或有地域访问限制,平台将无法拉取资源,最终状态会变为 Failed。图片资源通常 3 ~ 10 秒内完成处理。
Q:调用接口返回 resource not found or not owned by user?
A:该错误表示您访问的资源(素材或素材组)不存在,或不属于当前 API Key 所在的账号。请检查:
1.
资源 ID 是否正确;
2.
是否使用了正确账号下的 API Key。
素材库的隔离粒度为账号级别:同一账号下的所有 API Key 共享同一套素材库数据;不同账号之间完全隔离。
Q:同一账号下不同分组的 API Key 能共享素材吗?
A:可以。素材库按账号隔离,同一账号下所有 API Key 看到的素材组和素材完全一致。使用任意一个 Key 创建的素材,其他 Key 均可查看和引用。
Q:视频生成任务超时仍未完成?
A:视频生成耗时取决于分辨率和时长。720p / 5 秒通常 3 ~ 5 分钟完成;4K 分辨率可能需要 30 分钟以上。

12. 变更记录#

版本日期变更说明
v1.12026-11-02按当前接口返回更新素材组 / 素材的响应结构、列表过滤参数与网关错误信息;video_url 有效期更正为 24 小时
v1.02026-06-24正式发布。覆盖素材组 5 个接口、素材 5 个接口、视频生成集成、错误码与状态机
上一页
04-取消或删除视频生成任务
下一页
00-概述