Skip to main content
本页只覆盖 海外 BytePlus Dreamina Seedance 2.0。国内 Doubao Seedance 2.0 使用独立模型、独立价格和独立素材能力，不在本页混写。 PhanEdge 对外提供 BytePlus 原生接口兼容。任务创建、查询和素材库请求的字段尽可能保持 BytePlus 原生形态；任务列表、取消/删除、素材库访问会限制在当前 PhanEdge 租户可见范围内。

​
1. 前置条件

export BASE_URL="https://models.phanedge.cloud"
export TOKEN="oh-xxxxxxxxxxxxxxxx"
统一请求头： 
Authorization: Bearer <TOKEN>
Content-Type: application/json
调用方只需要使用 PhanEdge 发放的 API Token。BytePlus API Key、AK/SK、ProjectName 和 Endpoint 由平台统一托管。

​
2. 模型

对外模型BytePlus 官方模型说明
dreamina-seedance-2-0dreamina-seedance-2-0-260128海外标准模型，支持 480p / 720p / 1080p / 4k
dreamina-seedance-2-0-fastdreamina-seedance-2-0-fast-260128海外快速模型，仅支持 480p / 720p，不支持 1080p / 4k
dreamina-seedance-2-0-minidreamina-seedance-2-0-mini-260615海外 Mini 模型，仅支持 480p / 720p，不支持 1080p / 4k
dreamina-seedance-2-0-filter-offBytePlus Filter-Off 模型海外标准 Filter-Off 模型，价格和能力同 dreamina-seedance-2-0
dreamina-seedance-2-0-fast-filter-offBytePlus Filter-Off 模型海外快速 Filter-Off 模型，价格和能力同 dreamina-seedance-2-0-fast
请求中的 model 建议使用左侧稳定模型名。为兼容 BytePlus 官方版本号，平台也接受以下官方版本名，并在任务查询、任务列表、素材库响应和计费审计中统一归一为左侧稳定模型名：
  • dreamina-seedance-2-0-260128 -> dreamina-seedance-2-0
  • dreamina-seedance-2-0-fast-260128 -> dreamina-seedance-2-0-fast
  • dreamina-seedance-2-0-mini-260615 -> dreamina-seedance-2-0-mini
seedance-2-0、seedance-2-0-260128、seedance-2-0-fast、seedance-2-0-fast-260128、seedance-2-0-mini、dreamina-seedance-2.0-mini 属于控制台或资源页短 ID 或非官方别名，不作为对外 API model 参数兼容。dreamina-seedance-2-0-filter-off-260128、dreamina-seedance-2-0-260128-filter-off、dreamina-seedance-2-0-fast-filter-off-260128、dreamina-seedance-2-0-fast-260128-filter-off 不是 BytePlus 官方模型名，平台也不做兼容映射。 查询和列表响应中的 model 回显创建请求中的 PhanEdge 对外模型，避免向调用方暴露服务配置、计费明细或实现细节。计费和权限以创建请求中的 PhanEdge 对外模型、最终分辨率和参考输入类型为准。 海外 BytePlus Dreamina Seedance 2.0 的 4K 示例使用 dreamina-seedance-2-0 标准模型。dreamina-seedance-2-0-fast 可用于低延迟场景，dreamina-seedance-2-0-mini 可用于更低成本场景，但两者都不能请求 1080p 或 4k。doubao-seedance-2-0-fast 和 doubao-seedance-2-0-mini 是国内 Doubao 语境下的模型名，不作为海外 BytePlus 官方可用示例。 如需锁定官方具体模型版本，请联系平台配置官方版本映射，例如 dreamina-seedance-2-0 -> dreamina-seedance-2-0-260128。Filter-Off 模型需要完成精确版本映射，避免静默降级到普通模型。

​
2.1 4K 能力

海外标准模型支持 4K。请求体中 resolution 使用 4k；海外 fast 和 mini 模型不支持 1080p 或 4k，需要降级到 480p / 720p。 4K 输出为 10-bit / H.265。按 ratio + resolution=4k 推导的尺寸如下：
ratio4K size
16:93840x2160
9:162160x3840
1:12880x2880
4:33326x2494
3:42494x3326
21:94398x1886

​
3. 海外价格

SKU价格
dreamina-seedance-2-0-480p-novideo$7.0/M tokens
dreamina-seedance-2-0-480p-video$4.3/M tokens
dreamina-seedance-2-0-720p-novideo$7.0/M tokens
dreamina-seedance-2-0-720p-video$4.3/M tokens
dreamina-seedance-2-0-1080p-novideo$7.7/M tokens
dreamina-seedance-2-0-1080p-video$4.7/M tokens
dreamina-seedance-2-0-4k-novideo$4.0/M tokens
dreamina-seedance-2-0-4k-video$2.4/M tokens
dreamina-seedance-2-0-fast-novideo$5.6/M tokens
dreamina-seedance-2-0-fast-video$3.3/M tokens
dreamina-seedance-2-0-mini-novideo$3.5/M tokens
dreamina-seedance-2-0-mini-video$2.1/M tokens
video 表示请求包含视频参考输入；novideo 表示不包含视频参考输入。平台只对成功出片任务结算，失败任务不会按成功出片计费。 dreamina-seedance-2-0-filter-off 复用 dreamina-seedance-2-0 的全部 SKU 价格；dreamina-seedance-2-0-fast-filter-off 复用 dreamina-seedance-2-0-fast 的全部 SKU 价格。日志和任务审计仍保留创建请求中的 Filter-Off 对外模型名。

​
4. 任务接口

功能路径
创建任务POST /volcark/api/v3/contents/generations/tasks
查询任务GET /volcark/api/v3/contents/generations/tasks/{task_id}
查询租户任务列表GET /volcark/api/v3/contents/generations/tasks
取消或删除任务DELETE /volcark/api/v3/contents/generations/tasks/{task_id}
需要 BytePlus 原生字段和响应的客户应使用本页的 /volcark/api/v3/... 路径。

​
5. 创建任务

curl -X POST "https://models.phanedge.cloud/volcark/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0",
    "content": [
      {
        "type": "text",
        "text": "A quiet cinematic shot of a paper boat floating on calm water, soft morning light."
      }
    ],
    "duration": 4,
    "ratio": "16:9",
    "resolution": "4k",
    "generate_audio": false,
    "watermark": true,
    "return_last_frame": true,
    "execution_expires_after": 3600,
    "priority": 0,
    "safety_identifier": "user-hash-001",
    "callback_url": "https://example.com/volcark/callback"
  }'
Filter-Off 调用只需要替换 model，其他请求字段与普通海外 Dreamina 2.0 保持一致： 
{
  "model": "dreamina-seedance-2-0-filter-off",
  "content": [
    {
      "type": "text",
      "text": "A cinematic product shot with clean studio lighting."
    }
  ],
  "duration": 4,
  "ratio": "16:9",
  "resolution": "720p"
}
典型响应： 
{
  "id": "cgt-20260611204121-462cw"
}
PhanEdge native 响应默认不追加 platform_id，以保持 BytePlus 原生响应形态。 常用字段：
字段说明
content[]BytePlus 多模态输入数组，至少包含 prompt 文本或参考素材
duration4-15 秒，也可按 BytePlus 官方能力传 -1 交给模型服务自动选择
ratioadaptive、16:9、9:16、1:1、4:3、3:4、21:9
resolution480p、720p、1080p、4k；4K 仅标准模型支持，fast 和 mini 模型不支持 1080p / 4k
generate_audio是否生成音频
watermark是否保留水印
return_last_frame成功任务中返回 content.last_frame_url
execution_expires_after任务执行过期时间，官方范围通常为 3600-259200 秒
priority队列优先级 0-9
safety_identifier终端用户稳定标识，建议传哈希后的用户 ID
callback_urlBytePlus 原生任务状态回调地址，必须是非空 HTTPS 公网 URL
CallbackURL兼容别名；平台会规范化为 callback_url 后再提交给模型服务
Mini 边界：dreamina-seedance-2-0-mini 只支持 480p / 720p，不支持音频输入参考。references.audio 或原生 content[].type=audio_url、service_tier=flex、draft=true 会在调用 BytePlus 前被拒绝。海外 mini 默认按 BytePlus AP 区域交付；EU 区域需单独探测后再开放。

​
视频编辑和视频延展

BytePlus 将视频生成、视频编辑和视频延展统一在同一个任务创建接口中表达，不需要切换到新的路径。调用方通过 content[] 传入待编辑或待延展的视频、参考图片或参考音频，再用文本 prompt 描述目标效果。
场景推荐输入
视频编辑text + video_url，video_url.role=reference_video；可额外加入 image_url.role=reference_image 或 audio_url.role=reference_audio
向前或向后延展视频text + 1 个 video_url.role=reference_video，在 prompt 中说明 forward/backward 和是否保留原片段
多段视频衔接text + 2-3 个 video_url.role=reference_video，用 prompt 说明中间过渡和最终顺序
严格首帧或尾帧使用 image_url.role=first_frame / last_frame；普通参考图继续使用 reference_image
PhanEdge 默认要求先通过素材库上传图片、视频或音频，等素材状态变为 Active 后再以 asset://<Asset_Id> 传入。包含 content[].type=video_url 的任务会按视频参考输入 SKU 计费；未包含 video_url 的任务不会进入 *-video SKU。dreamina-seedance-2-0-mini 不支持音频参考输入。 视频编辑示例： 
curl -X POST "https://models.phanedge.cloud/volcark/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0",
    "content": [
      {
        "type": "text",
        "text": "Edit Video 1: replace the red mug with a glass teapot while preserving the original camera movement. Use Image 1 as the style reference."
      },
      {
        "type": "video_url",
        "role": "reference_video",
        "video_url": {
          "url": "asset://asset-20260611210200-video1"
        }
      },
      {
        "type": "image_url",
        "role": "reference_image",
        "image_url": {
          "url": "asset://asset-20260611210100-image1"
        }
      }
    ],
    "duration": 6,
    "ratio": "16:9",
    "resolution": "720p",
    "generate_audio": false
  }'
视频延展示例： 
curl -X POST "https://models.phanedge.cloud/volcark/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0",
    "content": [
      {
        "type": "text",
        "text": "Extend Video 1 backward with the same character, lighting, and handheld camera motion, then end with Video 1."
      },
      {
        "type": "video_url",
        "role": "reference_video",
        "video_url": {
          "url": "asset://asset-20260611210200-video1"
        }
      }
    ],
    "duration": 6,
    "ratio": "16:9",
    "resolution": "720p",
    "generate_audio": false
  }'

​
原生回调

POST /volcark/api/v3/contents/generations/tasks 支持在顶层传入 callback_url。平台会先校验 URL，再随创建任务请求提交给模型服务。 校验规则：
  • 必须是字符串，且去除首尾空白后不能为空。
  • 必须使用 https。
  • 域名必须解析到公网可路由地址；本地、私网、链路本地、多播、CGNAT 等地址会被拒绝。
  • 校验失败时，平台会在请求提交给模型服务前返回 HTTP 400，错误码为 invalid_request。
兼容字段 CallbackURL 会被规范化为 callback_url，不会继续把 CallbackURL 原字段提交给模型服务。如果两个字段同时存在，以 callback_url 为准。 这是原生任务回调透传能力，不是 PhanEdge 幻锋AI webhook broker。回调投递、重试、签名和回调体结构均以模型服务原生能力为准。

​
6. 查询任务

curl "https://models.phanedge.cloud/volcark/api/v3/contents/generations/tasks/cgt-20260611204121-462cw" \
  -H "Authorization: Bearer $TOKEN"
成功响应示例： 
{
  "id": "cgt-20260611204121-462cw",
  "model": "dreamina-seedance-2-0",
  "status": "succeeded",
  "content": {
    "video_url": "https://...",
    "last_frame_url": "https://..."
  },
  "usage": {
    "completion_tokens": 40594,
    "total_tokens": 40594
  },
  "created_at": 1781181681,
  "updated_at": 1781181802,
  "seed": 74719,
  "resolution": "4k",
  "ratio": "16:9",
  "duration": 4,
  "framespersecond": 24,
  "service_tier": "default",
  "execution_expires_after": 3600,
  "generate_audio": false,
  "draft": false,
  "safety_identifier": "user-hash-001",
  "priority": 0
}
常见状态：
  • queued
  • running
  • succeeded
  • failed
  • expired
  • cancelled
结果 URL 通常约 24 小时有效，请及时转存。若请求了 return_last_frame=true，成功结果可能包含 content.last_frame_url。

​
7. 查询租户任务列表

curl "https://models.phanedge.cloud/volcark/api/v3/contents/generations/tasks?page_num=1&page_size=20&filter.status=succeeded&filter.model=dreamina-seedance-2-0" \
  -H "Authorization: Bearer $TOKEN"
响应形态： 
{
  "items": [
    {
      "id": "cgt-20260611204121-462cw",
      "status": "succeeded",
      "model": "dreamina-seedance-2-0",
      "execution_expires_after": 3600,
      "service_tier": "default",
      "safety_identifier": "user-hash-001"
    }
  ],
  "total": 1
}
支持的查询参数：
参数说明
page_num页码，从 1 开始
page_size每页数量
filter.statusqueued、running、succeeded、failed、expired、cancelled
filter.model创建请求中的 PhanEdge 对外模型
filter.task_ids逗号分隔的 BytePlus 原生任务 ID
列表接口是 当前 PhanEdge 租户作用域内 的 BytePlus 兼容列表，不返回其他租户或账号级全量任务。

​
8. 取消或删除任务

curl -X DELETE "https://models.phanedge.cloud/volcark/api/v3/contents/generations/tasks/cgt-20260611204121-462cw" \
  -H "Authorization: Bearer $TOKEN"
正在运行的任务可能返回 409： 
{
  "error": {
    "code": "InvalidAction.RunningTaskDeletion",
    "message": "Cannot delete task because it is currently running.",
    "param": "",
    "type": "Conflict"
  }
}
PhanEdge 会保留本地任务审计和计费记录。对不支持运行中删除的任务，终态任务删除会在 PhanEdge 租户内本地隐藏，运行中任务返回 409。删除或取消只允许操作当前租户自己的任务。

​
9. 素材库工作流

素材库能力随海外 Dreamina 2.0 提供，用于完成：
  1. 创建素材组
  2. 上传图片、视频或音频素材
  3. 保存 CreateAsset 返回的 Result.Id
  4. 使用 GetAsset 查询素材生命周期，只有 Active 可进入生成任务
所有 Asset API 挂载在： 
POST /volcark/?Action={ActionName}&Version=2024-01-01
支持的 Action：
功能Action
创建素材组CreateAssetGroup
创建素材CreateAsset
查询素材组列表ListAssetGroups
查询素材列表ListAssets
查询单个素材组GetAssetGroup
查询单个素材GetAsset
不开放 Update*、Delete* 和 Moderation.Strategy=Skip。 CreateAssetGroup 与 CreateAsset 成功时 Result 只返回 Id。素材状态、URL、审核或预处理失败原因不在 Create 响应中展开；调用方应保存 Result.Id，再用 GetAsset 或 ListAssets 查询生命周期。

​
9.1 创建素材组

curl -X POST "https://models.phanedge.cloud/volcark/?Action=CreateAssetGroup&Version=2024-01-01" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-fast",
    "Name": "campaign-product-shots",
    "GroupType": "AIGC",
    "Description": "Assets for product videos"
  }'
典型响应： 
{
  "ResponseMetadata": {
    "Action": "CreateAssetGroup",
    "Region": "ap-southeast-1",
    "Service": "ark",
    "Version": "2024-01-01"
  },
  "Result": {
    "Id": "group-20260611210000-abcd1"
  }
}

​
9.2 创建素材

curl -X POST "https://models.phanedge.cloud/volcark/?Action=CreateAsset&Version=2024-01-01" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-fast",
    "GroupId": "group-20260611210000-abcd1",
    "URL": "https://example.com/product.png",
    "AssetType": "Image",
    "Name": "product-front.png"
  }'
说明：
  • AssetType 支持 Image、Video、Audio
  • 推荐使用 URL 字段，平台也兼容 Url / url
  • Result.Id 是后续 GetAsset 和 asset://<Result.Id> 使用的稳定素材 ID
  • 素材 URL 必须公网可下载，不能依赖 Cookie、登录态或一次性链接
  • 只有 Status=Active 的素材才能用于视频生成
典型响应： 
{
  "ResponseMetadata": {
    "Action": "CreateAsset",
    "Service": "ark",
    "Version": "2024-01-01"
  },
  "Result": {
    "Id": "asset-20260611210100-efgh2"
  }
}

​
9.3 查询素材

curl -X POST "https://models.phanedge.cloud/volcark/?Action=GetAsset&Version=2024-01-01" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-fast",
    "Id": "asset-20260611210100-efgh2"
  }'
常见状态：
  • Processing
  • Active
  • Failed
CreateAsset 返回 Result.Id 后即可用 GetAsset 查询生命周期。若状态仍为 Processing，请按 2、5、10、20 秒退避轮询，直到进入 Active 或 Failed。

​
9.4 查询素材列表

curl -X POST "https://models.phanedge.cloud/volcark/?Action=ListAssets&Version=2024-01-01" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-fast",
    "Filter": {
      "GroupType": "AIGC",
      "GroupIds": ["group-20260611210000-abcd1"]
    },
    "PageNumber": 1,
    "PageSize": 20
  }'
ListAssets 和 ListAssetGroups 只返回当前 PhanEdge 租户可见的素材；调用方需按官方素材库契约提供 Filter.GroupType=AIGC。 典型响应： 
{
  "ResponseMetadata": {
    "Action": "ListAssets",
    "Service": "ark",
    "Version": "2024-01-01"
  },
  "Result": {
    "Items": [
      {
        "Id": "asset-20260611210100-efgh2",
        "GroupId": "group-20260611210000-abcd1",
        "AssetType": "Image",
        "Status": "Active"
      }
    ],
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 20
  }
}

​
10. 在生成任务中使用素材

素材进入 Active 后，用 asset://<Asset_Id> 作为 BytePlus content 输入： 
curl -X POST "https://models.phanedge.cloud/volcark/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-fast",
    "content": [
      {
        "type": "text",
        "text": "Use Image 1 as the opening frame, then slowly move the camera forward."
      },
      {
        "type": "image_url",
        "role": "reference_image",
        "image_url": {
          "url": "asset://asset-20260611210100-efgh2"
        }
      }
    ],
    "duration": 4,
    "ratio": "16:9",
    "resolution": "480p",
    "generate_audio": false
  }'
平台也接受 Asset://...，并会在转发前规范化为 asset://...。 如果素材是视频，使用 type=video_url 并设置 role=reference_video；该写法适用于视频编辑、视频延展和多段视频衔接。严格首帧或尾帧控制请改用图片素材并设置 role=first_frame / last_frame。

​
11. 多租户边界

能力PhanEdge 行为
任务创建请求参数尽量保持 BytePlus 原生形态，服务端兼容差异由 PhanEdge 处理
任务查询只能查询当前租户创建的任务，响应字段按 BytePlus 兼容层归一
任务列表只返回当前租户任务，不返回 BytePlus 账号级全量任务
取消/删除只能操作当前租户任务，并保留平台审计记录
素材组/素材只允许访问当前租户拥有的资源
素材引用asset:// 会绑定到当前租户的素材资源范围，避免跨范围或跨租户误用

​
12. 常见错误

HTTPcode场景
400invalid_request请求体不是合法 JSON，或缺少必填字段
400invalid_durationduration 超出模型允许范围
400moderation_skip_not_allowed素材库请求尝试使用 Moderation.Strategy=Skip
403InvalidAction请求了未开放的 Asset Update* / Delete*
404task_not_found任务不存在或不属于当前租户
404ResourceNotFound.Asset素材不存在或不属于当前租户
404ResourceNotFound.AssetGroup素材组不存在或不属于当前租户
409InvalidAction.RunningTaskDeletion正在运行的任务暂不支持删除
502service_error模型服务返回异常
503service_unavailable当前账号暂未开通海外 Dreamina 2.0 或素材库能力
503model_mapping_requiredFilter-Off 模型未完成精确官方版本映射，或映射到了普通 Dreamina 模型
素材库控制面接口的错误响应使用火山/BytePlus 风格 ResponseMetadata.Error。素材审核或预处理失败不是 Create 错误响应，而是在 GetAsset / ListAssets 中以 Status=Failed 体现。