RunAPI CLI.
터미널에서 AI 모델을.
단일 바이너리로 Suno, Veo, Kling, Flux, Claude, GPT 등 220+ AI 모델을 호출합니다 — 스크립트, CI 파이프라인, 에이전트 런타임에 깔끔하게 연결되는 JSON 우선 출력을 제공합니다.
# 설치
curl -fsSL https://runapi.ai/cli/install.sh | sh
# 인증
runapi login
# 이미지 생성
runapi nano-banana generate \
--input '{"prompt":"a hummingbird drinking espresso"}'
# 음악 생성 (비동기 실행 후 폴링)
TASK_ID=$(runapi suno generate --async \
--input '{"prompt":"indie rock about coding"}' | jq -r .id)
runapi wait "$TASK_ID" --service suno --action generateRunAPI CLI란?
RunAPI CLI는 25개 공급업체의 220+ AI 모델을 하나의 통합 API로 호출하는 Go 바이너리입니다. Suno, Kling, Flux, Claude, GPT 각각의 SDK를 별도로 설치하는 대신 runapi <service> <action> 명령 하나로 구조화된 JSON을 받을 수 있습니다. 인증, 비동기 폴링, 출력 포맷을 처리해 셸 스크립트, CI 파이프라인, 에이전트 런타임을 깔끔하게 유지할 수 있습니다. 모든 요청은 월 최소 금액 없는 종량제로 청구되며, CLI가 API 키를 로컬에 저장하므로 한 번만 인증하면 어느 디렉터리에서든 명령을 실행할 수 있습니다.
세 가지 설치 방법
curl (Linux / macOS)
OS와 아키텍처를 자동 감지하고, SHA-256 체크섬을 검증한 후 /usr/local/bin에 설치합니다.
curl -fsSL https://runapi.ai/cli/install.sh | shHomebrew
공식 Homebrew tap. brew upgrade로 자동 업데이트됩니다.
brew install runapi-ai/tap/runapiGo 소스 빌드
Go 1.22 이상으로 소스에서 빌드합니다.
go install github.com/runapi-ai/cli/cmd/runapi@latest몇 분 안에 시작하기
인증 후 생성을 시작하세요.
# 브라우저 기반 로그인 (노트북)
runapi login
# 또는 토큰 가져오기 (CI / 헤드리스 환경)
printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -
# 확인
runapi auth statusrunapi nano-banana generate \
--input '{"prompt":"a hummingbird drinking espresso","aspect_ratio":"1:1"}'
# { "id": "task_abc123", "status": "completed", "output": { ... } }# 장시간 작업을 위한 비동기 실행
TASK_ID=$(runapi suno generate --async \
--input '{"prompt":"upbeat indie rock about coding"}' | jq -r .id)
# 완료될 때까지 폴링
runapi wait "$TASK_ID" --service suno --action generate개발자를 위해 만들어졌습니다
JSON 우선 출력
모든 명령은 구조화된 JSON을 반환합니다 — jq로 파이프하거나, 스크립트에 전달하거나, 어떤 언어에서도 파싱할 수 있습니다.
비동기 + 폴링
--async로 비동기 실행하고, runapi wait으로 폴링합니다. 장시간 생성 태스크를 위해 설계되었습니다.
에이전트 런타임
한 명령으로 Claude Code, Codex, Gemini CLI 등 에이전트 런타임에 CLI 스킬을 설치합니다.
무엇을 생성할 수 있나요?
이미지 생성
Flux, Nano Banana, Recraft, Ideogram, Seedream, GPT Image, Imagen 4 — 텍스트 프롬프트로 이미지 생성 및 편집.
모델 보기 →자주 묻는 질문
세 가지 방법이 있습니다: curl -fsSL https://runapi.ai/cli/install.sh | sh (OS와 아키텍처 자동 감지), brew install runapi-ai/tap/runapi (Homebrew), 또는 go install github.com/runapi-ai/cli/cmd/runapi@latest (Go 소스 빌드).
amd64 및 arm64 아키텍처의 macOS와 Linux를 지원합니다. curl 설치 스크립트는 OS와 CPU를 자동으로 감지하고, SHA-256 체크섬을 검증한 후 /usr/local/bin에 바이너리를 설치합니다.
예. CI/CD 파이프라인에 curl 설치 스크립트를 사용하고 RUNAPI_API_KEY를 환경 변수로 설정하세요. CLI는 비대화형 환경에서 runapi auth import-token을 통한 헤드리스 인증을 지원합니다.
25개 공급업체의 220+ 모델을 지원합니다: 음악의 Suno, 비디오의 Kling과 Veo, 이미지의 Flux와 Nano Banana, 오디오의 ElevenLabs, LLM의 Claude, GPT, Gemini, DeepSeek.
--async 플래그를 사용하면 비동기로 실행됩니다. CLI는 즉시 태스크 ID를 반환합니다. 이후 runapi wait TASK_ID를 사용해 완료될 때까지 폴링하세요. JSON 출력 덕분에 jq로 태스크 ID를 쉽게 추출할 수 있습니다.
CLI 자체는 무료 오픈소스입니다. API 호출은 요청당 종량제로 청구되며 월 최소 금액이 없습니다. 이미지 생성은 장당 $0.02부터, 동영상 생성은 클립당 $0.10부터, LLM 호출은 공식 공급업체 가격 대비 약 50% 할인된 토큰 단가로 청구됩니다.
예. RunAPI는 Claude Code, Codex, Gemini CLI 등 MCP 호환 에이전트 런타임용 설치 가능한 모델 스킬을 제공합니다. runapi skill install을 실행해 모델 스킬을 추가하면 에이전트가 수동 API 설정 없이 RunAPI 모델을 네이티브 도구로 호출할 수 있습니다.