01
找到合适的模型
查询 API Key 可访问的模型，再核对模型文档中的能力和当前价格。
02
提交生成请求
通过同一套 OmniaKey API 调用文本及异步图片、视频或音频任务。
03
随时继续任务
保留任务 id 并继续查询。等待超时不会重新创建生成任务。
从安装到首次验证
01
安装工具
选择下方对应客户端的配置。服务在本地通过 stdio 运行，配置环境变量后请重新启动客户端。
Codex · ~/.codex/config.toml
[mcp_servers.omniakey]
command = "npx"
args = ["--yes", "github:omniakey-com/omniakey-devtools#v0.1.0", "mcp"]
env_vars = ["OMNIAKEY_API_KEY"]Claude Code
Claude Code · terminal
claude mcp add --transport stdio omniakey -- npx --yes github:omniakey-com/omniakey-devtools#v0.1.0 mcpCursor
Cursor · .cursor/mcp.json
{
"mcpServers": {
"omniakey": {
"command": "npx",
"args": [
"--yes",
"github:omniakey-com/omniakey-devtools#v0.1.0",
"mcp"
]
}
}
}macOS / Linux · Bash / zsh
read -s OMNIAKEY_API_KEY
export OMNIAKEY_API_KEYWindows · PowerShell
PowerShell
$env:OMNIAKEY_API_KEY = [System.Net.NetworkCredential]::new('', (Read-Host 'OmniaKey API key' -AsSecureString)).Password03
验证连接即可
重新加载 MCP 连接后，让 Agent 执行只读检查。提示缺少密钥意味着客户端尚未继承环境变量。
Agent
确认 OmniaKey MCP 或 CLI 已就绪，列出可访问的模型并读取媒体请求的通用格式。不要提交生成任务。CLI · image.json → id → assets
omniakey submit --file image.json --idempotency-key YOUR_UNIQUE_TASK_KEY
omniakey task wait TASK_ID --timeout 300
omniakey task get TASK_ID常见问题
工具会改变模型价格吗？
不会。工具复用你的 API Key 和网关计费规则。模型查询和本地格式检查不提交生成任务；文本与媒体生成可能产生费用。
等待超时后会发生什么？
远端任务不会被取消或重新提交。保留 id 并通过 task get 或 task wait 继续查询。成功结果的下载链接会过期，重新查询同一任务即可获取新链接。