01
找到合适的模型
查询 API Key 可访问的模型，再核对模型文档中的能力和当前价格。
02
提交生成请求
通过同一套 OmniaKey API 调用文本及异步图片、视频或音频任务。
03
随时继续任务
保留任务 id 并继续查询。等待超时不会重新创建生成任务。
从安装到首次验证
01
安装工具
从 GitHub 安装固定版本到全局。安装后可使用 omniakey 命令，包内也包含 MCP 服务。
CLI
npm install --global github:omniakey-com/omniakey-devtools#v0.1.0
omniakey helpmacOS / 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
验证连接即可
列出可用模型 id 并读取媒体请求通用格式。具体参数与价格请查阅对应模型文档。
CLI
omniakey models --limit 10
omniakey schema mediaCLI · 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 继续查询。成功结果的下载链接会过期，重新查询同一任务即可获取新链接。