平台简介

OmniDoc API 面向一个账号下的文件与内容工作流。调用方使用 API Key 创建资源，随后用返回的稳定 ID 查询、组合、处理或下载。

资源模型

资源	用途
Document / File	账号拥有的源文件与文件库条目
Job / Operation	翻译、文档处理、AI 或音视频异步任务
Artifact	任务交付的可预览或可下载结果
Credit operation	一次收费动作的实扣与退款凭证

资源始终按账号归属校验。客户端只需要保存公开 ID，不应从 ID、文件名或下载地址推断实现细节。

通用调用流程

1. 创建或选择输入资源。
2. 确认账号有可用积分：开始前按门槛检查余额，完成后按实际用量扣费。
3. 使用 Idempotency-Key 创建任务。
4. 查询任务状态；文件翻译任务还可使用 SSE 或 Webhook。
5. 读取结果和本次积分凭证。

同步响应与异步任务

查询、列表和轻量操作通常同步返回。翻译、文档处理和音视频任务会立即返回任务 ID；HTTP 请求结束不代表任务已经完成。

接入身份

外部集成统一使用 API Key，权限与创建 Key 的账号一致。详情见认证。

快速开始 → 上传文件、创建任务、查询状态并下载结果