> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omniall.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 去字幕 / 去水印 API

> OmniAll 自研去字幕与去水印接入指南：自动擦除、框选区域与按秒计费。

# 去字幕 / 去水印 API

传入源视频公网链接，异步返回擦除硬字幕或固定水印后的成片。

| 说明 | 方法 | 路径 |
| - | - | - |
| 创建 | `POST` | `/v1/video/generations`（亦可 `/v1/videos`） |
| 查询 | `GET` | `/v1/video/generations/{task_id}` |

**API 主机：** `https://api.omniall.ai` · 鉴权 `Authorization: Bearer sk-...` · 模型：`omniall-desub-1`

| 项 | 说明 |
| - | - |
| 自动去字幕 | 不传 `videoName` |
| 框选 / 去水印 | `videoName`: `x1_y1_x2_y2`（视频真实像素） |
| `duration` / `seconds` | 1–600 秒，强烈建议传入；默认按 10 秒计费 |
| `prompt` | 必填，如 `"去字幕"` |

```bash theme={null}
curl -X POST "https://api.omniall.ai/v1/video/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omniall-desub-1",
    "prompt": "去字幕",
    "video_url": "https://cdn.example.com/input.mp4",
    "duration": 16
  }'
```

完整字段见 **API Reference → 平台 API → 去字幕 / 去水印**。

## 能力与限制

| 项 | 说明 |
| - | - |
| 去除对象 | 烧录在画面里的字幕、文字、静止的角标 / 台标 / Logo 水印 |
| 不适合 | 跟着画面移动的水印、半透明铺满全屏的水印（只能擦固定区域） |
| 输入来源 | 公网可直接下载的 http/https 视频链接；本地文件先上传 |
| 格式 | 服务器会先**自动转成标准 mp4** 再处理，mp4 / mov / 剪映导出等常见格式都可以 |
| 时长 | 1–600 秒（10 分钟内） |
| 文件大小 | 上传接口建议 ≤ 60MB，过大请先压缩或分段 |
| 输出 | 与原视频同分辨率、同时长，保留原声 |

## 常见问题

| 现象 / 报错 | 原因 | 处理 |
| - | - | - |
| `prompt is required` | 没传 `prompt` | 随便传一句，如 `"去字幕"` |
| `去字幕需要公网视频链接` | `video_url` 不是公网 http/https | 先上传换 URL，或换成可直接下载的链接 |
| 框选后字幕还在 | 区域没覆盖到字幕，或按预览图像素填了坐标 | 按**视频真实像素**填，区域适当放宽；不确定位置就先用自动去字幕 |
| 擦掉的地方有点糊 | 擦除区域会按周围画面补全，区域越大越明显 | 区域尽量贴近字幕 / 水印，不要整片框选 |
| 既有字幕又有水印 | 一次只能处理一个区域 | 分两次提交，第二次用第一次的 `result_url` |
| `去字幕服务余额不足` | 去字幕服务暂不可用 | 联系我们处理，费用已退回 |
| 一直处理中 | 视频较长 | 继续轮询，30 分钟仍未完成请带 `task_id` 联系我们 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.