Skip to main content

PiAPI CLI

터미널에서 94개의 멀티모달 AI 모델 사용

이미지, 비디오, 오디오, 3D 자산 생성 및 LLM과 채팅 — 모두 하나의 명령으로. 개발자, AI 에이전트, 자동화 워크플로우에 적합.

npm으로 설치:

$ npm install -g piapi-cli

모든 AI 모델을 하나의 CLI로

flux-devnano-banana-progpt-image-2qwen-imageseedream-5-litemidjourneyz-imageremove-bgupscalefaceswap

piapi model list를 실행하여 모든 모델 찾아보기

$ piapi run flux-dev prompt="a corgi astronaut"

CLI 명령어

$ piapi run flux-dev prompt="a corgi" aspect_ratio=16:9

이미지 생성

$ piapi run gpt-4o prompt="hello" --stream

스트리밍 채팅

$ piapi run sora2-pro prompt="waves" --async

비디오 생성 (비동기)

$ piapi run remove-bg image=@./photo.png --download

업로드 및 다운로드

전체 명령어 참조 및 플래그

PiAPI CLI 워크플로우 배우기

자주 묻는 질문

What is PiAPI CLI?

PiAPI CLI is a command line interface for running PiAPI models from your terminal. It works as an AI CLI tool for image, video, audio, 3D, and chat generation workflows.

인증 방법은?

piapi auth login --api-key sk-xxxxx 실행. API 키는 PiAPI 워크스페이스에서 받을 수 있습니다. 공유 머신에서는 환경 변수 PIAPI_API_KEY=sk-... 사용 권장.

Can I generate AI images from terminal?

Yes. Use piapi run flux-dev prompt="a corgi astronaut" or another image model to generate AI images from terminal commands. Add --download to save generated files locally.

로컬 파일을 업로드하려면?

입력에 @ 접두사를 붙이면 로컬 파일 업로드. 예: piapi run remove-bg image=@./photo.png

Claude Code나 Cursor 같은 AI 에이전트와 함께 사용할 수 있나요?

예! PiAPI CLI는 AI 에이전트 통합용으로 설계되었습니다. npx skills add PiAPI-1/piapi-cli로 스킬 추가.

PiAPI CLI는 무료인가요?

CLI 자체는 무료 오픈소스(MIT 라이선스). 모델 사용에는 PiAPI 계정 필요 — 신규 계정에는 무료 크레딧 제공.

PiAPI CLI를 설치하려면?

npm으로 전역 설치: npm install -g piapi-cli. pnpm, yarn, bun도 사용 가능. npx piapi-cli@latest로 설치 없이 실행 가능. Node.js 18+ 필요.

어떤 모델이 지원되나요?

PiAPI CLI는 94개의 멀티모달 AI 모델 지원: 34개 이미지, 40개 비디오, 10개 오디오, 2개 3D, 8개 LLM 모델. piapi model list로 전체 모델 확인.

Can I generate AI videos from terminal?

Yes. Use video models such as Sora, Kling, Veo, Seedance, Hailuo, and Luma to generate AI videos from terminal workflows. Video jobs usually use --async so you can check task status later.

생성된 파일을 다운로드하려면?

명령에 --download를 추가하면 자동 저장. --out-dir ./output으로 커스텀 출력 디렉토리 지정.

동기 모드와 비동기 모드의 차이는?

LLM과 gpt-image-2 모델은 동기 실행. 비디오와 3D 모델은 --async 플래그 필요, 폴링용 태스크 ID 반환.