동영상과 이미지를명령줄에서
스크립트와 AI 에이전트를 위한 작은 명령입니다. 브라우저에서 확인하는 코드로 로그인하고, 모든 작업을 실행 전에 견적하고, 결과를 기다렸다가 파일을 저장합니다. 내부적으로는 공개 API를 호출하며, 스튜디오처럼 크리에이티브 잔액을 씁니다.
이 도구는 아직 출시되지 않았습니다. 아래 명령은 사용 방법을 보여 줍니다. 출시되면 설치 명령을 여기에 게시합니다.
내 AI 에이전트 연결은 모든 계정에 열려 있고 키가 필요 없습니다. 내 코드로 내 작업을 자동화할 때 쓰는 개발자 API 키는 신청제입니다.
로그인은 한 번그다음은 결과 하나에 명령 하나
각 명령이 견적, 제출, 대기, 저장까지 전부 처리합니다. 진행 상황은 표준 오류로 나가므로 스크립트는 결과만 읽습니다.
- 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 연결 페이지에 표시되며 그곳에서 상한을 두거나 해지할 수 있습니다. 스튜디오처럼 크리에이티브 잔액을 씁니다.
- 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 오디오 없음. 로컬 이미지는 먼저 업로드됩니다.
- 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 링크를 쓸 수 있습니다.
- 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를 한 번 실행하게 하세요. 모든 명령, 옵션, 출력, 종료 코드가 들어 있어 에이전트가 추측할 필요가 없습니다.
도구에 추가 비용이 드나요?
아니요. 로그인해서 쓰면 스튜디오와 같은 가격으로 크리에이티브 잔액을 씁니다.