产品概览

每个 Open API 产品都会创建带 taskId 的 任务。无论产品类型，都可通过统一任务接口查询与管理。

​

与网站任务分离

Open API 任务与在 vmeg.ai 网页上发起的任务 不是同一套，规则与 API 资产 一致。

• 请仅用 /openapi/v1/tasks/** 与 Webhook 跟踪 API 任务。
• 网站上的任务记录不包含 API 任务；网站任务也不能用 Open API 查询。

​

任务 API

请求与响应字段：任务列表、任务详情、删除任务。 任务列表、详情、删除，以及素材列表、克隆音色查询等，均按 API Key 限定范围；Open API 请求中不包含单独的项目标识字段。

​

同步与异步

​

异步集成清单

1. API 密钥
2. 幂等 — 每个 POST 都携带 X-Idempotency-Key
3. Webhooks — 在 API 配置填写 URL，复制自动生成的 Secret；快速返回 2xx
4. 调用 create-async → 保存 taskId
5. 处理 Webhook 请求体 — 先看 event（openapi-tts、openapi-translate 等），再解析 data

​

同步集成

调用非 async 的 create 时携带 X-Idempotency-Key，从 HTTP data 读取结果。

​

任务类型

taskType 使用短代码：

​

产品指南