> For AI agents: the complete documentation index is available at https://docs.reelway.ai/llms.txt, the full documentation bundle is available at https://docs.reelway.ai/llms-full.txt.

# 媒体工具与语音

本页覆盖生成主流程之外的「周边能力」:如何把源媒体稳定地供给给任务、如何在提交前预估费用、如何合成语音,以及 H3 的两段式参考视频变体。

## 供给源媒体 \{#资产库}

一次性输入用[预签名 URL](https://docs.reelway.ai/api-reference/media.md) 即可;需要**复用、去重与配额管理**时使用资产库。资产库在同一对象存储之上提供四步状态机:


GEThttps://rcn.reelway.ai/v1/assets/capabilities鉴权:凭证

enabled(是否已配置对象存储)/ maxSizeBytes / hashAlgorithm=sha256



GEThttps://rcn.reelway.ai/v1/assets鉴权:凭证

近 500 条资产 + 配额 limits



POSThttps://rcn.reelway.ai/v1/assets/prepare鉴权:凭证

按 sha256 去重;签发 uploadUrl 或直接复用



POSThttps://rcn.reelway.ai/v1/assets/{id}/finalize鉴权:凭证

服务端复验 sha256 + size 后置 ready



POSThttps://rcn.reelway.ai/v1/assets/{id}/bind鉴权:凭证

把 ready 资产绑定到项目槽位



DELETEhttps://rcn.reelway.ai/v1/assets/{id}鉴权:凭证

注销资产,尽力删除对象



### prepare
`POST /v1/assets/prepare`,body `{ "sha256", "bytes", "contentType", "name" }`。同账户已有相同 `sha256` 且状态 `ready` 的资产时直接返回该资产并标 `reused: true`,**跳过上传**;否则创建 `uploading` 档并返回 `uploadUrl`。单文件上限 100 MiB。
### PUT
把文件体 PUT 到 `uploadUrl`。
### finalize
`POST /v1/assets/{id}/finalize`。服务端复验哈希与大小:对象未上传 → `400`;校验不符 → `400` 且资产置 `failed`。通过后置 `ready`。
### bind
`POST /v1/assets/{id}/bind`,body `{ "projectId", "type" }`(`type` 为槽位,如 `startingImage`)。资产非 `ready` 返回 `423`。绑定写入 `asset_bindings`,随后该项目的 `jobRequest` 即可引用。

### 配额

| 项    | 限制                         |
| ---- | -------------------------- |
| 资产条目 | 500                        |
| 总容量  | 5 GiB                      |
| 单文件  | `maxSizeBytes`(当前 100 MiB) |
| 闲置回收 | 7 天未绑定的资产可被回收              |
| 每日拷贝 | 1 GiB                      |
| 每日绑定 | 1000 次                     |

实际值以 `GET /v1/assets` 返回的 `limits` 为准。

## 提交前预估费用


GEThttps://rcn.reelway.ai/socket/api/v1/job/estimate/{tokenType}/{model}/…鉴权:凭证

裸 JSON;媒体估价包在 quote.project 下


SDK 的 `estimateVideoCost()`
 等方法调用此端点。预览当前返回结构完整但数值为零的诚实零报价;价格规则接入后返回真实预估
实际扣费以受理时的价格规则为准(模型 × 分辨率桶);缺少价格行时提交返回 `400`(`1014`),不会静默免费。

## 语音合成与参考音频克隆

目录模型 `cosyvoice3-tts-0.5b`(CosyVoice 3,0.5B)提供**零样本声音克隆** TTS:给定一段参考音频与目标文本,合成同音色语音。作为 `audio` 媒体类型的项目提交:

```js
const project = client.projects.create({
  modelId: 'cosyvoice3-tts-0.5b',
  positivePrompt: '欢迎使用 Reelway,祝你创作愉快。',   // 要合成的文本
  referenceAudio: fs.readFileSync('./voice.wav'),        // 克隆音色参考
});
const [audioUrl] = await project.waitForCompletion();   // 经 /v1/media/downloadUrl 签发
```

参数细节见[CosyVoice 3 TTS](https://docs.reelway.ai/models/cosyvoice3-tts.md)。

## MiniMax H3 两段式参考视频

`minimax-h3-ref2va-fp8_r2v_2stage` 与 `_balanced_2stage` 以两段推理换取更强的主体一致性与更长的有效时长,代价是更高的耗时与费用。输入与普通 r2v 相同(参考图 + 提示词),直接替换 `modelId` 即可。详见[MiniMax H3](https://docs.reelway.ai/models/minimax-h3.md#%E4%B8%A4%E6%AE%B5%E5%BC%8F%E5%8F%82%E8%80%83%E8%A7%86%E9%A2%91)。

## 当前未提供的媒体工具

背景移除、3D 重建、对象选择(分割)与视频超分当前**不在模型目录中**,API 不提供对应端点。目录更新以 `GET /v1/model-catalog` 与[模型指南](https://docs.reelway.ai/models/index.md)为准。