본문으로 건너뛰기

동영상과 이미지를명령줄에서

스크립트와 AI 에이전트를 위한 작은 명령입니다. 브라우저에서 확인하는 코드로 로그인하고, 모든 작업을 실행 전에 견적하고, 결과를 기다렸다가 파일을 저장합니다. 내부적으로는 공개 API를 호출하며, 스튜디오처럼 크리에이티브 잔액을 씁니다.

출시 전명령pershotAPIhttps://api.pershot.app/v1

이 도구는 아직 출시되지 않았습니다. 아래 명령은 사용 방법을 보여 줍니다. 출시되면 설치 명령을 여기에 게시합니다.

내 AI 에이전트 연결은 모든 계정에 열려 있고 키가 필요 없습니다. 내 코드로 내 작업을 자동화할 때 쓰는 개발자 API 키는 신청제입니다.

로그인은 한 번그다음은 결과 하나에 명령 하나

각 명령이 견적, 제출, 대기, 저장까지 전부 처리합니다. 진행 상황은 표준 오류로 나가므로 스크립트는 결과만 읽습니다.

  1. 01 · 로그인

    링크와 코드만, 붙여넣기 없이

    pershot login을 실행하면 링크와 짧은 코드가 표시됩니다. 아무 브라우저에서 링크를 열어 로그인하고, 코드가 같은지 확인한 뒤 허용하세요. 도구는 전용 로그인 정보를 받아 나만 읽을 수 있는 파일에 저장합니다. 서버나 샌드박스에서도 똑같이 작동합니다.

    터미널
    pershot login
    # Prints a link and a short code. Open the link in any browser,
    # check that the code matches and allow it. The key is saved for you.
    
    pershot whoami    # which key and server are in use

    이메일 인증만 있으면 됩니다. 로그인 정보는 AI 연결 페이지에 표시되며 그곳에서 상한을 두거나 해지할 수 있습니다. 스튜디오처럼 크리에이티브 잔액을 씁니다.

  2. 02 · 동영상

    견적, 제출, 대기, 저장

    pershot video에는 프롬프트를 따옴표로 감싸서 넘깁니다. 먼저 가격을 견적해 표시하고, 작업을 제출하고, 끝날 때까지 지켜본 뒤 영상을 현재 폴더에 저장합니다. 표준 출력에 나오는 것은 파일 경로입니다.

    터미널
    # Prints the price, submits, waits, then the path of the saved .mp4
    pershot video "A paper boat on a rain puddle" -m mini -d 8 -r 480p -a 9:16
    
    # The price only; nothing is submitted
    pershot video "A paper boat on a rain puddle" --dry-run
    
    # Refuse anything over 100 credits
    pershot video "A paper boat on a rain puddle" --max-credits 100

    옵션이 없으면 Seedance 2.0 Fast, 5초, 720p, 16:9, 오디오 포함입니다. 옵션: -m fast 또는 mini, -d 4~15초, -r 480p 또는 720p, -a 16:9, 9:16 또는 1:1, -i 첫 프레임, --ref 참조 이미지 최대 9장, --no-audio 오디오 없음. 로컬 이미지는 먼저 업로드됩니다.

  3. 03 · 이미지

    이미지도 같은 방식, 편집도 가능

    pershot image도 같은 방식으로 작동합니다. -i로 이미지를 주면 새로 만드는 대신 그 이미지를 편집합니다.

    터미널
    pershot image "A ceramic cup on a linen cloth, soft morning light" -s 2K
    
    # Edit a picture instead of making a new one
    pershot image "Make the background plain white" -i cup.png

    옵션이 없으면 Fast, 1K, 1:1입니다. 옵션: -m fast 또는 mini, -s 1K 또는 2K, -a 16:9, 9:16 또는 1:1. 이미지는 PNG, JPEG, WebP 파일이나 https 링크를 쓸 수 있습니다.

  4. 04 · 에이전트용

    한 번 읽으면 되는 레퍼런스

    pershot help --llms는 AI 에이전트를 위해 쓰인 전체 레퍼런스를 하나의 텍스트로 출력합니다. 모든 명령과 옵션, 각 명령이 반환하는 JSON, 각 종료 코드의 의미가 들어 있습니다. 어떤 명령이든 --json을 붙이면 표준 출력에 JSON 객체 하나만 나옵니다.

    터미널
    # The whole reference, written for agents: read it once
    pershot help --llms
    
    # One JSON object on standard output, no progress lines
    pershot video "A paper boat on a rain puddle" --json --quiet
    echo $?    # the exit code: 0 done, 4 not enough credits, 9 stopped waiting

    --json을 붙이면 오류도 JSON으로 표준 오류에 나오고, 종료 코드로 문제의 종류를 알 수 있습니다.

사람 없이 돌아가도록만들었습니다

가격 먼저
모든 작업은 제출 전에 견적이 나오고 가격이 표시됩니다. --dry-run은 가격만 표시하고 멈춥니다.
명령마다 상한
--max-credits보다 비싼 작업은 업로드나 제출 전에 거부됩니다.
안전한 재시도
모든 작업은 멱등 키와 함께 전송됩니다. --idempotency-key로 직접 키를 정하면 같은 명령을 다시 실행해도 같은 작업이 반환되고 두 번 청구되지 않습니다.
오래 걸리는 작업
--no-wait는 작업 ID를 출력하고 바로 돌아옵니다. 도구가 기다리기를 멈춰도 작업은 계속되며, 나중에 다시 기다릴 수 있습니다(아래 종료 코드 9).
전용 로그인
저장된 로그인 정보는 발급된 서버로만 전송됩니다. 개발자 API 잔액으로 결제하려면 PERSHOT_API_KEY에 개발자 API 키(신청제)를 설정하세요. 저장된 로그인 정보 대신 사용됩니다.
깔끔한 출력
결과는 표준 출력으로, 진행 상황과 문제는 표준 오류로 나갑니다. --quiet를 쓰면 진행 상황 줄이 빠집니다.

종료 코드의미는 바뀌지 않습니다

스크립트와 에이전트는 종료 코드에 따라 처리를 나눌 수 있습니다. 각 코드는 도구의 모든 버전에서 같은 뜻입니다.

코드의미할 일
0완료표준 출력에서 결과 읽기
1예상하지 못한 오류표준 오류의 메시지 읽기
2명령줄이 잘못됨고치세요. 모든 옵션은 도움말에 있습니다: pershot help
3로그인하지 않았거나 로그인 정보나 키가 거부됨로그인: pershot login
4크레딧 부족충전한 뒤 다시 실행
5이 키로는 할 수 없음: 권한, 모델 또는 지역허용된 키 사용
6거부됨: 잘못된 요청, --max-credits 초과, 바뀐 가격 또는 허용되지 않는 콘텐츠요청 바꾸기
7혼잡: 요청 속도 제한 또는 동시 실행 제한잠시 기다린 뒤 다시 시도
8작업이 실패했거나 취소됨이유를 확인하세요. 비용이 들었다면 작업에 표시됩니다: pershot job <id>
9기다리기를 멈춤. 작업은 계속됨다시 기다리기: pershot job <id> --wait
10서비스에 연결할 수 없거나 서버 오류같은 --idempotency-key로 나중에 다시 시도
11사람의 승인 대기. 샘플이 먼저 만들어지고, 나머지는 누군가 웹에서 승인할 때까지 기다림출력된 링크에서 검토를 받은 뒤 배치를 다시 기다리기: pershot batch wait <id>

명령줄자주 묻는 질문

언제 설치할 수 있나요?

아직은 아닙니다. 이 도구는 출시 전이고, 실제 생성도 아직 열리지 않았습니다. 모델 페이지에 이메일을 남겨 주시면 열릴 때 한 번만 연락드리겠습니다.

API 키를 붙여넣어야 하나요?

아니요. pershot login이 링크와 코드를 보여 주고, 브라우저에서 허용하면 도구가 전용 로그인 정보를 받아 크리에이티브 잔액을 씁니다. PERSHOT_API_KEY에 개발자 API 키(신청제)를 설정해도 되며, 그때는 개발자 API 잔액에서 결제됩니다.

로그인 정보는 어디에 저장되나요?

기본적으로 ~/.config/pershot/credentials.json에 저장되며, 내 사용자만 읽을 수 있습니다. pershot logout은 이 파일을 지웁니다. 로그인 정보 자체는 AI 연결 페이지에서 해지하거나 90일 뒤 만료될 때까지 남아 있습니다.

AI 에이전트는 사용법을 어떻게 익히나요?

pershot help --llms를 한 번 실행하게 하세요. 모든 명령, 옵션, 출력, 종료 코드가 들어 있어 에이전트가 추측할 필요가 없습니다.

도구에 추가 비용이 드나요?

아니요. 로그인해서 쓰면 스튜디오와 같은 가격으로 크리에이티브 잔액을 씁니다.