dreamina-seedance-2-0-260128 · Dreamina Seedance

# dreamina-seedance（海外）· 快速接入 > **适用模型**：`dreamina-seedance-2-5-260628`、`dreamina-seedance-2-0-260128`、`dreamina-seedance-2-0-fast-260128`、`dreamina-seedance-2-0-mini-260615` --- ## 1. 整体流程 ```text ① 建素材组（可选） ② 上传素材 CreateAsset ③ 轮询 GetAsset，直到 Status = Active ④ 提交视频任务，用 asset:// 引用素材 ⑤ 轮询任务，直到 succeeded，下载 video_url ``` 素材接口和视频接口使用**同一个平台令牌**。 --- ## 2. 接入信息 | 项目 | 值 | | --- | --- | | Base URL | `https://us.ruiyumaas.com` | | 鉴权 | `Authorization: Bearer ` | | Content-Type | `application/json` | | 素材接口 | `POST /?Action= &Version=2024-01-01` | | 视频接口 | `POST /api/v3/contents/generations/tasks` | ```bash export BASE="https://us.ruiyumaas.com" export API_KEY=" " ``` --- ## 3. 第 1 步：准备素材组 每个素材必须属于一个素材组。 **查询自己的素材组** ： ```bash curl -X POST "$BASE/?Action=ListAssetGroups&Version=2024-01-01" \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "Filter": {} }' ``` **创建素材组**（可选）： ```bash curl -X POST "$BASE/?Action=CreateAssetGroup&Version=2024-01-01" \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "Name": "portrait_group", "Description": "人像素材" }' ``` 返回： ```json { "ResponseMetadata": { "Action": "CreateAssetGroup", "...": "..." }, "Result": { "Id": "group-20261028120000-xxxxx" } } ``` --- ## 4. 第 2 步：上传素材 ```bash curl -X POST "$BASE/?Action=CreateAsset&Version=2024-01-01" \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "GroupId": "group-20261028120000-xxxxx", "URL": "https://example.com/portrait.png", "AssetType": "Image", "Name": "portrait_front" }' ``` 返回： ```json { "ResponseMetadata": { "Action": "CreateAsset", "...": "..." }, "Result": { "Id": "asset-20261028120500-xxxxx" } } ``` | 字段 | 必填 | 说明 | | --- | --- | --- | | `GroupId` | ✔ | 你自己的素材组 ID | | `URL` | ✔ | 公网可直接访问的图片/视频/音频地址 | | `AssetType` | ✔ | `Image` / `Video` / `Audio`（大小写敏感） | | `Name` | | 素材名称，方便检索 | 上传是**异步**的。拿到 `Id` 后继续轮询。 --- ## 5. 第 3 步：轮询素材状态 ```bash curl -X POST "$BASE/?Action=GetAsset&Version=2024-01-01" \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "Id": "asset-20261028120500-xxxxx" }' ``` | `Status` | 含义 | 下一步 | | --- | --- | --- | | `Processing` | 处理中 | 3–5 秒后继续查询 | | `Active` | 已就绪 | 可以用于生成视频 | | `Failed` | 处理失败 | 检查素材内容与格式，重新上传 | 素材就绪后，在视频请求里写作： ```text asset://asset-20261028120500-xxxxx ``` --- ## 6. 第 4 步：提交视频任务 ```bash curl -X POST "$BASE/api/v3/contents/generations/tasks" \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "dreamina-seedance-2-5-260628", "content": [ { "type": "text", "text": "图片1中的人物面对镜头微笑，轻轻挥手" }, { "type": "image_url", "image_url": { "url": "asset://asset-20261028120500-xxxxx" }, "role": "reference_image" } ], "resolution": "720p", "ratio": "16:9", "duration": 5, "generate_audio": true }' ``` 返回任务 ID： ```json {