Seedance 怎么控制画幅比例：横屏、竖屏和方形输出

在 RelayDance 上控制 Seedance 的画幅比例，需要在提交视频任务时通过 metadata.ratio 参数指定，配合 metadata.resolution 设定分辨率。提交接口为 POST /v1/video/generations，接口采用 OpenAI 兼容协议，横屏、竖屏和方形输出均由 ratio 字段决定。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，无需更换现有客户端。

如何用 ratio 参数指定画幅

画幅比例通过提交任务时的 metadata.ratio 字段控制。在调用 POST /v1/video/generations 时，请求体包含 model、prompt、seconds 以及 metadata，其中 metadata 支持 ratio、resolution、generate_audio、callback_url 和 content[] 等字段。横屏、竖屏与方形三种常见输出，都由 ratio 的取值区分，而分辨率则由 resolution 独立设置。接口地址统一为 https://relaydance.com/v1，鉴权使用 Authorization: Bearer YOUR_API_KEY，API Key 可在 https://relaydance.com/console 创建。单次请求的片段长度最长可达 15 秒。

横屏、竖屏和方形的对照

三种画幅在参数层面仅由 ratio 值区分，其余流程一致。下表列出常见用途对照，具体可用值以实际接口返回为准。

分辨率通过 metadata.resolution 单独指定，Seedance 2.0 提供 720p 与 1080p 等档位，两者互不影响。设定好画幅后即可提交任务并轮询结果。

提交带画幅参数的任务步骤

提交一个指定画幅的 Seedance 任务可按以下步骤操作。

1. 在 https://relaydance.com/console 创建 API Key，并设置 Authorization: Bearer YOUR_API_KEY。
2. 将 base_url 改为 https://relaydance.com/v1，保留原有 OpenAI SDK。
3. 调用 POST /v1/video/generations，在 metadata.ratio 中设定横屏、竖屏或方形，并在 metadata.resolution 中设定分辨率。
4. 如需参考媒体，将文件放入 metadata.content[]，并在 prompt 中用 @image1 至 @imageN 引用，单次最多 9 张参考图、3 段参考视频和 3 条音轨。
5. 轮询 GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed；成功后从结果中读取视频 url。也可设置 metadata.callback_url 使用 Webhook 模式接收最终状态。

不同画幅与分辨率的计费

画幅比例本身不改变计费，费用取决于所选模型与分辨率。据 relaydance.com/models，Seedance 2.0 720p 约 $0.190 / 秒，1080p 约 $0.470 / 秒，Seedance Fast 约 $0.152 / 秒，Seedance 原生 4K 约 $4.90 / 5 秒条。因此无论横屏、竖屏还是方形，同一分辨率下的单价一致。计费为按量付费，支持 USDT 与 Stripe 卡支付。据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」，即任务失败不会产生费用。实时单价请以 https://relaydance.com/models 为准。

常见问题 FAQ

问：画幅比例会影响价格吗？不会。价格由模型与分辨率决定，例如 Seedance 2.0 1080p 约 $0.470 / 秒，横屏与竖屏在同一分辨率下单价相同。

问：任务失败还会扣费吗？不会。据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」。

问：需要更换现有 OpenAI 客户端吗？不需要。只需将 base_url 改为 https://relaydance.com/v1，保留原有 OpenAI SDK 即可调用。