01
모델 찾기
API 키로 접근할 수 있는 모델을 조회하고 문서에서 기능과 현재 가격을 확인하세요.
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
OmniaKey MCP 또는 CLI가 준비되었는지 확인하고, 접근 가능한 모델과 공통 미디어 요청 스키마를 보여 주세요. 생성 작업은 제출하지 마세요.입력부터 결과까지
CLI를 설치한 뒤 예제를 image.json으로 저장하세요. 유료 요청 전에 모델과 가격을 확인하고 TASK_ID를 반환된 id로 바꾸세요.
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 키와 API 과금 규칙을 사용합니다. 모델 조회와 로컬 스키마 확인은 생성을 실행하지 않습니다. 텍스트나 미디어 생성에는 비용이 발생할 수 있습니다.
대기 시간이 초과되면 어떻게 되나요?
원격 작업을 취소하거나 다시 제출하지 않습니다. id를 보관하고 task get 또는 task wait로 계속 확인하세요. 파일 링크가 만료되면 같은 작업을 조회해 새 링크를 받으세요.