Nodaro 문서오브젝트와 크리처
AI 어시스턴트에서 저장된 오브젝트와 크리처를 나열하고 읽으며, 이미지와 베리언트를 생성하고 대표 이미지를 승인하고 턴테이블과 대기 동작 클립을 만드세요.
오브젝트와 크리처 도구를 사용하면 어시스턴트가 내 라이브러리의 소품, 제품, 크리처를 사용할 수 있습니다. 모습이 고정되어 모든 샷에서 똑같이 보이는 물건과 존재입니다. 어시스턴트는 이를 나열하고 읽고, 이미지와 베리언트를 생성하고, 대표 이미지를 승인하고, 짧은 모션 클립을 만듭니다. 오브젝트와 크리처는 같은 방식으로 작동하며, 크리처에는 자유 텍스트로 정하는 종이 더해집니다. 앱에서 같은 작업을 하는 방법은 오브젝트와 크리처를 읽어 보세요.
오브젝트와 크리처는 앱에서 만듭니다. 이를 만드는 MCP 도구는 없습니다.
오브젝트 도구
list_objects
내 오브젝트를 나열합니다. 여러 샷에서 다시 쓰는 소품, 액세서리, 물리적인 물건입니다. 각 행에는 이름, 설명, 대표 이미지, 베리언트 개수가 있습니다. 최신순입니다.
권한: assets:read. 크레딧: 무료.
| 매개변수 | 타입 | 설명 |
|---|---|---|
search | string | 최대 5단어, 최대 200자입니다. 모든 단어가 대소문자와 관계없이 오브젝트의 이름이나 설명에 있어야 합니다. 빈 값은 검색하지 않음을 뜻합니다. 사용자가 이름을 말할 때 사용하세요. |
limit | integer | 1~100입니다. 기본값은 50입니다. |
반환값: 오브젝트 목록입니다. 베리언트 URL은 get_object를 호출해 가져오세요.
get_object
오브젝트 하나의 전체 정보를 반환합니다. 모든 베리언트와 각각의 이름 및 URL, 레퍼런스 사진이 담깁니다.
권한: assets:read. 크레딧: 무료.
| 매개변수 | 타입 | 설명 |
|---|---|---|
id | string | 필수. list_objects에서 받은 오브젝트 ID입니다. |
반환값: 오브젝트입니다. 오브젝트가 없거나 내 것이 아니면 오류입니다.
generate_object
오브젝트의 이미지(kind: "main")나 베리언트(kind: "asset")를 생성합니다. 결과는 오브젝트에 저장되지 않습니다.
권한: workflows:execute. 크레딧: 이미지 모델의 가격.
| 매개변수 | 타입 | 설명 |
|---|---|---|
name | string | 필수. 오브젝트의 이름입니다. |
kind | string | main(기본값) 또는 asset입니다. |
description, style | string | 오브젝트의 생김새입니다. |
category | string | furniture, vehicle, weapon, food, clothing, electronics, nature, tool, animal, other 중 하나입니다. |
asset_type | string | asset에서: angles, materials, variations, custom 중 하나입니다. |
variant | string | asset에서: 예를 들어 front, wood, weathered입니다. |
model | string | 이미지 모델입니다. 기본값은 gpt-image-2입니다. |
source_image_url | string | 소스 이미지입니다. |
반환값: 작업 ID입니다.
approve_object_main_image
완료된 후보를 오브젝트의 대표 이미지로 정하고, 비전 모델이 그 형태, 재질, 상태, 용도를 기준 설명에 묘사하게 합니다.
권한: assets:write. 크레딧: 설명을 위한 짧은 LLM 실행 1회.
| 매개변수 | 타입 | 설명 |
|---|---|---|
object_id | string | 필수. 대상 오브젝트입니다. |
candidate_job_id | string | 필수. 이 오브젝트를 위해 생성된, 완료된 내 이미지 작업입니다. 다른 오브젝트를 위해 만든 작업은 candidate_object_mismatch를 반환합니다. |
expected_updated_at | string | 오브젝트의 updatedAt입니다. 그 뒤에 오브젝트가 바뀌었으면 호출이 새 값과 함께 concurrent_modification을 반환합니다. |
반환값: 대표 이미지 URL과 설명입니다. 설명 생성에 실패해도 이미지는 설정되고 설명은 비어 있습니다. 이때는 recaption_object를 실행하세요.
recaption_object
비전 모델이 현재 대표 이미지를 약 80~120단어로 다시 묘사하게 하고, 이를 기준 설명으로 저장합니다.
권한: assets:write. 크레딧: 짧은 LLM 실행 1회.
| 매개변수 | 타입 | 설명 |
|---|---|---|
object_id | string | 필수. 대상 오브젝트입니다. |
반환값: 새 설명입니다. 오브젝트에 대표 이미지가 없으면 main_image_required, 설명 생성에 실패하면 caption_failed입니다.
generate_object_motion
오브젝트를 “느린 360도 회전”, “살짝 위아래로 흔들리며 떠 있는 오브젝트”, “왼쪽에서 오른쪽으로 패럴랙스 팬” 같은 짧은 클립으로 만듭니다.
권한: workflows:execute. 크레딧: 동영상 모델의 가격. 기본 모델인 Kling 2.5 Turbo Pro는 5초 클립을 138크레딧에 만듭니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
motion_prompt | string | 필수. 오브젝트나 카메라의 움직임으로, 최대 2,000자입니다. |
source_image_url | string | 필수. 첫 프레임으로, 보통 오브젝트의 승인된 대표 이미지입니다. |
name | string | 필수. 오브젝트의 이름으로, 프롬프트에서 맥락으로 쓰입니다. |
provider | string | kling-turbo(기본값), kling, kling-3.0, minimax, hailuo-2.3, wan-i2v, seedance, bytedance-lite 중 하나입니다. |
aspect_ratio | string | 1:1(기본값, 제품 프레이밍용), 3:4, 16:9, 9:16, 4:3 중 하나입니다. |
attach_to_object_id | string | 클립을 오브젝트의 모션 클립에 저장합니다. 크레딧을 예약하기 전에 소유권을 확인합니다. |
attach_name | string | 저장할 클립의 이름입니다. |
refine_from_video_url | string | 기존 클립을 새 프롬프트로 동영상에서 동영상으로 다듬습니다. 예를 들어 “같은 샷이지만 회전을 더 빠르게”입니다. |
canonical_description, category, style | string | 프롬프트에 더할 추가 맥락입니다. |
반환값: 작업 ID입니다. 준비되면 카드에서 클립이 재생됩니다.
크리처 도구
list_creatures
내 크리처를 나열합니다. 모습이 고정된 동물과 사람이 아닌 존재입니다. 각 행에는 이름, 설명, 대표 이미지, 베리언트 개수가 있습니다. 최신순입니다.
권한: assets:read. 크레딧: 무료.
| 매개변수 | 타입 | 설명 |
|---|---|---|
search | string | 최대 5단어, 최대 200자입니다. 모든 단어가 대소문자와 관계없이 크리처의 이름이나 설명에 있어야 합니다. 빈 값은 검색하지 않음을 뜻합니다. |
limit | integer | 1~100입니다. 기본값은 50입니다. |
반환값: 크리처 목록입니다. 베리언트 URL은 get_creature를 호출해 가져오세요.
get_creature
크리처 하나의 전체 정보를 반환합니다. 모든 베리언트와 각각의 이름 및 URL, 레퍼런스 사진, 저장된 보이스가 담깁니다.
권한: assets:read. 크레딧: 무료.
| 매개변수 | 타입 | 설명 |
|---|---|---|
id | string | 필수. list_creatures에서 받은 크리처 ID입니다. |
반환값: 크리처입니다. 크리처가 없거나 내 것이 아니면 오류입니다.
generate_creature
크리처의 이미지(kind: "main")나 베리언트(kind: "asset")를 생성합니다. 결과는 크리처에 저장되지 않습니다.
권한: workflows:execute. 크레딧: 이미지 모델의 가격.
| 매개변수 | 타입 | 설명 |
|---|---|---|
name | string | 필수. 크리처의 이름입니다. |
kind | string | main(기본값) 또는 asset입니다. |
species | string | dragon, wolf, griffin 같은 자유 텍스트로, 최대 200자입니다. |
category | string | mammal, mythical, reptile 같은 자유 텍스트입니다. |
style | string | realistic, anime, 3d-pixar, illustration 같은 자유 텍스트입니다. |
description | string | 크리처의 생김새입니다. |
asset_type | string | asset에서: angles, poses, variations, custom 중 하나입니다. |
variant | string | asset에서: 예를 들어 front, standing, weathered입니다. |
model | string | 이미지 모델입니다. 기본값은 gpt-image-2입니다. |
source_image_url | string | 소스 이미지입니다. |
반환값: 작업 ID입니다.
approve_creature_main_image
완료된 후보를 크리처의 대표 이미지로 정하고, 비전 모델이 그 종, 해부학적 구조, 색, 상태를 기준 설명에 묘사하게 합니다.
권한: assets:write. 크레딧: 설명을 위한 짧은 LLM 실행 1회.
| 매개변수 | 타입 | 설명 |
|---|---|---|
creature_id | string | 필수. 대상 크리처입니다. |
candidate_job_id | string | 필수. 이 크리처를 위해 생성된, 완료된 내 이미지 작업입니다. 다른 크리처를 위해 만든 작업은 candidate_creature_mismatch를 반환합니다. |
expected_updated_at | string | 크리처의 updatedAt입니다. 그 뒤에 크리처가 바뀌었으면 호출이 concurrent_modification을 반환합니다. |
반환값: 대표 이미지 URL과 설명입니다. 설명 생성에 실패하면 recaption_creature를 실행하세요.
recaption_creature
비전 모델이 현재 대표 이미지를 약 80~120단어로 다시 묘사하게 하고, 이를 기준 설명으로 저장합니다.
권한: assets:write. 크레딧: 짧은 LLM 실행 1회.
| 매개변수 | 타입 | 설명 |
|---|---|---|
creature_id | string | 필수. 대상 크리처입니다. |
반환값: 새 설명입니다. 크리처에 대표 이미지가 없으면 main_image_required, 설명 생성에 실패하면 caption_failed입니다.
generate_creature_motion
크리처를 “미묘하게 흔들리며 숨 쉬는 크리처” 같은 짧은 대기 동작 클립이나, 어슬렁거리는 걸음, 날갯짓, 패럴랙스 팬 클립으로 만듭니다.
권한: workflows:execute. 크레딧: 동영상 모델의 가격. 기본 모델인 Kling 2.5 Turbo Pro는 5초 클립을 138크레딧에 만듭니다.
| 매개변수 | 타입 | 설명 |
|---|---|---|
motion_prompt | string | 필수. 크리처나 카메라의 움직임으로, 최대 2,000자입니다. |
source_image_url | string | 필수. 첫 프레임으로, 보통 크리처의 승인된 대표 이미지입니다. |
name | string | 필수. 크리처의 이름입니다. |
provider | string | kling-turbo(기본값), kling, kling-3.0, minimax, hailuo-2.3, wan-i2v, seedance, bytedance-lite 중 하나입니다. |
aspect_ratio | string | 1:1(기본값), 3:4, 16:9, 9:16, 4:3 중 하나입니다. |
attach_to_creature_id | string | 클립을 크리처의 모션 클립에 저장합니다. 크레딧을 예약하기 전에 소유권을 확인합니다. |
attach_name | string | 저장할 클립의 이름입니다. |
refine_from_video_url | string | 기존 클립을 새 프롬프트로 동영상에서 동영상으로 다듬습니다. |
canonical_description, category, style | string | 프롬프트에 더할 추가 맥락입니다. |
반환값: 작업 ID입니다. 준비되면 카드에서 클립이 재생됩니다.
자주 묻는 질문
어시스턴트가 새 오브젝트나 크리처를 만들 수 있나요?
저장된 항목으로는 만들 수 없습니다. 오브젝트나 크리처를 만드는 도구는 없으므로 앱에서 만드세요. 그런 다음 어시스턴트가 이를 나열하고 읽고, 이미지와 클립을 생성하고, 그 항목을 위해 만든 대표 이미지를 승인할 수 있습니다.
대표 이미지 승인이 불일치 오류로 실패하는 이유는 무엇인가요?
후보 작업은 그 오브젝트나 크리처를 위해 생성된 것이어야 합니다. 다른 항목을 위해 만들었거나 어떤 항목에도 연결되지 않은 후보는 candidate_object_mismatch 또는 candidate_creature_mismatch를 반환합니다.
제품으로 어떤 모션 클립을 만들 수 있나요?
느린 360도 회전, 살짝 위아래로 흔들리며 떠 있는 모습, 패럴랙스 팬 같은 짧은 클립입니다. generate_object_motion은 기본적으로 정사각형 프레이밍과 Kling 2.5 Turbo Pro를 사용합니다.
오브젝트와 크리처는 어떻게 다른가요?
오브젝트는 소품, 제품, 탈것 같은 물리적인 물건입니다. 크리처는 동물이나 사람이 아닌 존재로, 드래곤이나 늑대 같은 종을 자유 텍스트로 정하며, 재질 베리언트 대신 포즈 베리언트가 있습니다.
관련 문서
오브젝트와 소품
동물과 크리처
오브젝트/소품 에셋
동물/크리처 에셋
캐릭터
최종 업데이트