사용자 매뉴얼 — owntent

사용자 매뉴얼

owntent의 모든 기능을 한곳에 모았습니다. 기능별로 무엇을 하는지와 어디에서 찾는지를 안내합니다. 처음이라면 아래 시작하기부터 따라와 보세요.

시작하기

1로그라인이나 시놉시스로 새 프로젝트를 만듭니다.
2AI 스레드와 개발 탭에서 이야기를 다듬고 씬·캐릭터를 구성합니다.
3스토리보드와 컨트롤·파이프라인에서 샷을 생성하고 다듬습니다.
4미리보기와 편집에서 타임라인을 완성하고 영상을 내보냅니다.

지원 모델 · 프로바이더

이미지 생성

god-tibo-imagen (Codex / GPT Image)

키 불필요

기본 이미지 생성 경로. 로컬 Codex/ChatGPT 인증(~/.codex/auth.json)을 재사용하므로 API 키가 필요 없다. 키프레임·콘셉트·시트 생성의 표준 경로.

경로 · 위치: /api/owntent/imagen

OpenAI GPT Image (gpt-image-2.0 / gpt-image-1)

BYOK

OpenAI 직접 호출 이미지 생성(BYOK). 레거시 캐릭터 의상/표정/포즈 레퍼런스 경로로만 유지 — 신규 화면은 /api/owntent/imagen을 쓴다.

경로 · 위치: /api/owntent/image

Higgsfield image (Nano Banana Pro/2, Soul, Cinema Studio)

키 불필요

Higgsfield CLI를 서버에서 실행해 생성. BYOK 키가 아니라 호스트의 CLI 로그인에 의존. 캐릭터/얼굴 정체성 일관(soul-id), 시네마틱 스틸, 레퍼런스 작업.

경로 · 위치: /api/owntent/higgsfield

fal.ai image (FLUX.2 Pro, FLUX 1.1 Pro, Seedream v4, Nano Banana 2)

BYOK

fal.ai 단일 큐 API로 다양한 이미지 모델 호출(BYOK fal 키). FLUX 계열·Seedream·Nano Banana 등 범용·고품질·참조 편집.

경로 · 위치: /api/owntent/fal

Google Gemini image (Nano Banana Pro / 2)

BYOK

Google Gemini 이미지 모델을 직접 API로 호출(BYOK google 키). 레퍼런스 최대 3장 image-to-image. Pro=고품질, Flash=빠르고 저렴.

경로 · 위치: /api/owntent/gemini

xAI Grok Imagine (Quality / Standard)

BYOK

xAI Grok Imagine 이미지 모델을 직접 API로 호출(BYOK xai 키). Quality는 2k 고품질, Standard는 빠른 표준 품질.

경로 · 위치: /api/owntent/grok

Atlas Cloud NSFW image (Flux Dev NSFW, Seedream v5 NSFW)

BYOK

무검열(NSFW) 이미지 생성(BYOK atlas 키). NSFW 모드가 켜졌을 때만 노출. safety checker 비활성.

경로 · 위치: /api/owntent/atlas

ComfyUI (self-hosted SD/Flux)

키 불필요

사용자가 직접 운영하는 ComfyUI에 워크플로우를 큐잉. 제품에 모델이 번들되지 않는 BYO 구조 — 어떤 SD/Flux 모델·워크플로우든 사용자가 고른 대로. NSFW 토글과 무관하게 항상 노출.

경로 · 위치: /api/owntent/comfyui

Custom BYO model (OpenAI-compatible / REST)

BYOK

사용자가 설정에서 직접 등록한 임의의 이미지 생성 엔드포인트를 호출(BYOK). Suno 등 공식 통합이 없는 경우의 추가 경로이기도 함.

경로 · 위치: /api/owntent/custom-model

영상 생성

PoYo — Seedance 2.0 / Fast / Sora 2 / Sora 2 Pro

BYOK

PoYo 큐 API로 비디오 생성(BYOK poyo 키). Seedance 2.0(720p I2V 최저가·자동화), Seedance 2.0 Fast($0.08/s), OpenAI Sora 2 / Sora 2 Pro(오디오·T2V/I2V).

경로 · 위치: /api/owntent/poyo

Higgsfield video (Cinema Studio 3.5 / 3.0, Veo 3.1)

키 불필요

Higgsfield CLI 경유 비디오 생성(키리스, 호스트 CLI 로그인 필요). Cinema Studio는 최상위 시네마 실행, Veo 3.1은 초실사+오디오.

경로 · 위치: /api/owntent/higgsfield

fal.ai video (Kling 3.0/2.6, Seedance 1.5 Pro, Hailuo 02, LTX-2)

BYOK

fal.ai 단일 큐 API로 다양한 비디오 모델 호출(BYOK fal 키). Kling 시네마틱 I2V, ByteDance Seedance 1.5 Pro, MiniMax Hailuo, LTX-2(영상+오디오).

경로 · 위치: /api/owntent/fal

Atlas Cloud NSFW video (Wan 2.2/2.5/2.6, Kling v3, Vidu Q3)

BYOK

무검열(NSFW) 비디오 생성(BYOK atlas 키). NSFW 모드 전용. Wan Spicy 계열·1080p Kling/Vidu 등.

경로 · 위치: /api/owntent/atlas

Seedance 2.5 (ByteDance)

키 불필요

출시 대기 중. 공식 API 스펙 확인 후 활성화 예정 — 현재 선택 불가.

경로 · 위치: catalog only (coming soon)

텍스트 / LLM (시나리오·프롬프트·비전)

OpenAI / Anthropic Claude / Google Gemini (LLM + vision)

BYOK

BYOK LLM 텍스트/비전 생성(openai/anthropic/google). 시나리오·샷리스트·프롬프트 저작 및 영상 프레임 분석(비전)에 사용. 'custom' provider로 OpenAI-호환 엔드포인트도 가능.

경로 · 위치: /api/owntent/llm + /llm/stream + /vision

Local CLI agents (Codex / Claude Code)

키 불필요

로컬에 설치된 Codex / Claude Code CLI를 텍스트 생성 에이전트로 사용(키 불필요). LLM 경로의 키리스 대안. 비전은 미지원.

경로 · 위치: /api/owntent/llm (agent param)

음성 / 내레이션 (TTS)

ElevenLabs TTS (Multilingual v2, Turbo v2.5, v3 alpha)

BYOK

BYOK ElevenLabs 음성 합성(내레이션·대사 더빙). 언어 코드·stability·style·speed 등 표준 파라미터 노출. 29개 언어·감정 연기.

경로 · 위치: /api/owntent/elevenlabs/tts

음악 / BGM

ElevenLabs Music

BYOK

BYOK ElevenLabs Music으로 씬별 BGM/사운드트랙 생성(text-to-music). Suno 공식 API 미공개 상태라 BGM 1차 제공자.

경로 · 위치: /api/owntent/elevenlabs/music

Suno (v4)

BYOK

Suno 슬롯/카탈로그 항목은 있으나 공식 API가 미공개라 전용 서버 라우트가 없다. 사용자가 BYO 모델 등록 폼으로 추가해 /api/owntent/custom-model 경유로 사용.

경로 · 위치: BYO model form

기타 — 모델/에셋 소스

CivitAI (model browse/download)

키 불필요

CivitAI 모델 브라우즈/다운로드 프록시. 검색·메타는 키리스, 일부 게이티드 모델 다운로드만 토큰 필요. ComfyUI 등에서 쓸 체크포인트/LoRA 확보용.

경로 · 위치: /api/owntent/civitai

Runway / Kling (direct)

BYOK

runway·kling BYOK 키 슬롯은 정의돼 있으나 전용 직통 라우트는 없다. 현재 Kling 모델은 fal.ai 경유(/api/owntent/fal)로 제공된다.

경로 · 위치: via fal.ai (/api/owntent/fal)

BYOK 안내

BYOK 키 슬롯은 keys/registry.ts(PROVIDER_KEYS)에 정의된 12개다: openai(llm,image), anthropic(llm), google/Gemini(llm,image,video), fal/fal.ai(image,video,audio), higgsfield(video — 단 실제 통합은 CLI 키리스), poyo/PoYo Seedance 2.0(video), runway(video), kling(video), elevenlabs(audio), suno(audio), atlas/Atlas Cloud NSFW(image,video), xai/xAI Grok(image). 키는 모두 로컬(localStorage 'owntent:api-keys' / 키볼트)에만 저장되고 우리 서버로 전송·저장되지 않는다(local-first BYOK). 키리스 경로: god-tibo-imagen(/api/owntent/imagen, 로컬 Codex 인증 재사용)·Higgsfield CLI·로컬 Codex/Claude Code CLI·ComfyUI(사용자 운영)·CivitAI 브라우즈.

기반 기술 · 편집 자동화 파이프라인

내부적으로 생성 결과는 곧바로 타임라인으로 가지 않습니다. 먼저 LLM에 의존하지 않는 결정적 품질 게이트가 돌고, 그다음 기본 타임라인을 조립·트림한 뒤, 마지막으로 선택적 AI 편집 결정이 컷을 다듬습니다. 이 품질 패턴들은 owntent-core 패키지 안에 순수 TypeScript로 재구현되어 있으며, 각 패턴은 참고한 오픈소스 프로젝트를 명시합니다.

기반 기술 · 적용 패턴

품질·조립 패턴 일부는 오픈소스 executive-producer 프로젝트 OpenMontage 에서 차용해, 크레딧 0으로 즉시 실행되는 순수·LLM 비의존 TypeScript로 재구현했습니다.

executive-producer 파이프라인 계약

모든 파이프라인 단계(브리프·스크립트·샷리스트·키프레임·클립·조립·렌더 등)는 선언형 루브릭을 갖습니다 — 무엇을 산출하는지, 사람이 봐야 할 검토 관점, 통과로 보는 구체 기준입니다. 어느 단계에서 사람 승인을 위해 멈춰야 하는지도 표시해, 느슨한 흐름을 검토 가능한 게이트 계약으로 바꿉니다.

슬라이드쇼 위험 게이트

유료 에셋을 만들기 전에, 기획을 여섯 차원으로 점수화합니다 — 반복·장식적 비주얼·약한 모션·약한 샷 의도·텍스트 과의존·근거 없는 시네마틱 주장입니다. 종합 판정(strong / acceptable / revise / fail)은 결과물이 연출된 영상이 아니라 슬라이드쇼처럼 느껴질 위험을 잡아내며, 평가 탭의 구조 품질로 노출됩니다.

딜리버리 약속

프로젝트는 무엇을 전달하겠다고 약속했는지를 잠급니다 — 모션 중심·정지 이미지 중심·소스 푸티지 중심·텍스트 중심입니다. 그리고 샷 계획이 그 약속을 실제로 지키는지 검사합니다. 모션 영상이 실제 클립 샷의 필요 비율 밑으로 조용히 떨어지면 슬라이드쇼 다운그레이드로 플래그해, 약한 컷을 내보내기 전에 멈출 수 있게 합니다.

변주 / 구조 검사

결정적 구조 검사가 제네릭하고 반복적인 결과를 만드는 구체 패턴을 훑습니다 — 게으른 채움 표현(영문·한글), 비거나 중복된 장면 묘사, 한 장소가 기획을 지배하는 경우, 샷마다 같은 프레이밍·카메라 재사용입니다. 모델 호출 없이 반복도 점수를 산출하고, 그 점수가 슬라이드쇼 게이트로 들어갑니다.

비용 추적

유료 단계는 추정 → 예약 → 정산 원장을 따릅니다 — 작업마다 사전 추정치를 만들고, 실행 전 예산을 예약하며, 끝나면 실제 비용으로 정산합니다. 예산 모드(off / warn / cap)가 다음 단계를 허용·경고·차단할지 결정해, BYOK 지출을 눈에 보이게 관리합니다.

실제 클립 / 스톡 검색

생성을 넘어, 파이프라인은 무료 스톡 푸티지 프로바이더(Pexels·Pixabay)에서 실제 모션 클립을 검색하고 각 결과를 공통 형태로 정규화합니다 — 다운로드 URL·썸네일·해상도·길이·출처 표기입니다. 이로써 자동 조립이 타임라인에 곧바로 넣을 수 있는 진짜 영상 경로가 열립니다.

편집 자동화 파이프라인

생성된 에셋에서 완성 컷까지, 편집 자동화 파이프라인은 정해진 순서대로 돕니다. 각 단계는 실제 코드에 근거합니다 — 먼저 품질 게이트, 그다음 조립·트림·트랜지션·선택적 AI 편집 결정, 마지막으로 프리뷰와 내보내기입니다.

1
생성
재개 가능한 10단계 파이프라인이 프로젝트를 브리프에서 스크립트·대사·샷리스트·스타일 바이블·키프레임·클립·오디오까지 끌고 갑니다. 단계는 매체가 필요로 할 때만 돌고 — 정지 이미지·텍스트 매체는 모션 단계를 건너뜁니다 — 게이트 단계는 이미지·영상 크레딧을 쓰기 전 사람 승인을 기다립니다.
2
일관성 · 품질 게이트
결정적 일관성 검사(LLM 없음)가 씬 단위로 매핑되는 문제를 잡아냅니다 — 빈 묘사, 캐스트에 없는 인물의 대사, 누락된 포트레이트, 지식그래프 이슈 — 그리고 어떤 씬을 재생성해야 하는지 정확히 돌려줍니다. 이와 함께 슬라이드쇼 위험·딜리버리 약속 게이트가 저품질이거나 조용히 다운그레이드된 기획을 조립 전에 차단합니다.
3
기본 타임라인 자동 조립
샷마다 고른 베스트 take 또는 키프레임을 narrative 순서대로 끝에서 끝까지 이어붙여 기본 타임라인을 한 번에 만듭니다. 삽입에 실패한 클립은 cursor를 전진시키지 않아 빈 구간이 남지 않고, take URL은 신뢰 조회로만 해석되어 모델이 위조 소스를 끼워 넣을 수 없습니다.
4
스마트 / 오토 트림
선택적 스마트 트림은 각 클립을 저해상도로 샘플링해 앞뒤의 검정·페이드·정지(프리즈) 구간을 잘라냅니다. 항상 최소 길이를 보장하고 분석이 실패하면 전체 클립으로 폴백합니다. 옵트인 프레임 분석 모드는 대신 비전 에이전트로 클립별 베스트 in/out 지점을 고를 수 있습니다.
5
트랜지션
컷 사이 편집점이 자동으로 계획되어, 같은 씬 안인지 새 씬으로 넘어가는지에 따라 경계마다 트랜지션 기법·길이·방향을 고릅니다. 같은 엔진이 휴리스틱·AI 조립 양쪽을 구동하며, 각 편집점은 프리뷰·재타이밍·오버라이드 후 타임라인에 다시 적용할 수 있습니다.
6
AI 편집 결정 (EDL)
AI 백엔드가 있으면 타임라인 컨텍스트를 모델에 보내고, 모델은 EDL(Edit Decision List)을 돌려줍니다 — 샷별로 어떤 take를 유지할지, in/out 트림, 길이입니다. 결과는 항상 실제 후보에 맞게 보정·검증되며 throw하지 않습니다. 모델 출력이 없거나 무효면 결정적 휴리스틱 편집으로 폴백합니다.
7
프리뷰 · 내보내기
조립된 컷은 내장 자동 영상편집툴에서 재생되며, 편집점을 스크럽하고 트랜지션을 손보고 재조립할 수 있습니다. 컷이 확정되면 프로젝트를 렌더링해 완성 영상 파일로 내보냅니다.

전체 기능

기능별 상세 가이드입니다. 항목을 눌러 개요·사용 방법·사용 모델·팁을 확인하세요.

둘러보기 · 메인

작동 방식

위치: /how-it-works

요금제

위치: /pricing

계정

위치: /account

설정

위치: /settings

프로젝트

위치: /projects

제작

오토파일럿

위치: /studio/[project]/pipeline

컨트롤

위치: /studio/[project]/control

스토리보드

위치: /studio/[project]/storyboard

블로킹(3D)

위치: /studio/[project]/blocking

음성·BGM

위치: /studio/[project]/audio

도구

위치: /studio/[project]/tools

스토리

AI 스레드

위치: /studio/[project]/ai

개발

위치: /studio/[project]/develop

스크립트 임포트

고급

위치: /studio/[project]/import

온톨로지 팩

고급

위치: /studio/[project]/packs

세계관

위치: /studio/[project]/world

대사

위치: /studio/[project]/dialogue

웹툰

위치: /studio/[project]/webtoon

소설 보기

고급

위치: /studio/[project]/novel

세력

고급

위치: /studio/[project]/factions

챕터

고급

위치: /studio/[project]/chapters

온톨로지

고급

위치: /studio/[project]/ontology

그래프

고급

위치: /studio/[project]/graph

상태

고급

위치: /studio/[project]/state

떡밥

고급

위치: /studio/[project]/foreshadowing

그래프 질의

고급

위치: /studio/[project]/query

레퍼런스 비교

고급

위치: /studio/[project]/compare

평가

고급

위치: /studio/[project]/evaluate

스킬 강화

고급

위치: /studio/[project]/skillopt

플레이

고급

위치: /studio/[project]/play

출력

미리보기

위치: /studio/[project]/preview

편집

위치: /studio/[project]/edit

에셋

위치: /studio/[project]/assets

포스터

고급

위치: /studio/[project]/poster

뮤직비디오

위치: /studio/[project]/musicvideo

관리

사용량

위치: /studio/[project]/usage

프로젝트 설정

위치: /studio/[project]/settings

ComfyUI 스튜디오

고급

위치: /studio/[project]/comfyui

리포트

고급

위치: /studio/[project]/reports

메모리

고급

위치: /studio/[project]/memory

칸반

고급

위치: /studio/[project]/kanban

스케줄

고급

위치: /studio/[project]/schedule

도구

렌즈의 언어

위치: /studio/[project]/lens

샷 사이즈

위치: /studio/[project]/shotsize

영상 레퍼런스 분석

위치: /studio/[project]/reference

시작하기

1로그라인이나 시놉시스로 새 프로젝트를 만듭니다.

2AI 스레드와 개발 탭에서 이야기를 다듬고 씬·캐릭터를 구성합니다.

3스토리보드와 컨트롤·파이프라인에서 샷을 생성하고 다듬습니다.

4미리보기와 편집에서 타임라인을 완성하고 영상을 내보냅니다.

기반 기술 · 편집 자동화 파이프라인

시작하기

지원 모델 · 프로바이더

이미지 생성

god-tibo-imagen (Codex / GPT Image)

OpenAI GPT Image (gpt-image-2.0 / gpt-image-1)

Higgsfield image (Nano Banana Pro/2, Soul, Cinema Studio)

fal.ai image (FLUX.2 Pro, FLUX 1.1 Pro, Seedream v4, Nano Banana 2)

Google Gemini image (Nano Banana Pro / 2)

xAI Grok Imagine (Quality / Standard)

Atlas Cloud NSFW image (Flux Dev NSFW, Seedream v5 NSFW)

ComfyUI (self-hosted SD/Flux)

Custom BYO model (OpenAI-compatible / REST)

영상 생성

PoYo — Seedance 2.0 / Fast / Sora 2 / Sora 2 Pro

Higgsfield video (Cinema Studio 3.5 / 3.0, Veo 3.1)

fal.ai video (Kling 3.0/2.6, Seedance 1.5 Pro, Hailuo 02, LTX-2)

Atlas Cloud NSFW video (Wan 2.2/2.5/2.6, Kling v3, Vidu Q3)

Seedance 2.5 (ByteDance)

텍스트 / LLM (시나리오·프롬프트·비전)

OpenAI / Anthropic Claude / Google Gemini (LLM + vision)

Local CLI agents (Codex / Claude Code)

음성 / 내레이션 (TTS)

ElevenLabs TTS (Multilingual v2, Turbo v2.5, v3 alpha)

음악 / BGM

ElevenLabs Music

Suno (v4)

기타 — 모델/에셋 소스

CivitAI (model browse/download)

Runway / Kling (direct)

BYOK 안내

기반 기술 · 편집 자동화 파이프라인

기반 기술 · 적용 패턴

executive-producer 파이프라인 계약

슬라이드쇼 위험 게이트

딜리버리 약속

변주 / 구조 검사

비용 추적

실제 클립 / 스톡 검색

편집 자동화 파이프라인

생성

일관성 · 품질 게이트

기본 타임라인 자동 조립

스마트 / 오토 트림

트랜지션

AI 편집 결정 (EDL)

프리뷰 · 내보내기

전체 기능

둘러보기 · 메인

작동 방식

요금제

계정

설정

프로젝트

제작

오토파일럿

컨트롤

스토리보드

블로킹(3D)

음성·BGM

도구

스토리

AI 스레드

개발

스크립트 임포트

온톨로지 팩

세계관

대사

웹툰

소설 보기

세력

챕터

온톨로지

그래프

상태

떡밥

그래프 질의

레퍼런스 비교

평가

스킬 강화

플레이