OmniFlow Studio Agent Skill
이 스킬은 AI 코딩 및 오케스트레이션 에이전트에게 OmniFlow Studio에 대한 직접적인 제어 권한을 부여합니다. OmniFlow Studio는 로컬 AI 에이전트를 Google Chrome의 고충실도 생성 미디어 캔버스에 연결하는 자율 브릿지입니다.
이 스킬을 사용해야 하는 경우
다음과 같은 경우에 이 스킬을 사용하세요.
- 사용자가 시네마틱 AI 비디오, B-roll 영상, 컨셉 아트 또는 스토리보드 생성을 요청할 때.
- 자율 멀티샷 단편 영화 또는 광고 크리에이티브를 제작하거나 감독할 때.
- 여러 비디오 장면에서 캐릭터 참조 시트(턴어라운드 일관성)를 생성할 때.
- 분당 API 요금을 지불하지 않고 배치 이미지/비디오 생성 대기열을 자동화할 때.
- 현재 OmniFlow 브릿지 상태, 생성 할당량 또는 활성 대기열 진행 상황에 대해 문의할 때.
🚀 에이전트를 위한 빠른 실행 프로토콜
미디어 작업을 실행하기 전에 모든 에이전트는 다음 3단계 검증 루프를 따라야 합니다.
1단계: 상태 및 브릿지 확인
로컬 OmniFlow 브릿지 데몬이 http://127.0.0.1:8792에서 실행 중인지 확인합니다.
node scripts/check-bridge.js
# 또는 직접 curl 사용:
curl -s http://127.0.0.1:8792/status
- 오프라인인 경우: 사용자에게 지시하거나 다음을 실행합니다:
omniflow bridge start(또는 브릿지 백그라운드 작업 시작). - 온라인인 경우:
extensionConnected가true이고tabVisible이true인지 확인합니다(Chrome에 Google Flow가 열려 있음을 의미).
2단계: 생성 작업 제출
에이전트는 REST API 또는 제공된 헬퍼 스크립트를 통해 제출할 수 있습니다.
# 헬퍼 스크립트 (가장 쉬움):
node scripts/submit-shot.js --mode flow-text-to-video --prompt "Cinematic drone flyover neon cyberpunk Tokyo rain 8k" --aspectRatio 16:9 --duration 6s
# 또는 직접 HTTP POST:
curl -s -X POST http://127.0.0.1:8792/jobs \
-H "Content-Type: application/json" \
-d '{
"mode": "flow-text-to-video",
"prompt": "Cinematic drone flyover neon cyberpunk Tokyo rain 8k",
"params": {
"aspectRatio": "16:9",
"duration": "6s",
"videoModel": "veo-3.1-fast",
"downloadSubfolder": "MyProject"
}
}'
3단계: 다운로드된 미디어 모니터링 및 검색
작업 상태가 completed로 변경될 때까지 폴링합니다.
node scripts/list-jobs.js
# 또는:
curl -s http://127.0.0.1:8792/jobs
status === "completed"이면 files 배열에서 로컬 파일 경로를 검색합니다(예: Downloads/MyProject/...mp4).
🛠️ 지원되는 생성 모드
| 모드 ID | 설명 | 주요 매개변수 |
|---|---|---|
flow-text-to-video | 텍스트 설명에서 모션 비디오 생성 | prompt, aspectRatio (16:9, 9:16, 1:1), duration (4s, 6s, 8s) |
flow-text-to-image | 사실적 또는 양식화된 정지 이미지 생성 | prompt, aspectRatio, imageModel (nano-banana-pro) |
flow-frame-to-video | 정지 이미지 또는 키프레임을 연속 비디오로 확장 | prompt, duration, 참조 에셋 토큰 |
flow-create-character | 얼굴 일관성을 위한 4각 턴어라운드 시트 생성 | characterName, visualDescription, voicePreset |
🎛️ MCP 도구 호출 (MCP 서버가 활성화된 경우)
에이전트 환경에서 OmniFlow의 MCP 서버가 연결된 경우 다음 네이티브 도구를 직접 호출하세요.
omniflow_status: 브릿지 및 브라우저 연결 상태를 확인합니다.omniflow_generate_shot: 카메라 움직임(drone-wide,close-up,tracking)이 포함된 단일 샷을 대기열에 추가합니다.omniflow_produce_movie: 정렬된 샷의 전체 시나리오 배열을 전달하여 단편 영화를 순차적으로 제작합니다.omniflow_create_character: 정면 및 프로필 턴어라운드 일관성으로 캐릭터 태그를 고정합니다.omniflow_list_jobs: 활성, 대기 중 및 완료된 생성 작업을 디스크 다운로드 경로와 함께 나열합니다.
💡 시네마틱 프롬프트를 위한 모범 사례
Veo 3.1로 사실적인 비디오 출력을 얻으려면:
- 카메라 움직임 지정: 예:
[Camera: drone-wide],[Camera: slow push-in],[Camera: tracking shot]. - 조명 및 분위기 지정: 예:
volumetric rim lighting,golden hour anamorphic haze,35mm film grain. - 전문 용어 피하기: Google Flow는 소프트웨어 태그보다 명확한 시각적 설명에 가장 잘 반응합니다.
즉시 실행 가능한 멀티씬 템플릿은 references/api-reference.md 및 examples/cinematic-short-film.json을 참조하세요.