본문으로 건너뛰기

명령줄

터미널에서 이미지와 영상 생성하기

spicyapi 명령어로 모델을 둘러보고, 정확한 가격을 확인하고, 생성을 시작하고, 결과를 내려받을 수 있습니다. 코드는 한 줄도 필요 없습니다. 비용이 드는 명령은 항상 먼저 확인을 받습니다.

API 키 만들기문서에서 자세히 보기

CLI는 이런 때 씁니다

모델을 빠르게 사용해 보는 방법입니다. 명령을 입력하고 정확한 가격을 확인한 뒤 승인하면 파일을 받습니다. 프로젝트를 만들거나 코드를 작성할 필요가 없습니다.

  1. 명령 입력터미널 또는 PowerShell
  2. spicyapi정확한 가격을 보여 주고 먼저 확인
  3. 결과다운로드 링크, 스크립트용은 JSON
둘러보기, 견적, 다운로드는 무료입니다. 작업을 만들거나 재시도할 때만 비용이 듭니다.

이런 용도에 적합합니다

  • 모델 빠르게 써 보기코드를 쓰기 전에 모델과 가격을 비교하세요.
  • 셸 스크립트--json 출력을 jq, 예약 작업, CI 단계에 연결하세요.
  • 코딩 에이전트에이전트가 명령을 실행하고 JSON 결과를 읽을 수 있습니다.

2분이면 설정 끝

  1. 1단계

    Node.js 22.13 이상 설치

    node -v를 실행해 보세요. 낮은 버전이 나오면 nodejs.org에서 LTS 버전을 설치하고 터미널을 다시 여세요.

    terminal
    node -v
  2. 2단계

    키를 SPICY_API_KEY에 넣기

    CLI는 키를 환경 변수에서만 읽습니다. 인자로는 받지 않고 화면에도 출력하지 않아서 셸 기록으로 유출될 일이 없습니다.

    export SPICY_API_KEY="sk-spicy-..."   # paste your own key
  3. 3단계

    npx로 실행하거나, 한 번만 설치하기

    npx는 설치 없이 최신 버전을 실행합니다. 매일 쓴다면 전역으로 설치해 두세요.

    npx @spicyapi/cli status

터미널에서 첫 이미지 만들기

호출할 수 있는 모델을 찾고 정확한 가격을 확인한 다음 작업을 만들고 완료될 때까지 기다립니다. 입력을 파일에 저장하면 셸에서 따옴표를 처리할 때 생기는 문제를 피할 수 있습니다.

  1. 1단계

    모델 찾기

    호출할 수 있는 이미지 모델을 가격과 함께 나열합니다.

    models list
    spicyapi models list --modality image --json
  2. 2단계

    가격 확인

    프롬프트를 파일에 적고 정확한 비용을 확인하세요. 과금되지 않습니다.

    tasks quote
    echo '{ "prompt": "A cinematic night portrait" }' > input.json
spicyapi tasks quote --model MODEL_ID_FROM_CATALOG --input-file input.json
  3. 3단계

    만들고 기다리기

    CLI가 가격을 보여 주고 승인을 받은 뒤, 결과가 나올 때까지 기다립니다.

    tasks create
    spicyapi tasks create \
  --model MODEL_ID_FROM_CATALOG \
  --input-file input.json \
  --wait
  4. 4단계

    내려받기

    링크가 만료되기 전에 결과 파일을 저장하세요.

    download
    curl -L -o result.png "PASTE_THE_URL_HERE"

할 수 있는 일

비용이 드는 명령은 두 가지뿐이며, 둘 다 가격을 보여 주고 확인을 기다립니다.

  1. 탐색

    01
    • spicyapi status

      SpicyAPI에 연결되는지 확인

      무료
    • spicyapi models list

      사용할 수 있는 모델을 가격과 함께 나열

      무료
    • spicyapi models get <model>

      특정 모델이 받는 설정을 정확히 표시

      무료
    • spicyapi balance

      잔액 확인

      무료

  2. 가격

    02
    • spicyapi tasks quote

      시작 전에 정확한 가격 확인

      무료

  3. 생성

    03
    • spicyapi tasks create

      이미지 또는 영상 생성 시작

      과금 전에 먼저 확인합니다
    • spicyapi tasks wait <task-id>

      생성이 끝날 때까지 대기

      무료
    • spicyapi tasks get <task-id>

      생성 상태와 결과 링크 표시

      무료

  4. 파일

    04
    • spicyapi files upload <path>

      입력으로 쓸 사진, 영상, 오디오 파일 업로드

      무료
    • spicyapi files download-url <task-id>

      결과의 새 다운로드 링크 받기

      무료

스크립트와 AI 에이전트에도 맞게 설계

어떤 명령에든 --json을 붙이면 전체 결과를 JSON으로 받습니다. 오류는 stderr에 JSON 한 줄로 출력되고, 실패하면 0이 아닌 종료 상태를 반환합니다. 코딩 에이전트는 CLI를 직접 실행할 수도 있고, 더 깊은 연동이 필요하면 MCP 서버를 쓸 수도 있습니다.

MCP·에이전트패키지 열기소스 보기
--json
spicyapi --json tasks get <task-id> > task.json

자주 만나는 오류 해결

처음 사용할 때 겪는 문제는 대부분 이 세 가지 중 하나입니다. 각 카드에서 증상과 바꿔야 할 항목을 확인하세요.

  • $

    command not found: spicyapi

    전역 설치 경로가 PATH에 없습니다. npx @spicyapi/cli로 실행하거나 npm install -g @spicyapi/cli로 다시 설치하세요.

  • 키

    키가 설정되지 않음

    SPICY_API_KEY는 설정한 터미널 창에서만 유지됩니다. 다시 설정하거나 셸 프로필에 추가하세요.

  • node

    Node.js 버전이 낮음

    CLI는 Node.js 22.13 이상이 필요합니다. node -v로 확인하고 최신 LTS 버전을 설치하세요.

자주 묻는 질문