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 모델은 무엇인가요?

26개 공급업체의 250+ 모델을 지원합니다: 음악의 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 모델을 네이티브 도구로 호출할 수 있습니다.

Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.

CLI

터미널에서 AI 모델 사용

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

무료 API 키 받기 GitHub에서 보기

macOS, Linux, Windows — amd64 및 arm64

Terminal

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

  RunAPI CLI v0.15.0

  Usage: runapi <command> [options]

  Commands:
    login      Authenticate in a browser
    auth       Manage authentication
    account    Read account information
    files      Manage file resources
    pricing    Read schedules and quotes

  Run runapi <command> --help for details

250+

모델

Modalities

<2min

Setup

Install

세 가지 설치 방법

curl (Linux / macOS)

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

OS와 아키텍처를 자동 감지하고, SHA-256 체크섬을 검증한 후 /usr/local/bin에 설치합니다.

Homebrew

brew install runapi-ai/tap/runapi

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

Go 소스 빌드

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

Go 1.22 이상으로 소스에서 빌드합니다.

빠른 시작

몇 분 안에 시작하기

Terminal

# 브라우저 기반 로그인 (노트북)
runapi login

# 또는 토큰 가져오기 (CI / 헤드리스 환경)
printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -

# 확인
runapi auth status

runapi nano-banana text-to-image --input '{"prompt":"a hummingbird drinking espresso","aspect_ratio":"1:1"}'

# { "id": "task_id", "status": "completed", "output": { ... } }

# 장시간 작업을 위한 비동기 실행
TASK_ID=$(runapi suno text-to-music --async --input '{"model":"suno-v5","vocal_mode":"instrumental","style":"minimal piano","title":"Short Piano Theme"}' | jq -r '.id')

# 완료될 때까지 폴링
runapi wait "$TASK_ID" --service suno --action text-to-music

runapi <service> <action> --input '{...}' JSON

기능

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

JSON 우선 출력

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

모든 모달리티

비디오, 이미지, 음악, 오디오, LLM — 모든 것을 하나의 CLI로. --model 플래그로 모델 전환.

비동기 + 폴링

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

셸 자동완성

명령어, 모델 이름, 플래그에 대한 탭 자동완성. bash, zsh, fish 지원.

CLI가 빛나는 순간

CI/CD 파이프라인

빌드 과정에서 바로 에셋을 생성하세요. JSON 출력을 스크립트와 자동화 도구에 깔끔하게 연결할 수 있습니다.

배치 처리

셸 루프로 수백 개의 이미지나 영상을 처리하세요. 비동기 작업 관리로 블로킹 없이 실행됩니다.

빠른 실험

터미널에서 몇 초 만에 새 모델을 테스트하세요. 코드나 설정 없이 runapi generate만 실행하면 됩니다.

개발자가 RunAPI CLI를 선택하는 이유

하나의 도구, 모든 모델

제공업체별 CLI를 번갈아 사용할 필요가 없습니다. 동영상, 이미지, 음악, 오디오, LLM을 하나의 명령으로 처리합니다.

파이프라인에 적합

JSON 출력, 종료 코드, stdin을 지원해 모든 CI/CD와 셸 스크립트에 바로 넣을 수 있습니다.

비용 추적 내장

요청별 비용을 실시간으로 확인하고 프로젝트별 지출 한도를 설정할 수 있습니다.

자주 묻는 질문

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

더 알아보기

MCP 서버

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

SDK

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

Skills

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

모델 카탈로그

요금, 파라미터, 코드 샘플과 함께 250+ 모델을 확인하세요.

팀과 함께 구축하고 계신가요?

엔터프라이즈 설정, 통합, 기술 문의를 도와드립니다.

문의하기