CLI

생성형 AI API용 RunAPI CLI

하나의 바이너리로 이미지, 비디오, AI 음악, LLM 모델을 scripts, CI, 에이전트에서 호출하세요.

무료 API Key 받기 GitHub
RunAPI의 통합 AI API와 함께 동작
빠른 시작
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+ 모델. scripts와 pipelines를 위한 JSON-first 출력.
설치

한 명령으로 설치

curl로 설치

macOS 또는 Linux에서 설치 스크립트를 사용합니다.

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

Homebrew로 설치

Homebrew가 있는 경우 RunAPI tap을 사용합니다.

brew install runapi-ai/tap/runapi

Go로 설치

공개 Go module에서 직접 설치합니다.

go install github.com/runapi-ai/cli/cmd/runapi@latest
빠른 시작

몇 분 안에 구축 시작

인증한 뒤 이미지, 비디오, AI 음악을 생성하세요.

# 브라우저 로그인
runapi login

# 또는 CI/headless용 token 가져오기
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
기능

Scripts와 에이전트를 위해 설계

JSON-first 출력

모든 명령은 scripts와 pipelines에 맞는 구조화 JSON을 반환합니다.

비동기 작업

오래 걸리는 모델 작업을 시작하고 대기하거나 결과를 조회합니다.

에이전트 친화적

명령은 모델 actions와 입력 schemas에 직접 매핑됩니다.

FAQ

자주 묻는 질문

하나의 RunAPI key로 시작하세요.

계정을 만들고 도구를 설치한 뒤 첫 모델을 호출하세요.

무료 API Key 받기