이미지

이미지 도구를 사용하면 어시스턴트가 Nodaro에서 이미지를 만들고 바꿀 수 있습니다. 프롬프트로 생성하고, 기존 이미지를 변환하거나 편집하고, 마스크를 따고, 여러 이미지나 레이어를 합성하고, 이미지에 담긴 내용을 설명합니다. 각 도구는 작업을 시작해 그 ID를 반환하며, 결과는 내 라이브러리에 저장됩니다. 모든 이미지 도구에는 workflows:execute 권한이 필요합니다.

generate_image

Nodaro의 이미지 모델 중 하나로 텍스트 프롬프트에서 이미지를 만듭니다. “…의 이미지를 만들어 줘” 같은 요청에 쓰이는 도구이며, 이미지 생성 노드와 같은 방식으로 작동합니다.

권한: workflows:execute. 크레딧: 선택한 해상도나 품질에서의 모델 가격입니다.

반환값: 작업 ID입니다. MCP Apps를 지원하는 클라이언트에서는 이미지가 준비되면 카드에 표시됩니다.

한 번의 호출로 여러 이미지

• count는 같은 요청으로 이미지를 최대 4장 만듭니다. 이미지마다 별도의 작업입니다.
• models는 같은 요청을 모델 2~4개에서 실행합니다. 둘 다 쓰면 count는 모델당 개수이므로, 한 번의 호출로 최대 8장을 만듭니다.
• 응답은 모든 작업 ID를 모델별로 묶어 배치 ID와 함께 나열합니다. 카드와 jobId는 첫 번째 작업을 따릅니다.
• 모델마다 자체 설정을 받습니다. 화면 비율, 해상도 같은 옵션은 단일 호출과 마찬가지로 각 모델에 맞춰집니다.
• 배치는 전체로 청구됩니다. Nodaro는 배치 전체에 대해 잔액을 확인하고, 모든 작업을 만들거나 하나도 만들지 않습니다. 오류 응답은 아무것도 청구되지 않았다는 뜻입니다.
• 거부. 1~4를 벗어난 count, 4개를 넘는 모델, model과 models를 함께 쓴 경우, 이미지 모델이 아닌 모델이 들어 있는 목록은 거부됩니다. 오류가 문제를 알려 줍니다. models의 모델 ID는 대소문자와 관계없이 일치합니다.

프리셋 적용

presetId는 기본 프리셋이나 저장한 프리셋을 편집기가 적용하는 방식 그대로 적용합니다.

• 프리셋의 프롬프트와 프롬프트 앞뒤 텍스트가 사용됩니다. 내 prompt는 그 텍스트로 감싸집니다.
• {name || default} 형식으로 쓴 자리 표시자는 기본값으로 채워집니다.
• 프리셋의 스타일과 네거티브 프롬프트는 모델이 받는 방식으로 전달됩니다.
• 프리셋이 정하지 않은 설정은 편집기의 기본값을 받습니다. 저장한 이미지 기본값은 프리셋 호출에 적용되지 않습니다.

{BRAND}처럼 기본값이 없는 자리 표시자는 variables에 값이 있어야 합니다. 값이 없으면 도구가 빠진 값을 알려 줍니다. count를 쓰면 도구는 프리셋 요청으로 그 수만큼 이미지를 만듭니다. models를 쓰면 모델마다 프리셋을 한 번씩 적용합니다. 아직은 presetId를 palette_id나 moodboard_id와 함께 쓸 수 없으며, 호출이 거부됩니다.

팔레트와 무드보드

palette_id는 팔레트의 모든 색을 일상적인 이름과 16진수 코드로 프롬프트에 넣습니다. moodboard_id는 무드보드의 설명을 프롬프트에 더하고, 이미지를 내 레퍼런스 뒤에 모델의 한도까지 스타일 레퍼런스로 보냅니다. 일부 이미지가 들어가지 못하면 응답에 그렇게 나옵니다. 팔레트와 무드보드는 아래 도구로 만들고 찾으세요.

modify_image

프롬프트로 기존 이미지를 편집, 스타일 변경, 변환합니다. 색 바꾸기, 배경 교체, 스타일 적용, 프레임 확장이나 일부 다시 그리기를 할 수 있습니다. 이미지 수정 노드와 같은 방식으로 작동합니다.

권한: workflows:execute. 크레딧: 모델의 가격입니다.

반환값: 작업 ID입니다.

image_to_image

프롬프트로 이미지를 변환하며, 마스크를 쓰거나 여러 레퍼런스를 이미지 하나에 합치는 옵션이 있습니다.

권한: workflows:execute. 크레딧: 모델의 가격입니다.

반환값: 작업 ID입니다.

edit_image

이미지를 업스케일하거나, 배경을 제거하거나, 부분 편집을 적용합니다. 연산은 model로 고르세요.

권한: workflows:execute. 크레딧: 아래 표에 나온 연산의 가격입니다.

Grok Imagine 2 이미지의 일부 영역만 편집하려면 두 단계로 작업하세요. 먼저 이미지의 task_id로 grok-2-segment를 실행하고, 작업의 segments에서 이름 붙은 영역을 읽으세요. 그다음 같은 task_id, 프롬프트, 바꿀 영역의 mask_indexes로 grok-2-edit을 실행하세요. 영역 지도는 무료입니다.

반환값: 작업 ID입니다.

generate_mask

“the person”(인물)이나 “sky and clouds”(하늘과 구름)처럼 설명한 대상의 흑백 마스크를 만듭니다. 흰색이 선택된 영역입니다. 마스크는 image_to_image, edit_image, 또는 generate_image의 인페인팅 필드에 쓰세요. 마스크 생성 노드와 같은 방식으로 작동합니다.

권한: workflows:execute. 크레딧: 55크레딧입니다.

반환값: 작업 ID입니다. 결과는 PNG 마스크입니다.

image_collage

이미지 2~30개를 큰 이미지 하나에 넣습니다. 어떤 이미지도 잘리지 않습니다. smart 레이아웃은 각 이미지를 원래 모양대로 행에 배치하고, grid 레이아웃은 같은 크기의 칸을 쓰며 빈 공간을 배경색으로 채웁니다. 이미지 콜라주 노드와 같은 방식으로 작동하며, 스토리보드와 콘택트 시트에 알맞습니다.

권한: workflows:execute. 크레딧: 2K는 22크레딧, 4K는 44크레딧입니다.

반환값: 작업 ID입니다.

image_overlay

기본 이미지 위에 레이어 1~12개를 픽셀 단위로 정확하게 배치합니다. 로고, 잘라 낸 이미지, 텍스트, QR 코드, 도형입니다. AI 모델이 실행되지 않으므로 결과는 매번 같습니다. 이미지 오버레이 노드와 같은 방식으로 작동하며, 모든 옵션은 그 노드 페이지에 설명되어 있습니다.

권한: workflows:execute. 크레딧: 11크레딧이며, 이미지 오버레이 노드와 마찬가지로 variants의 추가 플랫폼 크기마다 조금 더 듭니다.

주요 레이어 필드는 다음과 같습니다.

오른쪽 아래 모서리의 워터마크는 anchor: "bottom-right", x: -4, y: -6, width: 12입니다. SVG 로고는 목표 크기에서 선명하게 렌더링됩니다.

반환값: 작업 ID입니다. 결과에는 이미지, maskUrl, 이미지의 width와 height, 그리고 { id, label, width, height, url } 목록인 variants가 담깁니다.

suggest_overlay_placement

레이어 하나를 기본 이미지의 어디에 놓을지 비전 모델에 묻습니다. 모델은 이미지를 보고 레이어가 얼굴, 주 피사체, 복잡한 질감을 가리지 않게 합니다. 아무것도 합성하지 않으므로, 답을 image_overlay에 전달하세요.

권한: workflows:execute. 크레딧: 이미지 설명 1회로, image_to_text의 가격입니다.

반환값: image_overlay와 같은 퍼센트 단위의 anchor, x, y, width, 그리고 한 문장짜리 reason입니다.

image_to_text

비전 모델로 이미지를 설명하거나 이미지에 관한 질문에 답합니다. 캡션, 대체 텍스트, 장면 분석, 또는 “list all the text in the image”(이미지의 텍스트를 모두 나열해 줘) 같은 구체적인 질문에 쓰세요. 이미지 설명 노드와 같은 방식으로 작동합니다.

권한: workflows:execute. 크레딧: 기본 모델로 4크레딧이며, 가격은 모델 등급을 따릅니다.

반환값: 작업 ID입니다. 텍스트는 작업 출력에 있으며, 카드에 Copy(복사) 버튼과 함께 표시됩니다.

save_image_defaults

선호하는 이미지 설정을 저장해, 이후 generate_image 호출에서 따로 지정하지 않으면 그 설정을 씁니다. 전달한 필드만 바뀝니다. MCP Apps를 지원하는 클라이언트에서는 이미지 카드의 Save as default(기본값으로 저장) 칩이 이 도구를 호출합니다.

권한: workflows:execute. 크레딧: 무료.

반환값: 확인 메시지입니다.

list_palettes

내 컬러 팔레트를 최신순으로 나열합니다. 이름, 일상적인 이름과 16진수 코드로 표시한 각 색, 메모, ID가 담깁니다. ID를 generate_image에 palette_id로 넘기세요.

권한: assets:read. 크레딧: 무료.

반환값: 팔레트 한 페이지로, GET /v1/palettes와 같은 목록입니다.

save_palette

팔레트를 만들거나 수정합니다. 만들려면 name과 colors를 넘기세요. 팔레트를 수정하려면 id와 바뀌는 필드만 넘기세요.

권한: assets:write. 크레딧: 무료.

반환값: ID가 포함된 팔레트입니다. 이 도구로는 팔레트를 삭제할 수 없습니다. 앱, CLI 또는 API에서 삭제하세요.

list_moodboards

내 무드보드를 최신순으로 나열합니다. 이름, 이미지 수, 설명, ID가 담깁니다. id를 넘기면 각 이미지의 링크와 캡션을 포함한 무드보드 하나를 반환합니다. ID를 generate_image에 moodboard_id로 넘기세요.

권한: assets:read. 크레딧: 무료.

반환값: 무드보드 한 페이지 또는 무드보드 하나로, GET /v1/moodboards와 GET /v1/moodboards/:id가 반환하는 것과 같습니다.

save_moodboard

무드보드를 만들거나 수정합니다. 만들려면 name과 images를 넘기세요. 무드보드를 수정하려면 id와 바뀌는 필드만 넘기세요.

권한: assets:write. 크레딧: 무료.

반환값: ID가 포함된 무드보드입니다. 이미지는 링크로 보관되며 복사되지 않습니다. 이 도구로는 무드보드를 삭제할 수 없습니다.