01
모델 찾기
API 키로 접근할 수 있는 모델을 조회하고 문서에서 기능과 현재 가격을 확인하세요.
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 media입력부터 결과까지
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로 계속 확인하세요. 파일 링크가 만료되면 같은 작업을 조회해 새 링크를 받으세요.