핵심 요약: AI 에이전트 태스크로 블로그 이미지를 생성하려면 기획안(brief), 이미지 사양, 검토 담당자를 하나의 태스크(Task)에 담으세요. 에이전트가 글 초안을 작성하고, 환경 변수에 설정된 키로 MiniMax H3-Image 같은 이미지 API를 호출한 뒤, 두 결과물을 모두 태스크에 첨부하고 검토 단계에서 대기합니다. 이후 사람이 이를 승인하거나 수정을 요청합니다.
별도의 콘텐츠 플랫폼을 구축하지 않고도 지금 바로 AI 에이전트 실행을 통해 블로그 이미지를 생성할 수 있습니다. 이번 주에 모델 환경도 한층 수월해졌습니다. 2026년 11월 10일 MiniMax가 약 10초 만에 1,600만 화소(16MP) 이미지를 생성하는 오픈 가중치(open-weight) 이미지 모델인 H3-Image를 출시했습니다. 사실 까다로운 부분은 API 호출 자체가 아니었습니다. 초안, 생성된 이미지, 여기에 사용된 프롬프트, 그리고 둘에 대한 의사결정 내역을 한곳에서 관리하는 것이 핵심 과제였습니다.
이 가이드에서는 하나의 태스크에서 이 모든 작업을 처리하는 워크플로를 소개합니다. 기획안에 담아야 할 내용, API 키 설정 위치, 에이전트가 실행하는 스크립트, 그리고 검토자가 확인해야 할 사항을 차례로 살펴봅니다. 이미 에이전트에게 코딩 작업을 맡기고 있다면, Sharkly를 통해 콘텐츠 작업 역시 동일한 태스크-실행-검토 루프로 손쉽게 처리할 수 있습니다.
한 에이전트가 글과 이미지를 모두 맡아야 하는 이유
글 작성과 이미지 제작이 별도 단계로 나뉘어 있으면 대표 이미지가 본문 내용과 겉돌기 쉽습니다. 작성자가 세 번째 초안에서 글의 관점을 바꿨는데도 이미지는 여전히 첫 번째 초안 내용을 담고 있기도 합니다. 누군가는 웹 앱에 프롬프트를 붙여넣고, 파일을 다운로드하여 이름을 바꾼 뒤 공유 폴더에 넣습니다. 그러다 보면 나중에는 어떤 프롬프트로 어떤 이미지를 만들었는지 아무도 알 수 없게 됩니다.
하나의 태스크로 통합하면 두 결과물의 담당자와 기록이 일원화되어 이러한 문제를 해결할 수 있습니다.
- 에이전트가 최종 초안을 먼저 읽은 후 이미지 프롬프트를 작성하므로, 대표 이미지가 최종 발행본과 정확히 일치합니다.
- 프롬프트, 모델 ID, 이미지 크기, 비용 정보가 초안과 동일한 태스크에 함께 기록됩니다.
- 검토자가 글과 이미지를 한자리에서 확인하고 한 번에 의사결정을 내릴 수 있습니다.
- 수정 요청이 새로운 대화창이 아닌 기존 컨텍스트 전체를 포함한 상태로 에이전트에게 전달됩니다.
인간과 에이전트 간의 역할 분담도 명확합니다. 에이전트는 초안 작성, 이미지 생성, 파일 첨부, 보고를 담당합니다. 사람은 판단하고, 편집하고, 발행합니다.
MiniMax H3-Image의 주요 특징
H3-Image는 MiniMax의 텍스트 투 이미지(text-to-image) 및 이미지 편집 모델입니다. 단일 체크포인트로 두 모드를 모두 지원하며, 편집 모드에서는 1장에서 최대 16장의 참조 이미지를 입력받을 수 있습니다. MiniMax의 이미지 생성 가이드 및 모델 카드에 명시된 세부 사양은 다음과 같습니다.
| Item | Value (per MiniMax, read 2026-11-11) |
|---|---|
| Model IDs | MiniMax-H3-Image, MiniMax-H3-Image-Highspeed |
| Endpoints | POST /v1/images/generations, POST /v1/images/edits |
| Size options | aspect_ratio plus area (1K, 2K, 4K), or exact WIDTHxHEIGHT |
16:9 at 2K |
2720 x 1536 |
| Images per request | 1 to 10 |
| Output formats | jpeg (default), png, webp |
| Not supported | Masked edits, transparent backgrounds |
| Example cost, 2K text-to-image | $0.02333 per image |
| Example cost, 4K text-to-image | $0.06879 per image, $0.03439 during the launch discount |
출시 할인은 생성된 이미지가 1,660만 픽셀 이상일 때 50% 할인이 적용됩니다. MiniMax의 가격 안내 페이지에 따르면 이 할인은 2026년 11월 17일 16:00 UTC까지 진행됩니다. 블로그 대표 이미지에 1,600만 화소까지 필요한 경우는 드물기 때문에 16:9 비율의 2K가 합리적인 기본값입니다.
오픈 가중치 모델을 직접 호스팅해야 할까요?
대부분의 팀에게는 권장하지 않습니다. 이 가중치에는 일반적인 오픈소스 라이선스가 아닌 MiniMax-H3-Image 커뮤니티 라이선스가 적용됩니다. 라이선스 전문을 직접 확인해 보세요. 특정 지역이 라이선스 대상 지역에서 제외되어 있으며, 연간 매출이 100만 달러를 초과하거나 호스팅 서비스를 제공할 경우 별도의 서면 승인이 필요합니다. 다운로드 용량 또한 큽니다. 디퓨전 트랜스포머(diffusion transformer) 66.28 GB에 텍스트 인코더 66.7 GB가 추가됩니다. 블로그 워크플로에는 API를 사용하는 것이 훨씬 실용적입니다.
1단계: 기획안을 태스크로 작성하기
태스크 설명(description)이 곧 기획안이 됩니다. 에이전트가 추가 질문 없이 작업을 완료하는 데 필요한 모든 내용을 이곳에 작성합니다. 잘 작성된 예시는 다음과 같습니다.
**Post:** How we cut CI time by 40% with test sharding
**Audience:** platform engineers
**Length:** 1,400 words
**Header image:** 16:9, 2K, MiniMax-H3-Image
**Image direction:** abstract, no text in the image, brand blues
**Deliver:** article.md + header.jpg + prompt.txt attached to this Task
**Reviewer:** Maria (approves both before anything is published)
이번 글에만 해당하는 세부 사항은 태스크에 작성하세요. 톤앤매너, 이미지 스타일, 파일 이름 등 매 포스팅마다 반복되는 규칙은 스킬(Skill)로 분리합니다. Sharkly에서 스킬(Skill)은 재사용 가능한 지침과 보조 파일을 패키징한 것이며, 에이전트는 실행할 때마다 할당된 스킬을 로드합니다. 구체적인 형식은 코딩 에이전트 스킬이란 무엇인가 글을 참고하세요.
2단계: 에이전트에 이미지 API 키 전달하기
실행 환경에 MINIMAX_API_KEY 환경 변수가 필요합니다. Sharkly의 에이전트 설정에서는 일반 환경 변수와 시크릿(secret) 환경 변수를 관리할 수 있으며, 태스크 기반 실행이 시작될 때 구성된 변수와 시크릿 바인딩이 주입됩니다.
해당 설정 패널의 안내 문구를 확인하세요. 일반 환경 변수 값은 권한을 가진 에이전트 관리자에게 표시되며 안전한 시크릿 저장소가 아니므로, 비용이 청구되는 API 키는 반드시 시크릿 설정에 저장해야 합니다. 태스크 설명이나 댓글에 API 키를 직접 적어서는 안 됩니다. 자세한 내용은 코딩 에이전트 시크릿 유출 방지 체크리스트를 참조하세요.
Sharkly에는 내장된 MiniMax 이미지 커넥터가 없습니다. 에이전트는 자신이 실행되는 컴퓨터(Computer) 상의 스크립트를 통해 일반적인 HTTP 서비스를 호출하듯 API를 직접 호출합니다. 단, Sharkly는 2026-10-26 변경 이력을 통해 MiniMax Code(mcode)를 런타임으로 지원하고 있으므로, 이미 MiniMax Code를 사용 중인 팀은 에이전트를 그곳에서 실행할 수 있습니다. 실무에 적용하기 전에 헤드리스(headless) 실행 환경에서 이미지 생성이 정상 작동하는지 먼저 테스트해 보세요.
3단계: 에이전트가 실행할 스크립트 작성하기
모든 실행에서 동일한 형식의 요청을 보낼 수 있도록 이 스크립트를 스킬에 포함해 배포하세요. MiniMax 공식 가이드의 요청 형식을 따릅니다.
# make_header.py: generate one 16:9 header with MiniMax H3-Image
import os, sys, json, requests
prompt = open(sys.argv[1]).read().strip() # prompt.txt written by the Agent
resp = requests.post(
"https://api.minimax.io/v1/images/generations",
headers={"Authorization": f"Bearer {os.environ['MINIMAX_API_KEY']}"},
json={
"model": "MiniMax-H3-Image",
"prompt": prompt,
"aspect_ratio": "16:9",
"area": "2K",
"n": 1,
"response_format": "url",
},
timeout=600,
)
resp.raise_for_status()
result = resp.json()
item = result["data"][0]
if "error" in item:
sys.exit(f"Image failed: {item['error']['message']}")
with open(f"header.{result['output_format']}", "wb") as f:
f.write(requests.get(item["url"], timeout=120).content)
json.dump({"size": item["size"], "revised_prompt": item["revised_prompt"]},
open("image-meta.json", "w"), indent=2)
팀 협업 환경에서는 세 가지 세부 사항이 중요합니다.
- 자동 재시도 금지: MiniMax 가이드에서는 이 API 호출이 멱등(idempotent)하지 않다고 경고합니다. 즉, 재시도 시 이미지 비용이 중복 청구될 수 있습니다. 루프를 돌며 재시도하는 대신 에이전트가 실패를 그대로 보고하도록 해야 합니다.
revised_prompt보관: 프롬프트 자동 개선(Prompt enhancement) 기능이 기본으로 활성화되어 있으며, 응답에는 실제로 사용된 프롬프트가 반환됩니다. 이를 저장해 두면 검토자가 원본 프롬프트를 추측할 필요 없이 수정을 요청할 수 있습니다.- 파일 다운로드: 가이드에서는 이미지를 직접 다운로드하여 보관할 것을 권장하므로, 검토자에게 API 응답 URL을 그대로 전달하지 마세요.
4단계: 두 파일 첨부 후 검토 단계에서 대기하기
초안과 이미지가 생성되면 에이전트는 이를 태스크에 첨부하고 작업 내용을 보고합니다. Sharkly CLI를 사용하면 한 줄의 명령어로 두 작업을 모두 처리할 수 있습니다.
sharkly task comment "$TASK_ID" \
--body-file run-summary.md \
--attachment article.md \
--attachment header.jpg \
--attachment image-meta.json
요약 보고서에는 단어 수, 모델 ID, 이미지 크기, 응답의 usage 블록, 그리고 검증할 수 없었던 항목들이 기재됩니다. 그런 다음 에이전트는 검토가 필요한 상태로 대화를 인계합니다. 이렇게 인계된 내용은 사이드바의 Task Chats 모듈에 표시되므로 누락되지 않고 확인할 수 있습니다.
모든 결과물이 태스크로 모이기 때문에 검토자가 터미널, 다운로드 폴더, 채팅 로그를 일일이 뒤질 필요가 없습니다.
5단계: 글과 이미지를 한곳에서 검토하기
검토자는 해당 태스크 하나만 열어 기획안과 대조하며 두 결과물을 확인합니다.
- 대표 이미지가 이전 초안이 아닌 최종 글의 논지와 방향성에 맞게 구성되었는가?
- 이미지 안에 생성된 텍스트가 포함되어 있지 않은가? 이미지 모델은 여전히 글자 표기에서 오타를 낼 수 있으므로 기획안에서 텍스트를 포함하지 않도록 지정했습니다.
- 이미지에 실제 제품 화면이 들어가 있는가? 만약 그렇다면 실제 스크린샷으로 교체해야 합니다. 생성된 UI는 어디까지나 모형(mockup)에 불과합니다.
- 글에 담긴 사실관계가 인용한 출처와 일치하는가?
수정을 요청하려면 태스크에 댓글을 남기면 됩니다. 에이전트는 초안, 이미지, 저장된 프롬프트가 포함된 컨텍스트를 그대로 유지한 채 작업을 이어받습니다. 사람이 개입해야 하는 시점에 대한 자세한 내용은 휴먼 인 더 루프(HITL) 코딩 에이전트 가이드를 참조하세요.
이 워크플로가 적합하지 않은 경우
일회성 이미지 제작에는 이 방식을 사용할 필요가 없습니다. 슬라이드에 넣을 이미지 한 장이 필요한 정도라면 기획안을 작성하는 것보다 웹 앱을 직접 여는 편이 더 빠릅니다.
실제 제품 스크린샷, 실제 데이터가 들어간 차트, 실제 인물이나 행사 사진의 경우에는 이미지 생성을 완전히 배제하세요. 이러한 이미지에는 실물 출처가 필요합니다. 이미지 생성은 콘셉트 아트, 추상적인 헤더 이미지, 어차피 직접 손으로 다시 그릴 다이어그램 등에 적합합니다. 여러 게시물에 걸쳐 시각적 스타일의 일관성을 유지하는 방법은 AI 에이전트로 브랜드 비주얼 일관성을 유지하는 방법을 참고하세요.
결론
이미지 모델을 다루는 것은 어렵지 않습니다. 공식 요금표 기준 MiniMax H3-Image로 2K 대표 이미지를 만드는 데 약 2센트밖에 들지 않습니다. 실제로 시간을 절약해 주는 핵심은 이를 둘러싼 체계입니다. 바로 '하나의 태스크, 하나의 기획안, 한 번의 에이전트 실행, 한 번의 검토'입니다.
한 번만 설정해 두면 됩니다. 컴퓨터(Computer)를 연결하고, 시크릿 설정에 이미지 API 키를 등록한 에이전트를 생성한 뒤, 위의 스킬과 스크립트를 부여하고 다음 주 블로그 글을 할당해 보세요. Sharkly는 무료로 시작할 수 있으며, 최신 요금제는 sharkly.ai에서 확인할 수 있습니다.
자주 묻는 질문 (FAQ)
AI 에이전트가 스스로 블로그 이미지를 생성할 수 있나요?
네, 실행 환경에 이미지 API 키와 API를 호출하는 스크립트 또는 도구가 갖춰져 있다면 가능합니다. 에이전트가 초안을 바탕으로 프롬프트를 작성하고, 엔드포인트를 호출한 뒤, 파일을 저장하여 검토를 위해 태스크에 첨부합니다.
MiniMax H3-Image란 무엇인가요?
H3-Image는 2026년 11월 10일에 출시된 MiniMax의 텍스트 투 이미지 및 이미지 편집용 오픈 가중치 모델입니다. 약 1,600만 화소의 이미지를 출력하며, 편집 모드에서는 최대 16장의 참조 이미지를 지원합니다.
H3-Image로 대표 이미지를 생성하는 데 드는 비용은 얼마인가요?
MiniMax 가격 안내 페이지 기준, 2K 텍스트 투 이미지 1회 생성 비용은 약 $0.02333이며 4K는 $0.06879입니다. 프롬프트 개선을 통해 추가된 토큰 비용도 함께 청구되므로 실제 비용은 프롬프트 길이에 따라 달라질 수 있습니다.
Sharkly에 MiniMax 이미지 기능이 기본 연동되어 있나요?
아닙니다. Sharkly는 사용자의 컴퓨터(Computer)에서 에이전트를 실행하며, 에이전트가 사용자의 API 키를 이용해 MiniMax API를 직접 호출합니다. MiniMax Code가 Sharkly 런타임(Runtime)으로 지원되지만, 이는 이미지 커넥터와는 별개입니다.
API 키는 어디에 저장해야 하나요?
에이전트의 시크릿(secret) 설정에 저장해야 합니다. Sharkly의 일반 환경 변수는 에이전트 관리자에게 노출되며, 태스크 설명과 댓글은 해당 태스크를 열람할 수 있는 모든 사람에게 공개됩니다.
에이전트가 글 발행까지 직접 진행해야 할까요?
아닙니다. 발행 권한은 사람이 직접 유지하는 것이 좋습니다. 에이전트는 초안 작성과 첨부까지만 담당하고, 검토자가 최종 승인 후 직접 발행해야 합니다.
