CLI

파일 업로드·결과 저장

레퍼런스 이미지·시작 프레임 같은 입력 파일은 자동으로 올라가고, 결과는 원하는 폴더에 내려받습니다.

입력 파일 넣기

모델 규격에서 타입이 이미지·영상·오디오인 키에는 세 가지 값을 넣을 수 있습니다.

값	예	처리
이 PC 의 파일 경로	./photo.png	자동으로 업로드한 뒤 그 URL 로 바꿔 보냅니다
http(s) URL	https://…/ref.jpg	그대로 보냅니다
data URL	data:image/png;base64,…	그대로 보냅니다 (크면 느려서 권하지 않음)

터미널

# 한 장
aimz generate nanobanana --prompt "같은 인물, 정장 차림" --image ./face.png -o ./out

# 여러 장 (ref_images) — --ref 를 반복하거나 JSON 배열로
aimz generate nanobanana --prompt "세 제품을 한 장면에" --ref ./a.png --ref ./b.png --ref ./c.png
aimz generate seedance_fast --prompt "…" -p 'ref_images=["./a.png","./b.png"]'

자주 쓰는 입력 키: init_image(이미지 편집), ref_images(참고 이미지 여러 장), start_frame·end_frame(영상 시작·끝 프레임), ref_videos(참고 영상), ref_audio(참고 오디오), images(텍스트 모델에 첨부). 모델마다 받는 키는 aimz model <id> 로 확인하세요.

ref_audio 는 aimz model 의 max 가 2 이상이면 목록으로 넣습니다(mp3·wav).
하나당 min_sec~max_sec 초, 합쳐 max_total_sec 초까지입니다.
예: -p 'ref_audio=["./a.mp3","./b.mp3"]'

참고

업로드는 승인 뒤에 합니다. 크레딧 사용 확인에서 거절하면 파일도 올리지 않습니다.

따로 올리기

터미널

aimz upload ./ref.png
# 등록 성공: library_state="registered", generation_id와 url 확인
aimz library --id 123
# 임시 입력만 필요한 경우
aimz upload ./temporary.png --temporary

기본은 내 라이브러리에 원본을 등록합니다. 받은 URL은 여러 생성에 다시 쓸 수 있습니다. MCP: upload_file(path).library_state=pending이면 파일은 보존됐지만 등록이 끝나지 않은 상태입니다. 같은 registration_id로library_registration_recover를 호출하며 다시 생성하지 않습니다. unknown은 결과 확인이 필요한 상태입니다.

제한	내용
크기	파일 하나 50MB 까지
형식	이미지·영상·오디오, 문서(PDF·TXT·MD·CSV·JSON·ZIP·docx·xlsx·pptx·hwp), 3D(glb·gltf·fbx·obj·stl·usdz). SVG 는 안 됩니다
내용 검사	확장자만 바꾼 파일은 거절됩니다

결과 저장

터미널

aimz generate nanobanana --prompt "…" -o ./out      # 끝나면 ./out 에 저장
aimz jobs j_3a313f12… --wait -o ./out                # 나중에 받기
aimz download https://…/a.png https://…/b.png -o ./out

파일 이름 앞에 작업 id 일부가 붙습니다. 같은 이름이 있으면 덮어쓰지 않고 -1, -2 를 붙입니다.
MCP: generate·job_status 의 download_dir, 또는 download_outputs(urls, dest_dir).
결과는 라이브러리에도 남습니다 — aimz library 로 다시 찾을 수 있습니다.

#입력 파일 넣기

#따로 올리기

#결과 저장

입력 파일 넣기

따로 올리기

결과 저장