---
title: "RunAPI CLI — 터미널에서 130개 이상의 AI 모델 실행"
url: "https://runapi.ai/ko/cli.md"
canonical: "https://runapi.ai/ko/cli"
locale: "ko"
---

# RunAPI CLI

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

## Install

**curl (Linux / macOS):**

```bash
curl -fsSL https://runapi.ai/cli/install.sh | sh
```

**Homebrew:**

```bash
brew install runapi-ai/tap/runapi
```

**Go source build (Go 1.22+):**

```bash
go install github.com/runapi-ai/cli/cmd/runapi@latest
```

## Quickstart

```bash
# Authenticate
runapi login

# Generate an image
runapi nano-banana generate \
  --input '{"prompt":"a hummingbird drinking espresso","aspect_ratio":"1:1"}'

# Generate music (async)
TASK_ID=$(runapi suno generate --async \
  --input '{"prompt":"indie rock about coding"}' | jq -r .id)
runapi wait "$TASK_ID" --service suno --action generate
```

## What Is RunAPI CLI?

RunAPI CLI는 18개 공급업체의 130개 이상 AI 모델을 하나의 통합 API로 호출하는 Go 바이너리입니다. Suno, Kling, Flux, Claude, GPT 각각의 SDK를 별도로 설치하는 대신 runapi <service> <action> 명령 하나로 구조화된 JSON을 받을 수 있습니다. 인증, 비동기 폴링, 출력 포맷을 처리해 셸 스크립트, CI 파이프라인, 에이전트 런타임을 깔끔하게 유지할 수 있습니다. 모든 요청은 월 최소 금액 없는 종량제로 청구되며, CLI가 API 키를 로컬에 저장하므로 한 번만 인증하면 어느 디렉터리에서든 명령을 실행할 수 있습니다.

## Features

- **JSON-first output** — Every command returns structured JSON for scripts and pipelines.
- **Async + polling** — `--async` flag to fire-and-forget, `runapi wait` to poll.
- **Agent runtime** — Install skills into Claude Code, Codex, Gemini CLI with `runapi agent install-skill`.

## What Can You Generate?

- **이미지 생성** — 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

### RunAPI CLI는 어떻게 설치하나요?

세 가지 방법이 있습니다: 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 소스 빌드).

### curl 설치 스크립트가 지원하는 플랫폼은 무엇인가요?

amd64 및 arm64 아키텍처의 macOS와 Linux를 지원합니다. curl 설치 스크립트는 OS와 CPU를 자동으로 감지하고, SHA-256 체크섬을 검증한 후 /usr/local/bin에 바이너리를 설치합니다.

### CI 파이프라인에서 CLI를 사용할 수 있나요?

예. CI/CD 파이프라인에 curl 설치 스크립트를 사용하고 RUNAPI_API_KEY를 환경 변수로 설정하세요. CLI는 비대화형 환경에서 runapi auth import-token을 통한 헤드리스 인증을 지원합니다.

### CLI에서 실행할 수 있는 AI 모델은 무엇인가요?

18개 공급업체의 130개 이상 모델을 지원합니다: 음악의 Suno, 비디오의 Kling과 Veo, 이미지의 Flux와 Nano Banana, 오디오의 ElevenLabs, LLM의 Claude, GPT, Gemini, DeepSeek.

### 비동기 태스크 처리는 어떻게 동작하나요?

--async 플래그를 사용하면 비동기로 실행됩니다. CLI는 즉시 태스크 ID를 반환합니다. 이후 runapi wait TASK_ID를 사용해 완료될 때까지 폴링하세요. JSON 출력 덕분에 jq로 태스크 ID를 쉽게 추출할 수 있습니다.

### RunAPI CLI 요금은 얼마인가요?

CLI 자체는 무료 오픈소스입니다. API 호출은 요청당 종량제로 청구되며 월 최소 금액이 없습니다. 이미지 생성은 장당 $0.02부터, 동영상 생성은 클립당 $0.10부터, LLM 호출은 공식 공급업체 가격 대비 약 50% 할인된 토큰 단가로 청구됩니다.

### Claude Code 같은 에이전트 런타임에서 CLI를 사용할 수 있나요?

예. RunAPI는 Claude Code, Codex, Gemini CLI 등 MCP 호환 에이전트 런타임용 설치 가능한 모델 스킬을 제공합니다. runapi skill install을 실행해 모델 스킬을 추가하면 에이전트가 수동 API 설정 없이 RunAPI 모델을 네이티브 도구로 호출할 수 있습니다.


## Links

- [Model catalog](https://runapi.ai/ko/models)
- [MCP Server](https://runapi.ai/ko/mcp)
- [SDKs](https://runapi.ai/ko/sdk)
- [Skills](https://runapi.ai/ko/skills)
- [Pricing](https://runapi.ai/ko/pricing)
- [API docs](https://runapi.ai/ko/docs)
- [GitHub](https://github.com/runapi-ai/cli)