Auteo로 이미지 생성하기
auteo CLI 사용 (npm i -g @auteo/cli, 그 다음 auteo auth login). 명령어가 종료 코드 3으로 종료되면 먼저 auteo-account 스킬을 따라 로그인하세요. MCP 사용자는 마지막에 나열된 auteo_* 도구로 동일한 작업을 수행할 수 있습니다.
1. 모델 선택
auteo model list --type text_to_image --json # 또는 편집 시 --type image_to_image
auteo model get <model> --json # 모든 파라미터, 옵션 및 제약 조건
생성하기 전에 항상 model get을 읽으세요: 종횡비와 해상도 티어는 모델마다 다르며, resolutionsByAspectRatio는 각 비율이 어떤 티어를 허용하는지 알려줍니다.
대략적인 가이드 (실시간 목록은 변경될 수 있으므로 확인하세요):
| 필요 | 좋은 첫 선택 |
|---|---|
| 최고 전체 품질, 이미지 내 텍스트 | openai/gpt-image-2-6-sunburst, google/nano-banana-pro |
| 빠르고 저렴한 초안 | google/nano-banana, alibaba/z-image |
| 참조 이미지로 사진 편집 | google/nano-banana-2, bytedance/seedream-5-5 |
| Plus / Ultra 구독자 무료 | subscriberUnlimited: true 모델 (예: alibaba/z-image) |
2. 파라미터 선택
--aspect-ratio는 필수입니다. 사용자가 요청한 대로 사용하고, 그렇지 않으면 아바타와 아이콘은1:1, 배너와 썸네일은16:9, 스토리는9:16, 인물 사진은3:4를 사용하세요. 일부 모델은auto도 제공합니다.--resolution은 모델에 티어(1K/2K/4K)가 있을 때 필수입니다. 높은 티어일수록 비용이 더 듭니다. 초안은 기본적으로1K로 설정하고, 사용자가 인쇄물이나 대형 디스플레이를 원할 때만 더 높은 티어를 사용하며 비용이 더 든다고 알려주세요.--n(1–4)은 여러 변형을 생성하며, 각각 비용이 청구됩니다.--image <경로|https-url>(반복 가능)은 편집이나 스타일을 위한 참조 이미지를 추가합니다. 로컬 파일은 업로드되며, 허용되는 개수는model get(inputAssetIds.max)에 있습니다.- 사용자가 이미지에 다른 언어의 텍스트를 렌더링하기를 원하지 않는 한 프롬프트는 영어로 작성하세요.
3. 가격 확인 후 생성
auteo generate cost google/nano-banana-2 --aspect-ratio 16:9 --resolution 2K --json
auteo generate create google/nano-banana-2 --prompt "신선한 눈 위의 붉은 여우, 영화 같은 조명" \
--aspect-ratio 16:9 --resolution 2K --out ./images --json
--out <dir>은 결과를 기다리고 파일을 다운로드하며, JSON은 files와 outputs[].url을 나열합니다. --out/--wait 없이 명령어는 즉시 requestId를 반환합니다. 나중에 auteo generate wait <requestId> --out ./images로 가져오세요.
사용자에게 파일 경로와 사용된 크레딧(cost)을 알려주세요.
실패 시 처리
- 종료 코드 4, 크레딧 부족: 중단하고 auteo-account 스킬을 따르세요 (사용자에게 가격과 잔액을 알리고 충전 링크를 제공). 설정을 임의로 낮추지 마세요.
- 종료 코드 2, 잘못된 파라미터:
auteo model get <model>을 다시 읽고 비율/티어 조합을 수정하세요. - 종료 코드 5, 프롬프트가 검열에 의해 거부됨: 플래그된 콘텐츠 없이 프롬프트를 다시 작성하세요. 동일한 프롬프트를 다시 보내면 다시 실패합니다.
- 종료 코드 6, 제한: 너무 많은 생성이 진행 중이거나 너무 많은 제출이 있습니다. 기다렸다가 재시도하세요.
create중 시간 초과 또는 네트워크 오류: 맹목적으로 다시 제출하지 마세요.auteo generate list --type image --limit 5 --json을 실행하세요. 요청이 없으면--client-request-id <앞서 출력된 id>로 재시도하여 이중 청구를 방지하세요.- 결과에
status: failed:errorMessage를 보고하세요.suggestedModel이 설정되어 있으면 사용자에게 제안하세요.
MCP 도구
auteo_list_models, auteo_get_model, auteo_estimate_cost, auteo_upload_image (inputAssetIds용 assetId 반환), auteo_generate_image, auteo_get_generation (pollAfterMs 이후 다시 호출하여 done이 될 때까지), auteo_list_generations.