Constant 스키마 문서

ConstantRegistry에 등록된 데이터베이스 모델, scalar 모델, enum과 관계입니다.

데이터베이스 모델

scalar 모델

enum

관계

데이터베이스 모델

BoardPinboardPin

프로젝트 캔버스 위 자산 하나가 놓인 자리입니다.

BoardPinFull필드 11개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
project 비디오 프로젝트	ID!	propertyimmutable	—	—	—	핀이 놓인 캔버스의 비디오 프로젝트
targetType 대상 유형	String	propertyimmutable	—	—	videoCharactervideoScenevideoObjcreativefilevideoBoardgenImagevideoPlanvideoTake	핀이 얹은 자산의 종류
target 대상	ID	propertyimmutable	—	—	—	핀이 캔버스에 얹은 자산
text 메모	String	property	—	text:desc	—	메모 핀의 글입니다. 대상이 없는 핀은 메모이고 이 글만 듭니다.
position 위치	[Int]!	property	[0,0]	—	—	캔버스 위 핀의 위치
memoStyle 텍스트 서식	MemoStyle	property	—	—	—	메모 핀 글자의 크기·색·굵기·기울임입니다. 비어 있으면 기본 서식으로 읽습니다.
face 얼굴	BoardPinFace	resolve	—	—	—	핀이 가리키는 자산에서 읽어 온 이름과 썸네일

Creativecreative

프로젝트 캔버스에 올린 크리에이티브 레코드입니다 — 이미지, 영상, 오디오 파일 중 하나입니다.

CreativeFull필드 11개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
owner 소유자	LightUser!reference	property	—	—	—	크리에이티브의 소유자
title 제목	String!	property	—	text:title	—	크리에이티브의 제목
tags 태그	[String]!	property	[]	text:tag	—	크리에이티브의 태그
file 파일	File!reference	propertyimmutable	—	—	—	크리에이티브의 파일
assetKind 구분	String	property	—	—	originalclone	라이브러리의 원본인지, 보드에 할당할 때 만든 사본인지입니다. 비면 원본입니다.
copyOf 원본	ID	property	—	—	—	이 사본을 만든 원본 크리에이티브
type 유형	String!	property	—	—	photovideoaudio	크리에이티브의 유형

CreditLogcreditLog

유저 크레딧 잔액의 변동 한 건입니다. 관리자의 지급·차감, 생성 과금, 그 환불이 여기에 남습니다.

CreditLogFull필드 18개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
user 유저	LightUser!reference	propertyimmutable	—	—	—	잔액이 바뀐 유저
type 종류	String!	property	—	—	grantdeductuserefund	지급·차감은 관리자가, 사용은 생성 과금이, 환불은 실패한 생성의 반환이 남깁니다.
amount 변동량	Int!	property	—	—	—	잔액에 더해진 크레딧입니다. 차감과 사용은 음수입니다.
note 메모	String	property		—	—	관리자가 잔액을 바꾼 사유
status 상태	String!	property	settled	—	pendingsettledrefunded	사용 건은 생성이 끝나면 확정, 실패하면 환불로 넘어가기 전까지 대기입니다.
admin 관리자	ID	property	—	—	—	지급·차감한 관리자
genImage 이미지 생성	ID	property	—	—	—	과금된 이미지 생성
genVideo 영상 생성	ID	property	—	—	—	과금된 영상 생성
videoInspect 레퍼런스 분석	ID	property	—	—	—	과금된 레퍼런스 영상 분석
model 모델	String	property	—	—	—	과금 단가를 정한 생성 모델
resolution 해상도	String	property	—	—	—	과금한 해상도 등급
seconds 길이(초)	Int	property	—	—	—	과금한 영상 길이
sourceSeconds 원본 길이(초)	Int	property	—	—	—	편집이 읽은 원본 영상 길이로, 만든 영상과 별도로 과금합니다
imageNum 이미지 수	Int	property	—	—	—	과금한 이미지 수

Settingsetting

Sceny 도메인의 애플리케이션 설정입니다.

SettingFull필드 31개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
resignupDays 재가입 기간(일)	Int!	property	0	—	—	재가입을 허용할 일수
globalImagePrompt 전역 이미지 프롬프트	String	property		—	—	모든 이미지 요청의 맨 앞에 붙습니다. 스타일 프롬프트보다 먼저 나갑니다.
globalVideoPrompt 전역 비디오 프롬프트	String	property		—	—	모든 영상 요청의 맨 앞에 붙습니다. 스타일 프롬프트보다 먼저 나갑니다.
imagePostPrompt 이미지 마무리 규칙	String	property		—	—	모든 컷 프롬프트의 맨 끝 문장입니다. 화면에 글자가 새겨지지 않게 막는 자리입니다.
videoPostPrompt 영상 마무리 규칙	String	property		—	—	모든 샷 프롬프트의 맨 끝 문장입니다. 자막과 립싱크를 막는 자리입니다.
imageNegativePrompt 이미지 금지어	String	property		—	—	모든 컷 그림이 피하는 낱말들입니다. 해부·정체성·품질을 적고, 글자와 워터마크는 마무리 규칙이 맡습니다.
videoNegativePrompt 영상 금지어	String	property		—	—	모든 샷이 피하는 낱말들입니다. 벤더가 금지어 칸을 주면 그 칸으로, 없으면 프롬프트 맨 끝 줄로 나갑니다.
agentSummaryPrompt 대화 요약 프롬프트	String	property		—	—	대화가 길어질 때 도는 요약기의 시스템 프롬프트입니다.
imageRefinePrompt 이미지 정제 프롬프트	String	property		—	—	컷의 조각들을 하나의 영어 지시문으로 다시 쓰는 정제기의 시스템 프롬프트입니다.
videoRefinePrompt 영상 정제 프롬프트	String	property		—	—	샷의 조각들을 하나의 영어 지시문으로 다시 쓰는 정제기의 시스템 프롬프트입니다.
assetRefinePrompt 애셋 정제 프롬프트	String	property		—	—	애셋 시트의 조각들을 그 피사체 하나에 대한 영어 서술로 다시 쓰는 정제기의 시스템 프롬프트입니다.
mediumImagePrompt 매체별 이미지 프롬프트	Map<String, String>!	property	{}	—	—	매체별 이미지 스타일 문장입니다. 비우면 코드의 기본 문장이 나갑니다.
mediumVideoPrompt 매체별 비디오 프롬프트	Map<String, String>!	property	{}	—	—	매체별 영상 스타일 문장입니다. 비우면 코드의 기본 문장이 나갑니다.
moodImagePrompt 무드별 이미지 프롬프트	Map<String, String>!	property	{}	—	—	무드별 이미지 스타일 문장입니다. 비우면 코드의 기본 문장이 나갑니다.
moodVideoPrompt 무드별 비디오 프롬프트	Map<String, String>!	property	{}	—	—	무드별 영상 스타일 문장입니다. 비우면 코드의 기본 문장이 나갑니다.
colorToneImagePrompt 색감별 이미지 프롬프트	Map<String, String>!	property	{}	—	—	색감별 이미지 스타일 문장입니다. 비우면 코드의 기본 문장이 나갑니다.
colorToneVideoPrompt 색감별 비디오 프롬프트	Map<String, String>!	property	{}	—	—	색감별 영상 스타일 문장입니다. 비우면 코드의 기본 문장이 나갑니다.
draftAgentPrompt 새 프로젝트 에이전트 지침	String	property		—	—	'새 영상 프로젝트' 화면의 에이전트입니다. 프로젝트를 만드는 것 하나만 합니다.
recipePlanPrompt 레시피 영상 기획 지침	String	property		—	—	레시피 화면이 고른 레시피와 제품 사진으로 기획을 써서 바로 영상을 만들 때의 지침입니다.
videoBoardAgentPrompt 기획안 에이전트 지침	String	property		—	—	기획안 화면 어시스턴트의 지침입니다.
videoBoardRefinePrompt 기획안 정제 지침	String	property		—	—	기획안의 한국어 비트를 영어 촬영 어휘로 다시 쓰는 방법입니다. 비트 하나가 한 줄로 돌아옵니다.
adminAgentPrompt 관리자 콘솔 에이전트 지침	String	property		—	—	이 콘솔에 떠 있는 에이전트의 지침입니다.
personPolicyPrompt 인물 정책	String	property		—	—	이 작업실의 모든 영상에 걸리는 인물 정책입니다. 레시피보다 위에 있습니다.
inspectPerceivePrompt 레퍼런스 분석 지침	String	property		—	—	영상 분석기가 레퍼런스 영상을 기록하는 방법입니다. 무엇을 서술하고 컷표를 어떻게 지키는지 정합니다.
inspectComposePrompt 레퍼런스 합성 지침	String	property		—	—	분석 기록을 따라 만들 수 있는 구조(역할·비트 본문·가이드·한국어 리포트)로 바꾸는 방법입니다.
inspectReadModel 레퍼런스 분석 모델	String	property		—	—	영상을 보는 Gemini 모델 id
inspectComposeModel 레퍼런스 합성 모델	String	property		—	—	구조를 쓰는 LLM 모델 id

Summarysummary

Sceny 도메인의 집계된 대시보드 통계입니다.

SummaryFull필드 48개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
type 타입	String!	property	non-periodic	—	non-periodicactivehourlydailyweeklymonthly	요약의 타입, 예를 들어 주기적, 비주기적...
at 시각	Date!	property	[function]	—	—	요약이 생성된 시각
status 상태	String!	property	archived	—	activearchived	요약의 상태
prepareUser 준비된 사용자	Int!	property	0	—	—	준비된 사용자 수
activeUser 활성 사용자	Int!	property	0	—	—	활성 사용자 수
dormantUser 휴면 사용자	Int!	property	0	—	—	휴면 사용자 수
restrictedUser 제한된 사용자	Int!	property	0	—	—	제한이 있는 사용자 수
hau HAU	Int!	property	0	—	—	시간별 활성 사용자
dau DAU	Int!	property	0	—	—	일별 활성 사용자
wau WAU	Int!	property	0	—	—	주별 활성 사용자
mau MAU	Int!	property	0	—	—	월별 활성 사용자
totalGenImage 전체 이미지	Int!	property	0	—	—	기록에 남은 전체 이미지 생성 요청
pendingGenImage 대기 중 이미지	Int!	property	0	—	—	접수됐지만 아직 제공자에게 넘기지 않은 수
generatingGenImage 생성 중 이미지	Int!	property	0	—	—	지금 제공자의 응답을 기다리는 수
completedGenImage 완료된 이미지	Int!	property	0	—	—	이미지를 하나 이상 받아 완료된 수
failedGenImage 실패한 이미지	Int!	property	0	—	—	제공자 오류 또는 미완료 방치로 실패 처리된 수
dailyGenImage 이미지 (24시간)	Int!	property	0	—	—	최근 24시간 안에 생성된 수
totalGenVideo 전체 영상	Int!	property	0	—	—	기록에 남은 전체 영상 생성 요청
pendingGenVideo 대기 중 영상	Int!	property	0	—	—	접수됐지만 아직 제공자에게 넘기지 않은 수
generatingGenVideo 생성 중 영상	Int!	property	0	—	—	지금 제공자의 응답을 기다리는 수
completedGenVideo 완료된 영상	Int!	property	0	—	—	영상을 받아 완료된 수
failedGenVideo 실패한 영상	Int!	property	0	—	—	제공자 오류 또는 미완료 방치로 실패 처리된 수
dailyGenVideo 영상 (24시간)	Int!	property	0	—	—	최근 24시간 안에 생성된 수
totalSessionChat 전체 메시지	Int!	property	0	—	—	모든 에이전트 세션에 저장된 전체 메시지
userSessionChat 사용자 메시지	Int!	property	0	—	—	사람이 보낸 메시지
assistantSessionChat 어시스턴트 메시지	Int!	property	0	—	—	에이전트가 답한 메시지
dailySessionChat 메시지 (24시간)	Int!	property	0	—	—	최근 24시간 안에 생성된 수
totalAgentSession 전체 세션	Int!	property	0	—	—	기록에 남은 전체 에이전트 대화
idleAgentSession 대기 세션	Int!	property	0	—	—	진행 중인 턴이 없는 수
thinkingAgentSession 생각 중 세션	Int!	property	0	—	—	에이전트가 생각 중인 수
awaitingAgentSession 답변 대기 세션	Int!	property	0	—	—	질문에서 멈춰 사용자 차례인 수
editingAgentSession 작업 중 세션	Int!	property	0	—	—	에이전트가 결과를 만드는 중인 수
failedAgentSession 실패한 세션	Int!	property	0	—	—	마지막 턴이 실패한 수
dailyAgentSession 세션 (24시간)	Int!	property	0	—	—	최근 24시간 안에 생성된 수
totalVideoProject 전체 프로젝트	Int!	property	0	—	—	기록에 남은 전체 프로젝트
dailyVideoProject 프로젝트 (24시간)	Int!	property	0	—	—	최근 24시간 안에 생성된 수
totalVideoBoard 전체 기획안	Int!	property	0	—	—	모든 프로젝트의 기획안
totalVideoScene 전체 장면	Int!	property	0	—	—	재사용 가능한 장면 에셋
totalVideoCharacter 전체 캐릭터	Int!	property	0	—	—	재사용 가능한 캐릭터 에셋
totalVideoObj 전체 오브젝트	Int!	property	0	—	—	재사용 가능한 오브젝트 에셋
totalCreative 전체 크리에이티브	Int!	property	0	—	—	사용자 라이브러리의 전체 파일
photoCreative 사진 크리에이티브	Int!	property	0	—	—	라이브러리의 사진
videoCreative 영상 크리에이티브	Int!	property	0	—	—	라이브러리의 영상
audioCreative 오디오 크리에이티브	Int!	property	0	—	—	라이브러리의 오디오

Useruser

유저는 서비스를 이용하는 사용자의 공개 정보입니다. 다른 사용자에게 표시될 수 있습니다.

UserFull필드 29개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
nickname 닉네임	String	property		maxlength 12text:title	—	다른 사용자에게 표시되는 유저의 닉네임
image 이미지	Filereference	property	—	text:thumb	—	유저의 프로필 이미지
images 이미지들	[File]!reference	property	[]	—	—	유저의 프로필 이미지들
appliedImages 신청된 이미지들	[File]!reference	property	[]	—	—	유저의 신청된 이미지들
name 이름	String	secretselect:false	—	—	—	유저의 이름
agreePolicies 동의 정책	[String]	secretselect:false	[]	—	—	유저의 동의 정책
discord 디스코드	Any	secretselect:false	{}	—	—	유저의 디스코드 정보
accountId 아이디	String	secretselect:false	—	—	—	유저의 아이디
password 비밀번호	String	secretselect:false	—	—	—	유저의 비밀번호
phone 휴대폰 번호	String	secretselect:false	—	—	—	유저의 휴대폰 번호
notiInfo 알림 정보	NotiInfo	secretselect:false	[function]	—	—	유저의 알림 정보
imageNum 이미지 수	Int	secretselect:false	0	—	—	유저의 이미지 수
encourageInfo 격려 정보	EncourageInfo	secretselect:false	[function]	—	—	유저의 격려 정보
restrictInfo 제한 정보	RestrictInfo	secretselect:false	—	—	—	유저의 제한 정보
leaveInfo 탈퇴 정보	LeaveInfo	secretselect:false	—	—	—	유저의 탈퇴 정보
verifies 인증정보	[String]!	property	[]	—	naverkakaogithubgoogleapplefacebookwalletpasswordphoneemail	유저의 인증정보
roles 권한	[String]!	property	["user"]	text:filter	rootadminuserbusinessguest	유저의 권한
playing 플레이 중	[String]!	property	[]	—	—	유저가 플레이 중인 서비스
isOnline 온라인 상태	Boolean!	property	true	—	—	유저의 온라인 상태
lastLoginAt 최근 로그인	Date!	property	[function]	—	—	유저의 최근 로그인 시간
joinAt 가입일	Date	property	—	—	—	유저의 가입일
profileStatus 프로필 상태	String!	property	prepare	text:filter	activeprepareappliedapprovedreappliedfeaturedreservedrejected	유저의 프로필 승인 상태
badgeCount 뱃지 수	Int!	property	0	—	—	유저의 뱃지 수
status 상태	String!	property	prepare	text:filter	prepareactivedormantrestricted	유저의 상태
credit 크레딧	Int!	property	0	—	—	이미지·영상 생성에 쓰는 잔액입니다. 관리자의 지급·차감과 생성·환불만 이 값을 바꿉니다.

VideoBoardvideoBoard

영상 보드 하나가 영상 하나를 만드는 자리입니다 — 복사해 온 기획안과 자산, 규격입니다. 만든 영상은 각자 따로 남습니다.

VideoBoardFull필드 26개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
owner 소유자	ID!	propertyimmutable	—	—	—	이 영상 보드를 만든 사람
project 프로젝트	ID!	propertyimmutable	—	—	—	영상 보드가 속한 프로젝트입니다. 프로젝트의 제목과 설명이 모든 생성에 함께 실립니다.
plan 기획안	LightVideoPlanreference	property	—	—	—	기획안을 할당할 때 만든 사본입니다. 원본을 나중에 고쳐도 그대로입니다.
refAssets 보드 자산	[RefAsset]!	property	[]	—	—	보드의 자산 사본과 각자 맡은 @슬롯 입니다. 관계가 없으면 참고 그림으로만 실립니다.
mediaStyle 미디어 스타일	MediaStyle	property	—	—	—	이 영상 보드의 모든 생성이 앞에 세우는 매체·무드·색조·키워드입니다. 비우면 기본 모양으로 만듭니다.
videoStyle 비디오 스타일	VideoStyle	property	—	—	—	이 영상 보드의 속도와 참고 프롬프트입니다. 비우면 기본값으로 만듭니다.
refImages 레퍼런스	[File]!reference	property	[]	—	—	사람이 직접 붙인 레퍼런스 그림입니다. 네 장까지입니다.
startFrame 여는 프레임	Filereference	property	—	—	—	영상이 시작하는 프레임입니다. 못박으면 만들 수 있는 모델이 줄어듭니다.
endFrame 닫는 프레임	Filereference	property	—	—	—	영상이 끝나는 프레임입니다. 여는 프레임이 있어야 나가고, 모델 후보를 한 번 더 좁힙니다.
videoGenModel 영상 모델	String	property	—	—	dreamina-seedance-2-5-260628dreamina-seedance-2-0-260128dreamina-seedance-2-0-fast-260128dreamina-seedance-2-0-mini-260615kling-v3kling-v3-omniveo-3.1-generate-previewveo-3.1-fast-generate-previewveo-3.1-lite-generate-previewMiniMax-H3MiniMax-H3-Maxwan3.0-videowan2.7-videoedit	비워두세요. 규격이 모델을 정하고, 못박으면 그 규격을 만들 모델이 없어질 수 있습니다.
resolution 해상도	String	property	—	—	480p720p1080p	480p·720p·1080p 중 하나입니다. 비우면 모델의 평소 등급으로 만들고 720p 값으로 매깁니다. 1080p 는 720p 의 두 배입니다.
aspectRatio 화면 비율	String!	property	9:16	—	9:1616:91:14:5	영상의 화면 비율입니다. 이 영상 보드의 레퍼런스도 같은 비율로 그립니다.
durationSeconds 길이	Int!	property	15	—	—	영상이 흐르는 초입니다. 기획의 컷마다 이 길이를 똑같이 나눠 받습니다.
audio 오디오	Boolean!	property	false	—	—	영상에 벤더가 만든 소리를 붙일지입니다. BGM·나레이션·효과음 중 하나를 켜면 켜집니다.
bgm BGM	Boolean	property	—	—	—	영상 소리에 배경 음악을 넣을지입니다.
narration 나레이션	Boolean	property	—	—	—	영상 소리에 나레이션을 넣을지입니다.
soundEffect 효과음	Boolean	property	—	—	—	영상 소리에 효과음을 넣을지입니다.
refGenModel 레퍼런스 모델	String!	property	gemini-3.1-flash-image	—	gemini-3.1-flash-lite-imagegemini-3.1-flash-imagegpt-image-2seedream-5-0-260128seedream-5-0-lite-260128	그대로 두세요. 모델은 알아서 정합니다.
refGenImages 생성한 레퍼런스	[GenImage]!reference	property	[]	—	—	컷표를 보고 만든 레퍼런스입니다. 한 레코드가 한 장이고, 오래된 순서입니다.
prevRefImages 레퍼런스 이력	[GenImage]reference	secretselect:false	[]	—	—	이 영상 보드가 만든 모든 레퍼런스 이력입니다. 오래된 순서입니다.
archived 아카이브됨	Boolean!	property	false	—	—	이 영상 보드가 아카이브로 지워졌는지. 복구할 수 있습니다.
assetFaces 자산 얼굴	[BoardPinFace]!	resolve	[]	—	—	보드 자산 사본마다의 이름과 썸네일입니다. 보드 자산과 같은 순서입니다.

VideoCharactervideoCharacter

컷이 바뀌어도 같은 인물을 유지하기 위한 인물 에셋 시트입니다.

VideoCharacterFull필드 20개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
owner 소유자	LightUser!reference	property	—	—	—	인물의 소유자
project 프로젝트	LightVideoProject!reference	property	—	—	—	인물의 프로젝트
name 이름	String!	property	—	text:title	—	인물의 이름
gender 성별	String	property	—	—	malefemaleother	인물의 성별입니다. 이 필드 전에 만든 인물에는 없습니다.
medium 매체	String	property	—	—	liveActionanimationillustrationthreeDmixed	시트를 그리는 매체입니다. 보드 슬롯에서 만든 시트는 그 보드의 매체를 따르고, 비면 실사입니다.
description 프롬프트	String	property		text:desc	—	인물의 생김새 서술입니다. 비워도 이름과 성별만으로 시트를 그립니다.
image 이미지	Filereference	property	—	—	—	인물 자체의 그림입니다. 있으면 그대로 쓰고 다시 그리지 않습니다.
refImages 참조 이미지	[File]!reference	property	[]	—	—	시트를 그릴 때 참고하는 그림입니다. 두 장까지입니다.
lastGenModel 마지막 생성 모델	String!	property	gemini-3.1-flash-image	—	gemini-3.1-flash-lite-imagegemini-3.1-flash-imagegpt-image-2seedream-5-0-260128seedream-5-0-lite-260128	인물의 다음 레퍼런스 이미지 생성에 사용할 이미지 생성 모델
assetKind 구분	String	property	—	—	originalclone	라이브러리의 원본인지, 보드에 할당할 때 만든 사본인지입니다. 비면 원본입니다.
copyOf 원본	ID	property	—	—	—	이 사본을 만든 원본 인물
lastGenImage 마지막 생성 이미지	GenImagereference	property	—	—	—	인물의 AI에 의해 생성된 이미지
genImages 생성된 이미지	[GenImage]reference	secretselect:false	[]	—	—	인물의 다양한 포즈와 표정을 담은 이미지들
refinedPrompt 정제된 프롬프트	String	property		—	—	정제기가 이 시트의 조립된 조각들을 대신해 쓴 영어 서술입니다
refinedPromptKey 정제 입력 지문	String	property		—	—	정제를 돌린 조각들의 지문입니다. 원본이 바뀌면 다시 정제합니다
favorite 즐겨찾기	Boolean!	property	false	—	—	라이브러리에서 별을 눌러 둔 인물입니다. 즐겨찾기만 보기에 남습니다.

VideoInspectvideoInspect

바이럴 영상 한 편의 분석입니다. 컷·구조·먹힌 이유를 읽고, 프로젝트가 따라 만들 수 있는 구조로 다시 씁니다.

VideoInspectFull필드 41개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
owner 소유자	ID!	propertyimmutable	—	—	—	분석을 요청한 사람
sourceUrl 영상 링크	String	property		—	—	레퍼런스 영상의 YouTube 링크
sourceFile 영상 파일	LightFilereference	property	—	—	—	올린 영상 파일로, 분석이 끝나면 지워집니다.
note 메모	String	property		—	—	이 영상을 고른 이유와 가져가고 싶은 점입니다. 구조를 쓸 때만 읽습니다.
status 상태	String!	property	pending	—	pendingfetchinganalyzingcomposingcompletedfailed	분석이 어디까지 왔는지
errMsg 오류	String	property		—	—	마지막 시도가 실패한 이유
heartbeatAt 하트비트	Date	property	—	—	—	처리 중인 프로세스가 마지막으로 남긴 신호
attemptNum 시도 수	Int!	property	0	—	—	지금까지의 시도 횟수
platform 플랫폼	String!	property	upload	—	youtubeinstagramtiktokxupload	영상의 출처
sourceKey 원본 키	String	property		—	—	링크 모양과 상관없이 같은 영상을 가리키는 키
cutSource 컷 출처	String	property	—	—	detectormodel	컷 경계를 검출기가 정했는지 분석 모델이 정했는지
source 원본	InspectSource!	property	—	—	—	레퍼런스 영상의 사실
shots 컷	[InspectShot]!	property	[]	—	—	읽은 구간의 모든 컷
shotNum 컷 수	Int!	property	0	—	—	읽은 컷의 수
lines 대사·자막	[InspectLine]!	property	[]	—	—	시각이 붙은 대사·자막·효과음
beats 구조	[InspectBeat]!	property	[]	—	—	순서대로의 구조 단계
thumbs 스틸	[LightFile]!reference	property	[]	—	—	컷마다 한 장의 스틸
format 형식	String	property	—	—	talkingHeadpovtutorialbeforeAfterunboxingproductDemoskitmontageasmrlisticletestimonialtrendvlogother	어떤 형식의 영상인지
mediaStyle 스타일	MediaStyle	property	—	—	—	영상에서 읽은 매체·무드·색감
music 음악	String	property		—	—	어떤 음악인지
beatSynced 비트 편집	Boolean!	property	false	—	—	컷이 비트에 맞는지
voiceover 보이스오버	Boolean!	property	false	—	—	내레이션이 있는지
concept 컨셉	String	property		text:title	—	한 줄 컨셉
hook 훅	String	property		—	—	첫 몇 초가 하는 일
story 흐름	String	property		text:desc	—	영상이 흘러가는 방식
audience 타깃	String	property		—	—	누구를 위한 영상인지
whyItWorks 먹힌 이유	[String]!	property	[]	—	—	영상 속 근거를 붙인 가설이며, 확정된 사실이 아닙니다.
soundNote 사운드	String	property		—	—	음악·목소리·비트 싱크
flow 흐름	[String]!	property	[]	—	—	순서대로의 단계 이름
required 필수 요소	[String]!	property	[]	—	—	따라 만들 때 지켜야 할 것
variation 변주	[String]!	property	[]	—	—	따라 만들 때 바꿔도 되는 것
forbidden 금지	[String]!	property	[]	—	—	따라 만들 때 하면 안 되는 것
guide 가이드	String	property		—	—	기획 에이전트가 읽는 영어 지침
roles 역할	[InspectRole]!	property	[]	—	—	따라 만들 때 자기 자산으로 바꾸는 역할
readModel 분석 모델	String	property		—	—	영상을 본 모델
composeModel 합성 모델	String	property		—	—	구조를 쓴 모델
raw 원문 응답	Any	secretselect:false	—	—	—	디버그용 모델 원문 응답

VideoObjvideoObj

컷이 바뀌어도 같은 사물·제품을 유지하기 위한 오브젝트 에셋 시트입니다.

VideoObjFull필드 20개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
owner 소유자	LightUser!reference	property	—	—	—	오브젝트의 소유자
project 프로젝트	LightVideoProject!reference	property	—	—	—	오브젝트의 프로젝트
name 이름	String!	property	—	text:title	—	오브젝트의 이름
description 설명	String	property		text:desc	—	오브젝트의 설명
productType 제품 종류	String	property		text:tag	—	어떤 종류의 제품인지입니다. 예: 캔음료, 화장품 병
medium 매체	String	property	—	—	liveActionanimationillustrationthreeDmixed	시트를 그리는 매체입니다. 보드 슬롯에서 만든 시트는 그 보드의 매체를 따르고, 비면 실사입니다.
image 이미지	Filereference	property	—	—	—	오브젝트 자체의 그림입니다. 있으면 그대로 쓰고 다시 그리지 않습니다.
refImages 참조 이미지	[File]!reference	property	[]	—	—	시트를 그릴 때 참고하는 그림입니다. 두 장까지입니다.
lastGenModel 마지막 생성 모델	String!	property	gemini-3.1-flash-image	—	gemini-3.1-flash-lite-imagegemini-3.1-flash-imagegpt-image-2seedream-5-0-260128seedream-5-0-lite-260128	오브젝트의 다음 레퍼런스 이미지 생성에 사용할 이미지 생성 모델
assetKind 구분	String	property	—	—	originalclone	라이브러리의 원본인지, 보드에 할당할 때 만든 사본인지입니다. 비면 원본입니다.
copyOf 원본	ID	property	—	—	—	이 사본을 만든 원본 사물
lastGenImage 마지막 생성 이미지	GenImagereference	property	—	—	—	오브젝트의 AI에 의해 생성된 이미지
genImages 생성된 이미지	[GenImage]reference	secretselect:false	[]	—	—	오브젝트의 다양한 포즈와 표정을 담은 이미지 샷들
refinedPrompt 정제된 프롬프트	String	property		—	—	정제기가 이 시트의 조립된 조각들을 대신해 쓴 영어 서술입니다
refinedPromptKey 정제 입력 지문	String	property		—	—	정제를 돌린 조각들의 지문입니다. 원본이 바뀌면 다시 정제합니다
favorite 즐겨찾기	Boolean!	property	false	—	—	라이브러리에서 별을 눌러 둔 오브젝트입니다. 즐겨찾기만 보기에 남습니다.

VideoPlanvideoPlan

기획안 하나입니다 — 영상을 나눈 비트들입니다. 보드에 할당하면 그 보드로 복사됩니다.

VideoPlanFull필드 16개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
owner 소유자	ID!	propertyimmutable	—	—	—	이 기획안을 쓴 사람
project 프로젝트	ID!	propertyimmutable	—	—	—	기획안이 속한 프로젝트
phrase 캐치프레이즈	String	property		text:title	—	이 기획안이 파는 한 문장이자, 목록에서 이 기획안을 알아보는 이름입니다.
summary 연출 의도	String	property		text:desc	—	모든 비트에 걸리는 연출 의도 한 문단입니다. 컨셉, 감정의 아크, 카메라가 보여주지 않을 것을 적습니다.
cutFrames 컷	[CutFrame]!	property	[]	—	—	기획안이 나뉜 비트들입니다. 자산은 @슬롯 으로 적고, 보드가 관계 이름으로 묶습니다.
roles 등장 에셋	[PlanRole]!	property	[]	—	—	컷 본문의 @슬롯 마다 하나씩, 그 슬롯을 맡을 에셋의 종류와 모습, 사진이 필요한 실제 제품인지를 적습니다.
recipe 레시피	ID	property	—	—	—	이 기획안이 시작한 레시피. 없으면 레시피 없이 쓴 것입니다.
inspect 레퍼런스 영상	ID	property	—	—	—	이 기획안이 따라 만드는 분석된 레퍼런스 영상입니다. 레시피보다 우선합니다.
recipeBrief 레시피 입력	VideoRecipeBrief	property	—	—	—	레시피 화면에서 사람이 입력한 값입니다.
assetKind 구분	String	property	—	—	originalclone	라이브러리의 원본인지, 보드에 할당할 때 만든 사본인지입니다. 비면 원본입니다.
copyOf 원본	ID	property	—	—	—	이 사본을 만든 원본 기획안
favorite 즐겨찾기	Boolean!	property	false	—	—	라이브러리에서 별을 눌러 둔 기획안입니다. 즐겨찾기만 보기에 남습니다.

VideoProjectvideoProject

기획안과 그것들이 함께 쓰는 에셋 시트를 담는, 이름 붙은 영상 제작 단위입니다.

VideoProjectFull필드 9개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
owner 소유자	User!reference	propertyimmutable	—	—	—	프로젝트의 소유자
name 이름	String!	property	—	text:title	—	프로젝트의 이름
description 설명	String	property		—	—	프로젝트의 설명
agentSession 대화	ID	property	—	—	—	이 프로젝트가 이어가고 있는 대화
thumbnail 썸네일	Filereference	property	—	—	—	캔버스 전체를 맞춰 찍은 그림입니다. 캔버스를 열어 둔 동안 찍습니다.

VideoRecipevideoRecipe

이 프로젝트를 시작할 때 기획 에이전트가 따라야 하는 검증된 영상 구조입니다.

VideoRecipeFull필드 22개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
code 코드	String!	property	—	text:tag	—	레시피의 짧은 식별자
name 이름	String!	property	—	text:title	—	레시피의 이름
summary 한 줄 소개	String	property		text:desc	—	언제 쓰는 레시피인지 한 줄
category 업종	String!	property	—	—	beautyProductrestaurantCafeclinicspaceRealEstateacademyFitness	이 레시피가 맞는 업종
topics 주제	[String]!	property	[]	—	tastecraftspacesignatureevent	이 레시피가 맞는 주제
flow 흐름	[String]!	property	[]	—	—	순서대로 이어지는 단계
shotMin 최소 샷	Int!	property	8	—	—	이 구조가 쓰는 최소 비트 수
shotMax 최대 샷	Int!	property	17	—	—	이 구조가 쓰는 최대 비트 수
beatPattern 단계별 시간	[Int]!	property	[]	—	—	단계마다 실리는 시간(초)
required 필수	[String]!	property	[]	—	—	이 레시피가 반드시 담아야 하는 것
variation 변주	[String]!	property	[]	—	—	안전하게 바꿔 쓸 수 있는 축
forbidden 금지	[String]!	property	[]	—	—	이 레시피가 절대 하면 안 되는 것
note 메모	String	property		—	—	벤치마크·버전·표본 메모
defaultDurationSeconds 기본 길이	Int!	property	15	—	—	레시피 화면이 시작하는 길이
guide 지침	String	property		—	—	기획 에이전트가 그대로 읽는 영어 지침
enabled 사용	Boolean!	property	true	—	—	사용자에게 노출할지
order 정렬	Int!	property	0	—	—	목록에서의 순서
thumbnail 썸네일	Filereference	property	—	—	—	홈 화면 레시피 카드에 보이는 그림. 카드가 이 그림의 비율을 따른다

VideoRemakevideoRemake

원본 영상을 내 것으로 다시 만듭니다. 카메라·타이밍·컷은 그대로 두고, 지정한 것만 바꿉니다.

VideoRemakeFull필드 25개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
owner 소유자	ID!	propertyimmutable	—	—	—	리메이크를 만든 사람
title 제목	String	property	—	text:title	—	찾기 위한 이름
sourceFile 원본 영상	LightFilereference	property	—	—	—	올린 영상 파일로, 클립을 잘라 내면 지워집니다.
rangeStart 시작(초)	Float!	propertyimmutable	0	—	—	원본에서 클립이 시작하는 지점(초)
rangeEnd 끝(초)	Float	propertyimmutable	—	—	—	원본에서 클립이 끝나는 지점. 비우면 끝까지, 최대 15초입니다.
keepSourceAudio 원본 소리 유지	Boolean!	propertyimmutable	false	—	—	결과에 원본 소리를 남깁니다. 일부 모델만 할 수 있고, 나머지는 소리를 새로 만듭니다.
mode 모드	String!	property	objectSwap	—	objectSwapmotionTransfer	몇 가지만 바꾸고 나머지는 그대로 둘지, 움직임만 남기고 내용을 새로 지을지
swaps 교체	[RemakeSwap]!	property	[]	—	—	원본에서 바뀌는 것과 각각 바뀔 그림, 순서대로
instruction 추가 지시	String	property	—	—	—	그 밖에 바꿀 것을 한두 문장으로
videoGenModel 모델	String	property	—	—	MiniMax-H3wan2.7-videoedit	항상 쓸 리메이크 모델. 비우면 클립 길이와 교체 수가 정합니다.
status 상태	String!	property	pending	—	pendingpreparingreadyfailed	준비가 어디까지 왔는지
errMsg 오류	String	property		—	—	준비가 실패한 이유
heartbeatAt 하트비트	Date	property	—	—	—	준비 중인 프로세스가 마지막으로 남긴 신호
attemptNum 시도 수	Int!	property	0	—	—	지금까지 시작한 준비 횟수
clip 클립	LightFilereference	property	—	—	—	모든 생성이 보내는 원본의 구간으로, 모델용으로 다시 인코딩했습니다.
clipSeconds 클립 길이	Int!	property	0	—	—	클립 길이(정수 초). 결과도 이 길이로 나옵니다.
thumb 스틸	LightFilereference	property	—	—	—	클립 가운데의 스틸
source 원본	InspectSource!	property	—	—	—	올린 영상의 사실
genVideo 최근 결과	GenVideoreference	property	—	—	—	가장 최근 생성
genVideos 결과 이력	[GenVideo]reference	secretselect:false	[]	—	—	모든 생성, 오래된 순
archived 보관됨	Boolean!	property	false	—	—	목록에서 치운 것

VideoScenevideoScene

컷이 바뀌어도 같은 공간을 유지하기 위한 배경 에셋 시트입니다.

VideoSceneFull필드 19개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
owner 소유자	LightUser!reference	property	—	—	—	배경의 소유자
project 프로젝트	LightVideoProject!reference	property	—	—	—	배경의 프로젝트
name 이름	String!	property	—	text:title	—	배경의 이름
description 설명	String	property		text:desc	—	배경의 설명
medium 매체	String	property	—	—	liveActionanimationillustrationthreeDmixed	시트를 그리는 매체입니다. 보드 슬롯에서 만든 시트는 그 보드의 매체를 따르고, 비면 실사입니다.
image 이미지	Filereference	property	—	—	—	배경 자체의 그림입니다. 있으면 그대로 쓰고 다시 그리지 않습니다.
refImages 참조 이미지	[File]!reference	property	[]	—	—	시트를 그릴 때 참고하는 그림입니다. 두 장까지입니다.
lastGenModel 마지막 생성 모델	String!	property	gemini-3.1-flash-image	—	gemini-3.1-flash-lite-imagegemini-3.1-flash-imagegpt-image-2seedream-5-0-260128seedream-5-0-lite-260128	배경의 다음 레퍼런스 이미지 생성에 사용할 이미지 생성 모델
assetKind 구분	String	property	—	—	originalclone	라이브러리의 원본인지, 보드에 할당할 때 만든 사본인지입니다. 비면 원본입니다.
copyOf 원본	ID	property	—	—	—	이 사본을 만든 원본 장소
lastGenImage 마지막 생성 이미지	GenImagereference	property	—	—	—	배경의 AI에 의해 생성된 이미지
genImages 생성된 이미지	[GenImage]reference	secretselect:false	[]	—	—	배경의 다양한 포즈와 표정을 담은 이미지들
refinedPrompt 정제된 프롬프트	String	property		—	—	정제기가 이 시트의 조립된 조각들을 대신해 쓴 영어 서술입니다
refinedPromptKey 정제 입력 지문	String	property		—	—	정제를 돌린 조각들의 지문입니다. 원본이 바뀌면 다시 정제합니다
favorite 즐겨찾기	Boolean!	property	false	—	—	라이브러리에서 별을 눌러 둔 배경입니다. 즐겨찾기만 보기에 남습니다.

VideoTakevideoTake

만든 영상 하나입니다. 만든 그 순간의 보드 기획·에셋·규격을 값으로 들고, 그 생성 결과를 가리킵니다.

VideoTakeFull필드 14개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
owner 소유자	ID!	propertyimmutable	—	—	—	이 영상을 만든 사람
project 프로젝트	ID	propertyimmutable	—	—	—	영상이 속한 프로젝트입니다. 레시피 화면에서 만든 영상은 비어 있습니다.
recipe 레시피	ID	propertyimmutable	—	—	—	레시피 화면에서 만든 영상이 따른 레시피입니다.
sourceBoard 보드	ID	propertyimmutable	—	—	—	이 영상을 만든 보드입니다. 가리키기만 하고, 보드를 고치거나 지워도 영상은 바뀌지 않습니다.
plan 기획	TakePlan!	propertyimmutable	—	—	—	영상을 만든 순간의 기획
cast 에셋	[TakeCast]!	propertyimmutable	[]	—	—	영상을 만든 순간의 보드 에셋입니다. 이름·서술·그림을 담습니다.
spec 규격	TakeSpec!	propertyimmutable	—	—	—	영상을 만든 비율·길이·오디오·스타일·레퍼런스·프레임·모델입니다.
genVideo 생성	GenVideoreference	property	—	—	—	벤더 작업과 그 결과 파일입니다. 진행·실패·크레딧 과금이 이 레코드에 있습니다.
refinedBeats 정제한 비트	[String]!	property	[]	—	—	영어 촬영 어휘로 다시 쓴 비트입니다. 컷 하나가 한 줄이고, 타임코드는 따로 붙습니다.
refinedPromptKey 정제 지문	String	property		—	—	위 비트를 만든 입력의 지문입니다. 바뀐 것이 없을 때만 재생성이 그 비트를 다시 씁니다.

Adminadmin

관리자는 시스템을 관리하는 사람으로, 데이터 관리 및 시스템 모니터링 권한을 가지고 있습니다.

AdminFull필드 8개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
accountId 아이디	String!	property	—	text:titlecustom validate	—	아이디 설명
password 패스워드	String	secretselect:false	—	minlength 8	—	패스워드 설명
roles 역할	[String]!	property	[]	text:filter	viewermanageradminsuperAdmin	역할 설명
lastLoginAt 마지막 로그인	Date!	property	[function]	—	—	마지막 로그인 설명

Filefile

파일은 이미지, 문서, 비디오 등과 같이 데이터베이스에 저장되는 blob 데이터입니다.

FileFull필드 15개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
filename 파일명	String!	property	—	text:title	—	확장자를 포함한 파일명
mimetype 파일타입	String!	property	—	—	—	파일의 Mime 타입
encoding 인코딩	String	hidden	—	—	—	파일의 인코딩
imageSize 이미지사이즈	[Int]!	property	[0,0]	—	—	이미지의 가로세로 픽셀 사이즈
url Url	String	property		—	—	파일의 Url
abstractData 요약 데이터	String	property	—	—	—	미리보기를 위한 이미지 파일의 추상화된 블러 처리된 인코딩 데이터
size 용량	Int!	property	0	—	—	파일의 바이트 단위 용량
origin 원본	String	hidden	—	—	—	파일의 원본 소스 url
lastModifiedAt 마지막 수정일	Date!	property	[function]	—	—	파일의 마지막 수정일
progress 진행률	Int	property	—	—	—	파일의 업로드 진행률, 업로드중인 파일만 사용됩니다
status 상태	String!	property	uploading	—	activeuploadingfailed	파일의 상태

AgentSessionagentSession

에이전틱 채팅 세션

AgentSessionFull필드 17개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
user 사용자	ID!	propertyimmutable	—	—	—	사용자 ID
title 제목	String	property		—	—	첫 프롬프트에서 만든 세션 제목
parent 부모	ID!	propertyimmutable	—	—	—	소속 문서
parentType 부모 유형	String!	propertyimmutable	—	—	—	소속 문서의 모델명
status 상태	String!	property	idle	—	idlethinkingawaitingeditingfailed	턴 진행 상태
contextSummary 컨텍스트 요약	String	property		—	—	에이전트 롱컨텍스트 기억으로 주입되는, 이전 턴들의 롤링 요약
summarizedSeq 요약 완료 seq	Int!	property	-1	—	—	요약에 이미 접힌 최대 sessionChat seq (−1 = 없음)
plan 작업 계획	[AgentPlanStep]!	property	[]	—	—	진행 중인 턴이 실행할 단계들, 순서대로
planTurn 플랜 턴	Int!	property	0	—	—	현재 플랜이 몇 번째 턴의 것인지 — 지나간 재개를 거르는 기준
pendingQuestion 대기 중인 질문	AgentQuestion	property	—	—	—	이 턴이 멈추고 물어본 질문 — 답하면 사라집니다
turnHeartbeatAt 턴 최종 신호 시각	Date	hidden	—	—	—	지금 턴을 돌리는 프로세스가 마지막으로 살아 있다고 알린 시각. 오래되면 턴이 그 프로세스와 함께 끊긴 것입니다
chatSeq 다음 메시지 순번	Int	hidden	—	—	—	다음 대화록 메시지가 받을 순번. 원자적으로 예약하므로 두 쓰기가 같은 순번을 받지 않습니다
lastSyncBatchId 마지막 저장 묶음	String	hidden	—	—	—	화면이 마지막으로 저장한 대화록 묶음. 다시 보낸 묶음이 한 번만 저장되게 합니다

GenImagegenImage

프롬프트로 이미지 생성 제공자를 통해 생성된 이미지입니다.

GenImageFull필드 19개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
prompt 프롬프트	String	secretselect:false	—	—	—	생성된 GenImage 레코드의 프롬프트
size 사이즈	String	property	—	—	—	프로바이더 원본 사이즈 문자열(1024x1024, 2K, ...), 변환 없이 그대로 전달됩니다. 테스트용 탈출구이며 평소에는 aspectRatio를 사용하세요
aspectRatio 화면 비율	String	property	—	—	1:13:44:39:1616:9	생성될 이미지의 화면 비율, 제공자별로 변환됩니다. size를 직접 지정하면 그쪽이 우선합니다
n 개수	Int!	property	1	—	—	genImage.n.desc
model 모델	String!	property	—	—	gemini-3.1-flash-lite-imagegemini-3.1-flash-imagegpt-image-2seedream-5-0-260128seedream-5-0-lite-260128	모델 재정의, 비어있으면 제공자의 기본값을 사용
refImages 참조 이미지	[File]reference	property	[]	—	—	생성 결과가 일관되도록 제공자에게 시각적 참조로 전달하는 이미지들
derivatives 파생 결과물	[String]	property	[]	—	thumb	생성된 이미지로부터 추가로 만들 결과물. 각각 별도의 생성 비용이 들기 때문에 쓰지 않으면 비워둡니다
images 이미지	[File]!reference	property	[]	—	—	생성된 GenImage 레코드의 이미지들
thumbs 썸네일	[File]!reference	property	[]	—	—	생성된 이미지를 정사각형으로 잘라낸 썸네일, 이미지 생성 직후에 만들어집니다
errMsg 오류	String	property	—	—	—	생성된 GenImage 레코드의 오류 메시지
status 상태	String!	property	pending	—	pendinggeneratingcompletedfailed	생성된 GenImage 레코드의 상태
heartbeatAt 최종 신호 시각	Date	hidden	—	—	—	이 생성을 물고 있는 프로세스가 마지막으로 살아 있다고 알린 시각. 오래되면 아무도 물고 있지 않다는 뜻입니다
attempts 시도 횟수	Int	hidden	0	—	—	지금까지 이 그림에 건 생성 요청 횟수. 재시작 때문에 다시 건 것까지 셉니다
derivedAt 파생물 완료 시각	Date	hidden	—	—	—	파생물 차례가 끝난 시각. 만들었거나, 만들 것이 없었거나, 그만두었을 때 찍힙니다. 비어 있으면 아직 빚지고 있다는 뜻입니다
derivativeAttempts 파생물 시도 횟수	Int	hidden	0	—	—	파생물 차례를 시작한 횟수. 그림 본체의 시도 횟수와 따로 셉니다

GenVideogenVideo

프롬프트로 영상 생성 모델을 통해 생성된 영상입니다.

GenVideoFull필드 25개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
prompt 프롬프트	String	secretselect:false	—	—	—	생성된 GenVideo 레코드의 프롬프트
negativePrompt 금지어	String	secretselect:false	—	—	—	벤더의 금지어 칸으로 보낸 낱말들입니다. 그 칸이 없는 모델에서는 비어 있고, 같은 목록이 프롬프트 안에 들어 있습니다.
imageUrl 이미지 Url	String	property	—	—	—	변환 없이 그대로 제공자에게 전달되는 소스 프레임 Url. 저장하지 않은 프레임을 위한 탈출구이며 평소에는 refImages를 사용하세요
aspectRatio 화면 비율	String	property	—	—	9:1616:91:14:5	생성될 영상의 화면 비율, 제공자별로 변환됩니다. 해당 비율을 지원하지 않는 제공자는 자체 기본값을 사용합니다
resolution 해상도	String	property	—	—	480p720p1080p	출력 해상도 등급으로, 제공자별로 변환됩니다. 모델이 못 내는 등급은 빠지고 제공자 기본값으로 만듭니다
durationSeconds 길이 (초)	Int	property	—	—	—	요청한 영상 길이, 제공자가 허용하는 가장 가까운 길이로 맞춰집니다
seed 시드	Int	property	—	—	—	벤더가 노이즈를 굴리는 시작값으로, 같은 요청이 같은 영상을 돌려주게 합니다. 칸을 가진 모델에만 전달되며, 비어 있으면 벤더가 직접 굴립니다
guidance 가이던스	Float	property	—	—	—	벤더가 프롬프트를 얼마나 세게 붙드는지(CFG)입니다. 벤더 고유의 눈금이며 해당 모델이 공개한 범위로 잘립니다
audio 오디오	Boolean	property	—	—	—	벤더에게 소리를 만들라고 했는지. 비어 있으면 벤더 기본값이고, 그것은 켜짐입니다.
model 모델	String!	property	—	—	dreamina-seedance-2-5-260628dreamina-seedance-2-0-260128dreamina-seedance-2-0-fast-260128dreamina-seedance-2-0-mini-260615kling-v3kling-v3-omniveo-3.1-generate-previewveo-3.1-fast-generate-previewveo-3.1-lite-generate-previewMiniMax-H3MiniMax-H3-Maxwan3.0-videowan2.7-videoedit	사용할 영상 생성 모델
refImages 프레임	[File]reference	property	[]	—	—	첫 프레임과, 둘째 자리의 마지막 프레임입니다. 여기서는 자리가 곧 뜻입니다
assetImages 자산 참조	[File]reference	property	[]	—	—	클립이 흐르는 동안 정체성을 지키는, 못박히지 않는 참조 그림들입니다
sourceVideo 원본 영상	Filereference	property	—	—	—	이 생성이 편집하는 영상입니다. 공개 URL 로 보내므로, 공개 URL 이 없는 파일은 나가지 않습니다
keepSourceAudio 원본 소리 유지	Boolean	property	—	—	—	편집 결과가 새 소리 대신 원본 소리를 남기는지입니다. 고를 수 있는 모델만 읽습니다
video 영상	Filereference	property	—	—	—	생성된 GenVideo 레코드의 영상
resultModel 결과 모델	String	property	—	—	—	제공자가 반환한 실제 모델 이름
errMsg 오류	String	property	—	—	—	생성된 GenVideo 레코드의 오류 메시지
status 상태	String!	property	pending	—	pendinggeneratingcompletedfailed	생성된 GenVideo 레코드의 상태
providerTask 제공자 작업	Any	hidden	—	—	—	제공자에 제출된 작업의 손잡이. 재시작으로 끊긴 생성을 다시 이어받는 유일한 근거입니다
startedAt 제출 시각	Date	hidden	—	—	—	작업이 제공자에 제출된 시각. 대기 예산을 여기서부터 셉니다
heartbeatAt 최종 신호 시각	Date	hidden	—	—	—	이 생성을 물고 있는 프로세스가 마지막으로 살아 있다고 알린 시각. 오래되면 아무도 물고 있지 않다는 뜻입니다

SessionChatsessionChat

에이전트 세션 채팅 메시지

SessionChatFull필드 10개

필드	타입	종류	기본값	제약 조건	값	설명
id 아이디	ID!	property	—	—	—	유니크한 아이디값
createdAt 생성일	Date!	property	—	—	—	데이터 생성 시각
updatedAt 수정일	Date!	property	—	—	—	데이터 마지막 수정 시각
removedAt 삭제일	Date	property	—	—	—	데이터 삭제 시각
agentSession 세션	ID!	property	—	—	—	소속 에이전트 세션
role 역할	String!	property	user	—	userassistant	메시지 작성자 역할
content 내용	String	property		—	—	메시지 텍스트 (어시스턴트 = 마크다운)
parts 파트	[AgentChatPart]!	property	[]	—	—	텍스트·툴 파트의 순서화된 타임라인 (어시스턴트 턴)
files 첨부	[File]!reference	property	[]	—	—	이 메시지에 사람이 건넨 그림
seq 순번	Int!	property	0	—	—	세션 내 정렬 순번

scalar 모델

BoardPinFaceboardPinFace

핀이 가리키는 자산에서 읽어 온 이름과 썸네일입니다.

필드	타입	종류	기본값	제약 조건	값	설명
name 이름	String	property	—	—	—	핀이 가리키는 자산의 이름
img 그림	String	property	—	—	—	캔버스 카드에 보이는 썸네일
media 매체	String!	property	photo	—	photovideoaudio	캔버스가 자산을 그리는 방식
pending 생성 중	Boolean!	property	false	—	—	그림을 아직 뽑는 중인지
failed 생성 실패	Boolean	property	—	—	—	그림 생성이 실패해 보일 그림이 없는지
drawn AI 생성	Boolean	property	—	—	—	자산이 가진 사진이 아니라 AI가 그린 시트인지
fileId 파일 ID	String	property	—	—	—	캔버스 카드가 그림을 보일 때 그 파일의 ID
detail 설명	String	property	—	—	—	보드 에셋이 무엇인지 적은 말입니다. 설명과 성별·제품 종류입니다.

CutFramecutFrame

기획안의 한 비트입니다 — 무엇이 일어나고 어떻게 찍히는지입니다. 비트마다 영상 길이를 똑같이 나눠 받습니다.

필드	타입	종류	기본값	제약 조건	값	설명
body 내용	String	property		—	—	이 비트에서 무엇이 일어나는지입니다. 자산은 @슬롯 으로 적고, 그 슬롯을 시트에 묶으면 생김새가 실립니다.
framing 구도	String	property	—	—	widefullmediumcloseUpextremeCloseUpinsert	화면이 대상을 얼마나 담는지
angle 앵글	String	property	—	—	eyeLevellowhightopDowndutchpov	카메라가 어디서 보는지
lens 렌즈	String	property	—	—	wideAnglestandardtelephotomacroanamorphicshallowDepthdeepFocus	렌즈의 성격입니다. 실사와 3D 에서만 뜻이 있습니다.
camera 카메라	String	property	—	—	staticpantiltpushInpullOuttrackcraneorbithandheldzoom	이 비트에서 카메라가 어떻게 움직이는지
light 조명	String	property	—	—	naturalsofthardbacklitlowKeyhighKeyflatpracticalgoldenHourneon	화면이 어떻게 밝혀지는지
color 색	String	property	—	—	naturalwarmcoolpastelvividmonochromehighContrast	이 비트의 색 처리
speed 속도	String	property	—	—	realtimeslowMotiontimeLapserampUprampDownhold	이 비트에서 시간이 어떻게 흐르는지
sound 사운드	String	property		—	—	이 비트에서 들리는 것을 말로 적습니다 — 냉장고 문 여는 소리, 멀리서 나는 사이렌.

CutSlotcutSlot

컷 본문이 중괄호로 적는 이름과, 그 이름이 가리키는 자산 시트입니다.

필드	타입	종류	기본값	제약 조건	값	설명
name 슬롯	String!	property	—	—	—	컷 본문에 @이름 으로 적히는 이름입니다. 이름의 주인은 본문이라 여기서 바꿔도 소용없습니다.
parentType 자산 종류	String	property	—	—	videoCharactervideoScenevideoObj	이 슬롯이 어떤 종류의 시트에 묶였는지
parent 자산	ID	property	—	—	—	이 슬롯이 가리키는 시트입니다. 묶기 전까지는 비어 있습니다.

GenPromptPartgenPromptPart

생성 프롬프트를 이루는 한 조각입니다.

필드	타입	종류	기본값	제약 조건	값	설명
source 출처	String!	property	rule	—	settingprojectflowcutshotassetrulerefined	이 조각이 나온 자리입니다.
settingPath 설정 경로	String	property		—	—	이 조각을 내는 설정 필드입니다. 코드가 낸 문장은 비어 있습니다.
label 라벨	String	property		—	—	조각의 이름입니다.
text 본문	String	property		—	—	프롬프트에 합쳐지는 본문입니다.

GenPromptPreviewgenPromptPreview

조립이 끝난 생성 프롬프트와 그것을 이룬 조각들입니다.

필드	타입	종류	기본값	제약 조건	값	설명
kind 종류	String!	property	image	—	imagevideo	이미지인지 영상인지입니다.
prompt 프롬프트	String	property		—	—	제공자에게 실제로 나가는 문자열입니다.
parts 조각	[GenPromptPart]!	property	[]	—	—	프롬프트를 이룬 조각들입니다.
model 모델	String	property		—	—	이 프롬프트가 돌 생성 모델입니다.
refImages 참조 이미지	[File]!reference	property	[]	—	—	프롬프트와 함께 붙는 그림입니다.
warnings 경고	[String]!	property	[]	—	—	진짜 생성이었다면 막혔을 사정입니다.

InspectBeatinspectBeat

레퍼런스 영상의 구조 단계 하나로, 컷 경계에 맞춰 있습니다.

필드	타입	종류	기본값	제약 조건	값	설명
role 역할	String!	property	other	—	hookproblemsetuprevealdemoproofpayofftwistctaloopother	단계의 역할
label 이름	String	property		—	—	단계 이름
start 시작	Float!	property	0	—	—	단계가 시작하는 초
end 끝	Float!	property	0	—	—	단계가 끝나는 초
purpose 목적	String	property		—	—	단계가 시청자에게 하는 일

InspectLineinspectLine

레퍼런스 영상의 시각이 붙은 한 줄 — 대사, 화면 자막, 효과음입니다.

필드	타입	종류	기본값	제약 조건	값	설명
kind 종류	String!	property	speech	—	speechcaptionsfx	대사·자막·효과음
start 시작	Float!	property	0	—	—	줄이 시작하는 초
end 끝	Float!	property	0	—	—	줄이 끝나는 초
speaker 화자	String	property		—	—	대사의 화자
text 내용	String	property		—	—	원문 그대로의 내용

InspectRoleinspectRole

따라 만들 때 자기 자산으로 바꿔 끼우는 레퍼런스 영상의 역할입니다.

필드	타입	종류	기본값	제약 조건	값	설명
name 슬롯	String	property		—	—	초안 비트가 @이름 으로 적는 이름
type 자산 종류	String!	property	videoCharacter	—	videoCharactervideoScenevideoObj	어떤 종류의 자산이 맡는지
description 설명	String	property		—	—	원본이 이 역할에 세운 것

InspectShotinspectShot

레퍼런스 영상의 컷 하나 — 시각, 보이는 것, 찍은 방식입니다.

필드	타입	종류	기본값	제약 조건	값	설명
start 시작	Float!	property	0	—	—	컷이 시작하는 초
end 끝	Float!	property	0	—	—	컷이 끝나는 초
thumb 썸네일	ID	property	—	—	—	컷 가운데 프레임
transition 전환	String	property	—	—	cutjumpCutmatchwhipzoomdissolvefadegraphic	이 컷으로 들어오는 전환
subject 피사체	String	property		—	—	컷의 주인공
action 행동	String	property		—	—	컷에서 일어나는 일
place 장소	String	property		—	—	컷의 장소
framing 구도	String	property	—	—	widefullmediumcloseUpextremeCloseUpinsert	샷 크기
angle 앵글	String	property	—	—	eyeLevellowhightopDowndutchpov	카메라 앵글
lens 렌즈	String	property	—	—	wideAnglestandardtelephotomacroanamorphicshallowDepthdeepFocus	렌즈 느낌
camera 카메라 무빙	String	property	—	—	staticpantiltpushInpullOuttrackcraneorbithandheldzoom	카메라가 움직이는 방식
light 조명	String	property	—	—	naturalsofthardbacklitlowKeyhighKeyflatpracticalgoldenHourneon	조명
color 색감	String	property	—	—	naturalwarmcoolpastelvividmonochromehighContrast	색 보정
speed 속도	String	property	—	—	realtimeslowMotiontimeLapserampUprampDownhold	재생 속도
onScreenText 화면 글자	String	property		—	—	자막과 슈퍼, 원문 그대로
suspect 의심 컷	Boolean!	property	false	—	—	분석기가 이 컷 앞의 경계를 진짜 컷이 아니라고 본 표시
role 자산 역할	String	property	—	—	videoCharactervideoScenevideoObj	이 컷을 끌고 가는 자산의 종류
slot 슬롯	String	property		—	—	그 자산을 바꿔 끼울 역할 이름
body 비트 본문	String	property		—	—	원본의 고유한 것을 @슬롯 으로 바꿔 다시 쓴 문장

InspectSourceinspectSource

분석 전에 읽은 레퍼런스 영상 자체의 사실입니다.

필드	타입	종류	기본값	제약 조건	값	설명
title 제목	String	property		—	—	원본의 제목
author 작성자	String	property		—	—	올린 채널이나 계정
authorUrl 작성자 링크	String	property		—	—	작성자의 링크
thumbnailUrl 썸네일	String	property		—	—	플랫폼이 보여주는 썸네일
seconds 길이	Float!	property	0	—	—	원본 길이(초)
analyzedSeconds 분석한 길이	Float!	property	0	—	—	처음부터 읽고 과금한 초
width 가로	Int!	property	0	—	—	프레임 가로 픽셀
height 세로	Int!	property	0	—	—	프레임 세로 픽셀
aspectRatio 화면 비율	String	property	—	—	9:1616:91:14:5	생성이 받을 수 있는 가장 가까운 비율
hasAudio 소리 있음	Boolean!	property	false	—	—	원본에 소리가 있는지

MediaStylemediaStyle

MediaStyle 설명

필드	타입	종류	기본값	제약 조건	값	설명
medium 매체	String	property	liveAction	—	liveActionanimationillustrationthreeDmixed	매체 설명
moods 분위기	[String]!	property	[]	—	friendlyenergeticplayfultrustworthysophisticatedemotionalintense	분위기 설명
colorTone 색감	String	property	natural	—	naturalwarmcoolpastelvividmonochromehighContrast	색감 설명
keywords 키워드	[String]!	property	[]	—	—	키워드 설명

PlanRoleplanRole

기획에 필요한 에셋 하나입니다. 컷 본문의 @슬롯, 그 슬롯을 맡을 에셋 종류, 만드는 방법을 담습니다.

필드	타입	종류	기본값	제약 조건	값	설명
name 슬롯	String	property		—	—	컷 본문이 적는 @슬롯 이름입니다. 본문과 글자 하나까지 같아야 합니다.
type 에셋 종류	String!	property	videoCharacter	—	videoCharactervideoScenevideoObj	사람이나 손·몸의 일부는 인물, 장소는 장소, 제품이나 소품은 사물입니다.
description 설명	String	property		—	—	에셋이 어떻게 생겼는지입니다. 시트를 이 설명으로 그립니다.
gender 성별	String	property	—	—	malefemaleother	인물에만 적습니다.
productType 제품 종류	String	property	—	—	—	사물에만 적습니다. 어떤 제품인지입니다(예: 립밤).
needsPhoto 실제 제품	Boolean!	property	false	—	—	영상에 실물 그대로 나와야 하는 사물이라 사진을 올려야 합니다.
photo 사진	Filereference	property	—	—	—	올린 사진입니다. 사진이 있는 사물은 그 사진이 곧 에셋이 되고 따로 그리지 않습니다.

RefAssetrefAsset

보드에 할당할 때 복사해 둔 자산입니다. 원본을 나중에 고쳐도 이 사본은 그대로입니다.

필드	타입	종류	기본값	제약 조건	값	설명
type 종류	String	property	—	—	videoCharactervideoScenevideoObjcreative	사본이 어떤 종류의 자산인지입니다. 비면 보드에 바로 올린 파일입니다.
relation 관계	String	property	—	—	—	기획안에서 이 자산이 맡는 @슬롯 이름입니다(예: 인물1). 비우면 참고 그림으로만 실립니다.
asset 자산 사본	ID	property	—	—	—	보드에 할당할 때 만든 자산 사본입니다.
file 파일	LightFilereference	property	—	—	—	보드에 바로 올린 파일

RemakeSwapremakeSwap

원본 영상 속 하나와 그것이 바뀔 그림입니다.

필드	타입	종류	기본값	제약 조건	값	설명
target 바꿀 대상	String	property		—	—	원본 영상에서 바뀌는 것을 모델이 찾을 수 있게 적습니다 — 빨간 코트를 입은 여자, 책상 위 병
image 바꿀 그림	Filereference	property	—	—	—	바뀔 모습의 그림입니다. 없으면 이 행은 바꿀 내용을 말로만 전합니다

TakeCasttakeCast

영상을 만든 그 순간의 보드 에셋 하나입니다. 이름·서술·그림을 값으로 담습니다.

필드	타입	종류	기본값	제약 조건	값	설명
type 종류	String	property	—	—	videoCharactervideoScenevideoObjcreative	어떤 종류의 에셋이었는지입니다. 비면 보드에 바로 올린 파일입니다.
relation 관계	String	property	—	—	—	맡은 @슬롯입니다. 비면 참고 그림으로만 실렸습니다.
name 이름	String	property		—	—	에셋의 이름입니다.
description 서술	String	property		—	—	에셋의 모습을 적은 서술입니다.
gender 성별	String	property	—	—	malefemaleother	인물에만 있습니다.
productType 제품 종류	String	property	—	—	—	사물에만 있습니다.
picture 그림	Filereference	property	—	—	—	영상에 실린 그림입니다. 그때 그림이 없었으면 비어 있습니다.

TakePlantakePlan

영상을 만든 그 순간의 기획입니다.

필드	타입	종류	기본값	제약 조건	값	설명
phrase 캐치프레이즈	String	property		—	—	기획의 캐치프레이즈입니다.
summary 스토리	String	property		—	—	기획의 스토리입니다.
cutFrames 컷	[CutFrame]!	property	[]	—	—	순서대로 놓인 비트입니다.
roles 등장 에셋	[PlanRole]!	property	[]	—	—	기획이 정한 등장 에셋입니다.
projectBrief 프로젝트 소개	String	property	—	—	—	그 순간의 프로젝트 제목과 설명입니다.

TakeSpectakeSpec

영상을 만든 그 순간의 보드 규격과 모양입니다.

필드	타입	종류	기본값	제약 조건	값	설명
aspectRatio 비율	String!	property	9:16	—	9:1616:91:14:5	영상의 비율입니다.
durationSeconds 길이	Int!	property	15	—	—	영상의 길이(초)입니다.
audio 오디오	Boolean!	property	false	—	—	영상과 함께 소리를 만들었는지입니다.
bgm BGM	Boolean!	property	false	—	—	소리에 배경 음악을 넣었는지입니다.
narration 나레이션	Boolean!	property	false	—	—	소리에 나레이션을 넣었는지입니다.
soundEffect 효과음	Boolean!	property	false	—	—	소리에 효과음을 넣었는지입니다.
mediaStyle 모양	MediaStyle	property	—	—	—	매체·분위기·색감입니다.
videoStyle 영상 스타일	VideoStyle	property	—	—	—	속도와 참고 문장입니다.
refImages 레퍼런스	[File]!reference	property	[]	—	—	영상에 실린 보드의 레퍼런스 그림입니다.
startFrame 시작 프레임	Filereference	property	—	—	—	못박은 여는 그림입니다.
endFrame 마지막 프레임	Filereference	property	—	—	—	못박은 닫는 그림입니다.
videoGenModel 고정 모델	String	property	—	—	dreamina-seedance-2-5-260628dreamina-seedance-2-0-260128dreamina-seedance-2-0-fast-260128dreamina-seedance-2-0-mini-260615kling-v3kling-v3-omniveo-3.1-generate-previewveo-3.1-fast-generate-previewveo-3.1-lite-generate-previewMiniMax-H3MiniMax-H3-Maxwan3.0-videowan2.7-videoedit	보드가 고정한 영상 모델입니다. 비면 규격이 고릅니다.
resolution 해상도	String	property	—	—	480p720p1080p	요청한 해상도입니다. 비면 모델의 평소 등급으로 만들었고 720p 값으로 매겼습니다.
model 생성 모델	String	property	—	—	dreamina-seedance-2-5-260628dreamina-seedance-2-0-260128dreamina-seedance-2-0-fast-260128dreamina-seedance-2-0-mini-260615kling-v3kling-v3-omniveo-3.1-generate-previewveo-3.1-fast-generate-previewveo-3.1-lite-generate-previewMiniMax-H3MiniMax-H3-Maxwan3.0-videowan2.7-videoedit	이 영상을 만든 모델입니다.

VideoRecipeBriefvideoRecipeBrief

레시피 화면에서 사람이 답한 값입니다. 프로젝트에 그대로 실립니다.

필드	타입	종류	기본값	제약 조건	값	설명
category 업종	String	property	—	—	beautyProductrestaurantCafeclinicspaceRealEstateacademyFitness	이 영상이 속한 업종
topic 주제	String	property	—	—	tastecraftspacesignatureevent	영상이 다루는 주제
brandName 브랜드·매장명	String	property		—	—	카피가 데려갈 이름. 화면 글자로 그리지는 않습니다.
firstCopy 첫 장면 문구	String	property		—	—	첫 비트의 바탕이 되는 문구
lastCopy 마지막 문구	String	property		—	—	마지막 비트의 바탕이 되는 문구
mood 원하는 분위기	String	property		—	—	사람이 자기 말로 적은 분위기

VideoStylevideoStyle

스토리·에셋·프로젝트가 공통으로 쓰는 컨셉·톤 어휘입니다.

필드	타입	종류	기본값	제약 조건	값	설명
pace 템포	String	property	—	—	slownormalfast	videoStyle.pace.desc
referencePrompt 레퍼런스 프롬프트	String	property		—	—	생성 시 주입되는 영문 스타일 프롬프트

MemoStylememoStyle

캔버스 텍스트 블록을 그리는 방식입니다. 크기·색·굵기·기울임을 담습니다.

필드	타입	종류	기본값	제약 조건	값	설명
size 텍스트 크기	String!	property	small	—	smallmediumlarge	글자 크기입니다. 작게 16px, 보통 24px, 크게 40px.
color 텍스트 색상	String!	property	label	—	labelredorangeyellowgreenbluevioletpink	글자 색입니다. label 은 테마를 따르는 기본 글자색입니다.
bold 볼드	Boolean!	property	false	—	—	글자를 굵게 쓰는지
italic 이탤릭	Boolean!	property	false	—	—	글자를 기울여 쓰는지

NotiInfonotiInfo

알림 정보

필드	타입	종류	기본값	제약 조건	값	설명
setting 설정	String!	property	normal	—	disagreefewernormalblock	설정
pauseUntil 일시 중지	Date!	property	[function]	—	—	일시 중지
deviceTokens 디바이스 토큰	[DeviceToken]!	property	[]	—	—	디바이스 토큰

EncourageInfoencourageInfo

격려 정보

필드	타입	종류	기본값	제약 조건	값	설명
journey 여정	String!	property	welcome	—	welcomewaitingfirstJoinjoinedleavingleavedreturningreturned	여정
journeyAt 여정 일시	Date!	property	[function]	—	—	여정 일시
inquiry 획득	String!	property	welcome	—	welcomepayablewaitPaypaidmorePayablewaitMorePayinquiredconcernedconcernedPayableconcernedWaitPayashedvipkicked	획득
inquiryAt 획득 일시	Date!	property	[function]	—	—	획득 일시

RestrictInforestrictInfo

제한 정보

필드	타입	종류	기본값	제약 조건	값	설명
until 일시	Date!	property	—	—	—	일시
reason 사유	String!	property	—	—	—	사유

LeaveInfoleaveInfo

탈퇴 정보

필드	타입	종류	기본값	제약 조건	값	설명
type 타입	String!	property	noReply	—	noReplycomebackunsatisfiedother	타입
reason 사유	String	property	—	—	—	사유
satisfaction 만족도	Int	property	—	min 1max 5	—	만족도
voc VOC	String	property	—	—	—	VOC
at 일시	Date!	property	[function]	—	—	일시

AgentPlanStepagentPlanStep

한 턴이 하려는 작업의 한 단계

필드	타입	종류	기본값	제약 조건	값	설명
stepId 단계 ID	String!	property	—	—	—	이 단계의 스트림 프레임 업서트 키
order 순서	Int!	property	0	—	—	플랜 내 실행 순서
kind 종류	String!	property	—	—	—	호스트가 정의한 단계 종류
title 제목	String	property		—	—	타임라인에 보여줄 사람 말
input 입력	Any	property	—	—	—	이 단계의 호스트 페이로드
status 상태	String!	property	pending	—	pendingrunningdonefailedskipped	단계 진행 상태
summary 요약	String	property	—	—	—	단계 결과 한 줄
errMsg 오류	String	property	—	—	—	단계가 실패한 이유

AgentQuestionagentQuestion

에이전트가 턴을 멈추고 물어본 질문과 받은 답

필드	타입	종류	기본값	제약 조건	값	설명
questionId 질문 ID	String!	property	—	—	—	지나간 질문이나 중복 답변을 거를 수 있게 하는 식별자
header 머리말	String	property		—	—	짧은 칩 라벨
question 질문	String	property		—	—	사용자에게 보여줄 질문
options 선택지	[AgentQuestionOption]!	property	[]	—	—	선택 가능한 답
multiSelect 다중 선택	Boolean!	property	false	—	—	선택지를 여러 개 고를 수 있음
freeText 직접 입력	Boolean!	property	true	—	—	직접 입력한 답을 허용
answerKeys 선택된 키	[String]!	property	[]	—	—	선택된 선택지의 키
answerText 입력한 답	String	property	—	—	—	직접 입력한 답이 있는 경우

AgentChatPartagentChatPart

어시스턴트 턴의 순서화된 한 조각

필드	타입	종류	기본값	제약 조건	값	설명
type 유형	String!	property	text	—	texttoolquestionstep	이 파트가 담은 페이로드 종류
text 텍스트	String	property	—	—	—	마크다운 텍스트 조각
tool 툴	AgentToolEvent	property	—	—	—	이 시점의 툴 호출
question 질문	AgentQuestion	property	—	—	—	이 시점에 물어본 질문과 그 답
step 단계	AgentPlanStep	property	—	—	—	이 시점에 완료된 작업 단계

DeviceTokendeviceToken

기기의 푸시 수신 주소

필드	타입	종류	기본값	제약 조건	값	설명
token 토큰	String!	property	—	—	—	APNs 기기 토큰 또는 FCM 등록 토큰
provider 발송 경로	String!	property	fcm	—	apnsfcm	푸시가 거쳐 가는 서비스
platform 플랫폼	String!	property	web	—	iosandroidweb	기기의 플랫폼
deviceId 기기 ID	String	property	—	—	—	토큰이 속한 설치본
updatedAt 수정일	Date!	property	[function]	—	—	데이터 마지막 수정 시각

AgentQuestionOptionagentQuestionOption

에이전트 질문의 선택 가능한 답 하나

필드	타입	종류	기본값	제약 조건	값	설명
key 키	String!	property	—	—	—	클라이언트가 되돌려 보내는 안정적 id
label 라벨	String	property		—	—	선택지에 표시되는 문구
detail 설명	String	property	—	—	—	선택 사항인 한 줄 부연
recommended 추천	Boolean!	property	false	—	—	고민 없이 넘어갈 수 있는 기본 선택지

AgentToolEventagentToolEvent

코딩 에이전트 툴 이벤트

필드	타입	종류	기본값	제약 조건	값	설명
op 동작	String!	property	unknown	—	—	파일 동작
phase 단계	String!	property	start	—	startresult	툴 실행 단계
toolName 툴 이름	String!	property	—	—	—	툴 이름
toolCallId 툴 호출 ID	String!	property	—	—	—	툴 호출 ID
path 경로	String	property	—	—	—	영향받은 파일 경로
isError 오류 여부	Boolean	property	—	—	—	툴 호출 실패 여부
summary 요약	String	property	—	—	—	결과 요약

enum

enum	타입	값	사용처
adminRole adminRole	String	viewermanageradminsuperAdmin	admin.rolesadmin.rolesadmin.roles
agentChatPartType agentChatPartType	String	texttoolquestionstep	agentChatPart.type
agentPlanStepStatus agentPlanStepStatus	String	pendingrunningdonefailedskipped	agentPlanStep.status
agentSessionStatus agentSessionStatus	String	idlethinkingawaitingeditingfailed	agentSession.statusagentSession.statusagentSession.status
agentToolPhase agentToolPhase	String	startresult	agentToolEvent.phase
assetKind assetKind	String	originalclone	creative.assetKindcreative.assetKindvideoCharacter.assetKindvideoCharacter.assetKindvideoObj.assetKindvideoObj.assetKindvideoPlan.assetKindvideoPlan.assetKindvideoScene.assetKindvideoScene.assetKind
boardPinMedia boardPinMedia	String	photovideoaudio	boardPinFace.media
boardPinType boardPinType	String	videoCharactervideoScenevideoObjcreativefilevideoBoardgenImagevideoPlanvideoTake	boardPin.targetTypeboardPin.targetTypeboardPin.targetTypeboardPin.targetType
characterGender characterGender	String	malefemaleother	videoCharacter.gendervideoCharacter.gendervideoCharacter.gendervideoCharacter.genderplanRole.gendertakeCast.gender
colorTone colorTone	String	naturalwarmcoolpastelvividmonochromehighContrast	cutFrame.colorinspectShot.colormediaStyle.colorTone
creativeType creativeType	String	photovideoaudio	creative.typecreative.typecreative.type
creditLogStatus creditLogStatus	String	pendingsettledrefunded	creditLog.statuscreditLog.statuscreditLog.status
creditLogType creditLogType	String	grantdeductuserefund	creditLog.typecreditLog.typecreditLog.typecreditLog.type
cutAngle cutAngle	String	eyeLevellowhightopDowndutchpov	cutFrame.angleinspectShot.angle
cutAssetType cutAssetType	String	videoCharactervideoScenevideoObj	cutSlot.parentTypeinspectRole.typeinspectShot.roleplanRole.type
cutCameraMove cutCameraMove	String	staticpantiltpushInpullOuttrackcraneorbithandheldzoom	cutFrame.camerainspectShot.camera
cutFraming cutFraming	String	widefullmediumcloseUpextremeCloseUpinsert	cutFrame.framinginspectShot.framing
cutLens cutLens	String	wideAnglestandardtelephotomacroanamorphicshallowDepthdeepFocus	cutFrame.lensinspectShot.lens
cutLight cutLight	String	naturalsofthardbacklitlowKeyhighKeyflatpracticalgoldenHourneon	cutFrame.lightinspectShot.light
cutSpeed cutSpeed	String	realtimeslowMotiontimeLapserampUprampDownhold	cutFrame.speedinspectShot.speed
devicePlatform devicePlatform	String	iosandroidweb	deviceToken.platform
fileStatus fileStatus	String	activeuploadingfailed	file.statusfile.statusfile.status
genImageDerivative genImageDerivative	String	thumb	genImage.derivativesgenImage.derivativesgenImage.derivatives
genImageStatus genImageStatus	String	pendinggeneratingcompletedfailed	genImage.statusgenImage.statusgenImage.status
genPromptKind genPromptKind	String	imagevideo	genPromptPreview.kind
genPromptSource genPromptSource	String	settingprojectflowcutshotassetrulerefined	genPromptPart.source
genVideoStatus genVideoStatus	String	pendinggeneratingcompletedfailed	genVideo.statusgenVideo.statusgenVideo.status
imageAspectRatio imageAspectRatio	String	1:13:44:39:1616:9	genImage.aspectRatiogenImage.aspectRatiogenImage.aspectRatio
imageGenModel imageGenModel	String	gemini-3.1-flash-lite-imagegemini-3.1-flash-imagegpt-image-2seedream-5-0-260128seedream-5-0-lite-260128	videoBoard.refGenModelvideoBoard.refGenModelvideoCharacter.lastGenModelvideoCharacter.lastGenModelvideoCharacter.lastGenModelvideoCharacter.lastGenModelvideoObj.lastGenModelvideoObj.lastGenModelvideoObj.lastGenModelvideoObj.lastGenModelvideoScene.lastGenModelvideoScene.lastGenModelvideoScene.lastGenModelvideoScene.lastGenModelgenImage.modelgenImage.modelgenImage.modelgenImage.model
inquiry inquiry	String	welcomepayablewaitPaypaidmorePayablewaitMorePayinquiredconcernedconcernedPayableconcernedWaitPayashedvipkicked	encourageInfo.inquiry
inspectBeatRole inspectBeatRole	String	hookproblemsetuprevealdemoproofpayofftwistctaloopother	inspectBeat.role
inspectCutSource inspectCutSource	String	detectormodel	videoInspect.cutSourcevideoInspect.cutSourcevideoInspect.cutSource
inspectFormat inspectFormat	String	talkingHeadpovtutorialbeforeAfterunboxingproductDemoskitmontageasmrlisticletestimonialtrendvlogother	videoInspect.formatvideoInspect.formatvideoInspect.format
inspectLineKind inspectLineKind	String	speechcaptionsfx	inspectLine.kind
inspectPlatform inspectPlatform	String	youtubeinstagramtiktokxupload	videoInspect.platformvideoInspect.platformvideoInspect.platform
inspectTransition inspectTransition	String	cutjumpCutmatchwhipzoomdissolvefadegraphic	inspectShot.transition
journey journey	String	welcomewaitingfirstJoinjoinedleavingleavedreturningreturned	encourageInfo.journey
leaveType leaveType	String	noReplycomebackunsatisfiedother	leaveInfo.type
medium medium	String	liveActionanimationillustrationthreeDmixed	videoCharacter.mediumvideoCharacter.mediumvideoCharacter.mediumvideoObj.mediumvideoObj.mediumvideoObj.mediumvideoScene.mediumvideoScene.mediumvideoScene.mediummediaStyle.medium
memoColor memoColor	String	labelredorangeyellowgreenbluevioletpink	memoStyle.color
memoSize memoSize	String	smallmediumlarge	memoStyle.size
mood mood	String	friendlyenergeticplayfultrustworthysophisticatedemotionalintense	mediaStyle.moods
notiSetting notiSetting	String	disagreefewernormalblock	notiInfo.setting
periodType periodType	String	non-periodicactivehourlydailyweeklymonthly	summary.typesummary.typesummary.type
profileStatus profileStatus	String	activeprepareappliedapprovedreappliedfeaturedreservedrejected	user.profileStatususer.profileStatususer.profileStatus
pushProvider pushProvider	String	apnsfcm	deviceToken.provider
refAssetType refAssetType	String	videoCharactervideoScenevideoObjcreative	refAsset.typetakeCast.type
sessionChatRole sessionChatRole	String	userassistant	sessionChat.rolesessionChat.rolesessionChat.rolesessionChat.role
sourceVideoGenModel sourceVideoGenModel	String	MiniMax-H3wan2.7-videoedit	videoRemake.videoGenModelvideoRemake.videoGenModelvideoRemake.videoGenModelvideoRemake.videoGenModel
summaryStatus summaryStatus	String	activearchived	summary.statussummary.status
userRole userRole	String	rootadminuserbusinessguest	user.rolesuser.rolesuser.roles
userStatus userStatus	String	prepareactivedormantrestricted	user.statususer.statususer.status
verify verify	String	naverkakaogithubgoogleapplefacebookwalletpasswordphoneemail	user.verifiesuser.verifies
videoAspectRatio videoAspectRatio	String	9:1616:91:14:5	videoBoard.aspectRatiovideoBoard.aspectRatiovideoBoard.aspectRatiovideoBoard.aspectRatiogenVideo.aspectRatiogenVideo.aspectRatiogenVideo.aspectRatioinspectSource.aspectRatiotakeSpec.aspectRatio
videoGenModel videoGenModel	String	dreamina-seedance-2-5-260628dreamina-seedance-2-0-260128dreamina-seedance-2-0-fast-260128dreamina-seedance-2-0-mini-260615kling-v3kling-v3-omniveo-3.1-generate-previewveo-3.1-fast-generate-previewveo-3.1-lite-generate-previewMiniMax-H3MiniMax-H3-Maxwan3.0-videowan2.7-videoedit	videoBoard.videoGenModelvideoBoard.videoGenModelvideoBoard.videoGenModelvideoBoard.videoGenModelgenVideo.modelgenVideo.modelgenVideo.modelgenVideo.modeltakeSpec.videoGenModeltakeSpec.model
videoInspectStatus videoInspectStatus	String	pendingfetchinganalyzingcomposingcompletedfailed	videoInspect.statusvideoInspect.statusvideoInspect.status
videoPace videoPace	String	slownormalfast	videoStyle.pace
videoRecipeCategory videoRecipeCategory	String	beautyProductrestaurantCafeclinicspaceRealEstateacademyFitness	videoRecipe.categoryvideoRecipe.categoryvideoRecipe.categoryvideoRecipe.categoryvideoRecipeBrief.category
videoRecipeTopic videoRecipeTopic	String	tastecraftspacesignatureevent	videoRecipe.topicsvideoRecipe.topicsvideoRecipe.topicsvideoRecipeBrief.topic
videoRemakeMode videoRemakeMode	String	objectSwapmotionTransfer	videoRemake.modevideoRemake.modevideoRemake.modevideoRemake.mode
videoRemakeStatus videoRemakeStatus	String	pendingpreparingreadyfailed	videoRemake.statusvideoRemake.statusvideoRemake.status
videoResolution videoResolution	String	480p720p1080p	videoBoard.resolutionvideoBoard.resolutionvideoBoard.resolutionvideoBoard.resolutiongenVideo.resolutiongenVideo.resolutiongenVideo.resolutiontakeSpec.resolution