CLI

RunAPI CLI.
터미널에서 AI 모델을.

단일 바이너리로 Suno, Veo, Kling, Flux, Claude, GPT 등 130개 이상의 AI 모델을 호출합니다 — 스크립트, CI 파이프라인, 에이전트 런타임에 깔끔하게 연결되는 JSON 우선 출력을 제공합니다.

무료 API 키 받기 GitHub에서 보기
macOS, Linux, Windows — amd64 및 arm64
빠른 시작
runapi
# 설치
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 generate
runapi <service> <action> --input '{...}' JSON
단일 바이너리, 130개 이상 모델. 스크립트와 파이프라인을 위한 JSON 우선 출력.
개요

RunAPI CLI란?

RunAPI CLI는 18개 공급업체의 130개 이상 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 | sh

Homebrew

공식 Homebrew tap. brew upgrade로 자동 업데이트됩니다.

brew install runapi-ai/tap/runapi

Go 소스 빌드

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 status
runapi 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
runapi <service> <action> --input '{...}' JSON
기능

개발자를 위해 만들어졌습니다

JSON 우선 출력

모든 명령은 구조화된 JSON을 반환합니다 — jq로 파이프하거나, 스크립트에 전달하거나, 어떤 언어에서도 파싱할 수 있습니다.

비동기 + 폴링

--async로 비동기 실행하고, runapi wait으로 폴링합니다. 장시간 생성 태스크를 위해 설계되었습니다.

에이전트 런타임

한 명령으로 Claude Code, Codex, Gemini CLI 등 에이전트 런타임에 CLI 스킬을 설치합니다.

지원 서비스

무엇을 생성할 수 있나요?

이미지 생성

Flux, Nano Banana, Recraft, Ideogram, Seedream, GPT Image, Imagen 4 — 텍스트 프롬프트로 이미지 생성 및 편집.

모델 보기 →

동영상 생성

Kling, Veo, Runway, Luma, Hailuo, Wan, Seedance — 비동기 폴링이 내장된 텍스트-동영상 생성.

모델 보기 →

음악 & 오디오

음악은 Suno, 텍스트 음성 변환·음성 복제는 ElevenLabs, 토킹 아바타는 InfiniteTalk.

모델 보기 →

LLM 채팅 & 완성

Claude, GPT, Gemini, DeepSeek, Grok, Qwen — OpenAI 호환 엔드포인트를 통한 스트리밍 채팅 완성.

모델 보기 →
FAQ

자주 묻는 질문

관련

더 알아보기

MCP 서버

Claude Code, Cursor 등 MCP 호환 에이전트를 RunAPI 모델에 연결합니다.

SDK

프로그래밍 방식 통합을 위한 Python, Node.js, PHP, Java, Ruby, Go SDK.

Skills

에이전트 런타임에 사전 구축된 모델 스킬을 설치합니다.

모델 카탈로그

요금, 파라미터, 코드 샘플과 함께 130개 이상의 모든 모델을 확인하세요.

터미널에서 AI 모델을 실행할 준비가 되셨나요?

CLI를 설치하고 몇 분 안에 생성을 시작하세요.

무료 API 키 받기