01
找到合适的模型
查询 API Key 可访问的模型,再核对模型文档中的能力和当前价格。
02
提交生成请求
通过同一套 OmniaKey API 调用文本及异步图片、视频或音频任务。
03
随时继续任务
保留任务 id 并继续查询。等待超时不会重新创建生成任务。
从安装到首次验证
01
安装工具
将 Skill 安装到当前项目,选择 Agent 后重新加载。同时连接 OmniaKey MCP 或安装 CLI;Skill 本身提供操作指引。
Skill
npx skills add omniakey-com/omniakey-devtools --skill omniakey-modelsmacOS / 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
验证连接即可
让 Agent 加载 omniakey-models 并执行下方检查。安装 Skill 不会自动配置 API Key 或调用工具。
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 继续查询。成功结果的下载链接会过期,重新查询同一任务即可获取新链接。