고급
종료 코드·오류
스크립트나 에이전트가 결과를 판단할 수 있도록, aimz 는 종료 코드와 서버 메시지를 그대로 알려 줍니다.
종료 코드
| 코드 | 뜻 | 할 일 |
|---|---|---|
0 | 성공 | |
1 | 오류 — 서버 오류, 입력 오류, 생성 실패, 연결 실패 | 표준 오류 출력의 메시지를 확인 |
2 | 사용법 오류 (명령·옵션이 틀림) | aimz <명령> --help |
3 | 사용자 확인 필요 — 크레딧 사용·삭제 등을 실행하지 않았음 | 사용자에게 묻고, 승인했을 때만 --yes 로 다시 실행 |
4 | 로그인 필요 — 로그인이 없거나 세션이 끝남 | aimz login |
130 | Ctrl+C 로 중단 |
생성이 failed 로 끝나면 aimz generate 는 종료 코드 1 을 냅니다. 아직 진행 중(queued·running)이면 0 입니다.
서버 응답
| 상태 | 흔한 원인 |
|---|---|
401 | 로그인 없음·세션 만료·비밀번호 변경으로 로그아웃됨 → aimz login |
403 | 권한 없음(관리자 전용 기능), 또는 관리자가 다른 사용자로 ‘대신 보기’ 중인 세션(보기 전용) |
404 | 없는 모델·작업·항목, 또는 남의 작업 id |
422 | 입력 오류(규격에 없는 값·범위 초과), “크레딧이 부족합니다.”, 또는 “대기 중인 생성까지 합치면 크레딧이 부족합니다” |
429 | 생성 분당 30회 초과(관리자 제외), 또는 내 대기·진행 작업이 한도(기본 30개) — Retry-After 초 뒤 다시. CLI·MCP 는 잠시 자동으로 기다린다 |
503 | 서버 점검 중, 관리자가 생성을 일시 중단, 또는 일시적인 DB 지연 |
502·504 | 공급사·서버 시간 초과 — 잠시 뒤 다시 시도 |
자주 보는 메시지
| 메시지 | 뜻 |
|---|---|
| 로그인 필요: … aimz login | 토큰이 없거나 만료 — 다시 로그인 |
| 사용자 확인 필요: … | 정책상 확인이 필요해 실행하지 않음 (종료 코드 3) |
| 로그인 코드가 만료됐거나 올바르지 않습니다 | 코드는 2분·1회용 — aimz login 을 다시 실행 |
| N초 안에 로그인이 끝나지 않았습니다 | 브라우저에서 로그인을 끝내지 않음 — 다시 실행 (--timeout 으로 늘리기) |
| 서버가 다른 주소로 넘기려 했습니다 | 서버 주소가 틀림 — --server 확인 (토큰 보호를 위해 리다이렉트를 따라가지 않음) |
| 50MB 를 넘는 파일은 올릴 수 없습니다 | 업로드 크기 제한 |
| 대기 시간이 N분을 넘어 취소했습니다 | 대기열에서 너무 오래 기다림 — 크레딧은 차감되지 않았다. 사람이 적을 때 다시 |
| 서버 줄이 꽉 참 — N초 뒤 다시 보냅니다 | 내 대기 작업이 한도라 CLI 가 기다렸다 같은 요청으로 다시 보내는 중(중복 접수 아님) |