分轨分离 API

Q: 运行失败会怎样？

失败的运行不收费。只为结果付费。

已上线

把歌曲分离成人声和伴奏，或人声、鼓、贝斯和其他。

Demucs，1 分钟歌曲 $0.01794，每多 1 分钟 +$0.00299 起

Demucs

输入

歌曲 URLaudio_url歌曲的公开 https 链接。

6603e279-4bfc-4077-b73b-63ddbc87585a_example.mp3正在读取歌曲时长…

分离为stems

不足一分钟的歌曲最低收费 $0.01。

示例

示例输出用此提示词生成

0:00 / 0:00

人声
鼓
贝斯
其他

比较分轨分离 API 模型

此接口的所有模型，价格实时更新。可在试用区试用，或打开模型页面。

DemucsMeta1 分钟歌曲 $0.01794，每多 1 分钟 +$0.00299
人声 + 伴奏 · 人声、鼓、贝斯、其他
页面

此工具的所有模型及价格
		官方价			时长 / 尺寸	标签	操作
DemucsMeta	1 分钟歌曲 $0.01794，每多 1 分钟 +$0.00299	无官方价	—	人声 + 伴奏 · 人声、鼓、贝斯、其他	15 分钟		页面

从代码调用分轨分离 API

上面所有模型共用一个接口。改 model 字段即可切换。

POSThttps://api.opennan.com/v1/audio/separations

GET/v1/models?category=music此接口的所有模型及价格

获取 API 密钥
在控制台创建密钥。它与试用区使用同一余额。
创建密钥

发送第一个请求

与试用区发送的请求相同。把 OPENNAN_KEY 设为你的密钥。

curl https://api.opennan.com/v1/audio/separations \
  -H "Authorization: Bearer $OPENNAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"demucs","audio_url":"https://example.com/song.mp3","stems":"vocals"}'

# Then poll until "status" is "succeeded" or "failed":
curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"

查询任务
调用会立即返回任务 ID。查询任务直到完成：
GEThttps://api.opennan.com/v1/tasks/{id}
queued
等待处理
running
生成中
succeeded
完成：outputs[].url 中是文件
failed
失败：不收费

参数

根据实时目录生成：这里列出的每个值 API 都接受。

参数
名称	类型	可用值	默认值	对价格的影响
`model`必填执行调用的模型。	字符串	demucs	—	—
`audio_url`必填要分离的歌曲（https 链接）。	URL	—	—	按歌曲时长计费
`stems`可选把歌曲分成哪些分轨。	字符串	vocals · all	vocals	—
`callback_url`可选任务完成后发送到此 URL。	URL	—	—	—

错误及解决方法

401缺少密钥或密钥错误
用 Authorization: Bearer 请求头发送控制台中的密钥。
402余额不足
在账单页面充值，然后重新发送同一请求。
400有值不被接受
查看 error.message，它会指出字段。请使用参数表中的值。
429请求过多
等几秒再试，每次遇到 429 都等得更久一些。

把 Opennan 添加到你的 AI 应用

安装一次，你的 AI 就能使用 Opennan 的全部工具：视频、图片、聊天、语音、音乐、音效、3D、字幕和配音。选择你的应用，按步骤操作。

MCP 服务器https://api.opennan.com/v1/mcp

适用于 Codex CLI、Codex 应用和 Codex IDE 扩展：它们共用 ~/.codex/config.toml。如果应用或 IDE 读不到 OPENNAN_KEY，请用写入密钥的 config.toml 方式。Codex 每次调用工具前会询问，批准即可继续。

获取 API 密钥
在控制台创建密钥。密钥以 sk- 开头，与网站共用同一余额。
创建密钥

把密钥保存为 OPENNAN_KEY

# macOS / Linux (zsh shown; bash: ~/.bashrc)
echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc
source ~/.zshrc

# Windows (PowerShell), then open a new terminal
setx OPENNAN_KEY "sk-..."

3
安装 Opennan 插件：包含服务器，以及教 AI 选择模型、确认价格、等待结果的技能
```
codex plugin marketplace add Opennan/opennan-ai-plugin
codex plugin add opennan@opennan
```

或者只添加服务器

codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEY

或者把这段加到 ~/.codex/config.toml

[mcp_servers.opennan]
url = "https://api.opennan.com/v1/mcp"
http_headers = { Authorization = "Bearer sk-..." }

4
确认列表里有 opennan
```
codex mcp list
```
重启 Codex，然后让它做任何事
“做一段 5 秒的霓虹街道下雨视频，再配一首歌和一张海报图。”

把 sk-... 换成你自己的密钥并妥善保管：拿到它的人可以花你的余额。没有密钥时应用也能列出工具，但生成内容需要密钥。

在 AI 智能体中使用

把 Opennan MCP 服务器加到你的智能体中，然后调用此工具。

工具: separate_audio
示例参数: { "model": "demucs", "audio_url": "https://example.com/song.mp3", "stems": "vocals" }