MCP API — 이미지 생성

개요

MCP로 이미지를 생성하거나 업로드하여 영상 파이프라인의 참조 에셋으로 사용하는 방법을 다룹니다. 핵심 도구는 upload_asset과 generate_image이며, 반환되는 assetId는 이후 create_clip 등에서 재사용할 수 있습니다.

upload_asset

외부 이미지 URL 또는 base64 데이터를 받아 Autoagens Storage에 안정적으로 저장합니다. 무료입니다.

파라미터

• url — public 이미지 URL
• base64Data — 또는 base64 데이터 (data URL 가능)
• mimeType — base64Data가 raw일 경우 필요 (예: image/png)

반환값

• assetId — mcpa_... 로 시작하는 안정적 ID
• publicUrl — Supabase Storage public URL
• mimeType, width, height

사용 시나리오

• 기존 브랜드 로고, 제품 사진을 영상 파이프라인에 가져오기
• 외부에서 생성한 이미지를 안정적인 public URL로 보관 (세션 URL 만료 회피)
• 캐릭터 참조 이미지로 characterReferences에 전달

generate_image

Gemini 기반 AI 이미지 생성 도구입니다. 텍스트만으로 생성하거나, 참조 이미지를 활용한 image-to-image 생성이 가능합니다. 100 코인.

파라미터

• prompt (필수) — 이미지 생성 프롬프트 (한국어/영어)
• referenceImages — public URL 배열 (image-to-image 모드)
• referenceAssetIds — 사전 업로드된 assetId 배열 (재사용에 권장)

반환값

upload_asset과 동일한 구조 — assetId, publicUrl, mimeType, width, height

사용 시나리오

• 캐릭터 원본을 생성 → 여러 씬의 create_clip에 동일 assetId로 전달 (캐릭터 일관성)
• 참조 이미지의 스타일/구도를 유지하며 변형 이미지 생성
• 영상 시작/끝 프레임(키프레임) 생성 후 I2V 모드에 전달

upload_asset vs generate_image

항목	upload_asset	generate_image
용도	기존 이미지 보관	새 이미지 생성
비용	무료	100 코인
입력	URL 또는 base64	프롬프트 (+ 참조)
반환	assetId + publicUrl	assetId + publicUrl

캐릭터 일관성 유지 전략

여러 씬에 걸쳐 동일 인물/상품을 유지하려면 다음 패턴을 사용합니다:

1. generate_image로 캐릭터 원본 생성 → assetId_main 확보
2. 각 씬마다 create_clip 호출 시:

   {
     "mode": "image-text-to-video",
     "model": "kling-v3-pro",
     "imageAssetId": "assetId_main",
     "characterReferences": [{ "frontalImageAssetId": "assetId_main" }],
     "prompt": "씬별 모션 설명"
   }

3. 멀티씬 연결: previousClipTaskId + referenceVideoUrl로 모션 연속성 강화

참고

Gemini 이미지 생성은 한국어/영어 프롬프트 모두 지원합니다. 참조 이미지는 public URL fetch가 가능해야 하며, 만료 URL이나 세션 의존 URL은 실패로 처리됩니다.