apex-video-generator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Apex Real Estate Video Generator

Apex房地产视频生成器

Video Types

视频类型

Type	ID	Duration	Aspect	Use Case
Property Showcase	`property-showcase`	30s	16:9	Listing promotion
Social Short	`social-short`	9s	9:16	TikTok/Reels
Market Stats	`market-stats`	20s	16:9	Monthly reports
Neighborhood Tour	`neighborhood-tour`	45s	16:9	Area marketing
Agent Intro	`agent-intro`	15s	9:16	Personal branding
Testimonial	`testimonial`	20s	16:9	Social proof
Just Listed	`just-listed`	12s	9:16	New listing alert
Just Sold	`just-sold`	12s	9:16	Sales proof
Open House	`open-house`	15s	9:16	Event promotion
Price Drop	`price-drop`	10s	9:16	Price reduction

类型	ID	时长	宽高比	使用场景
房产展示	`property-showcase`	30s	16:9	房源推广
社交短视频	`social-short`	9s	9:16	TikTok/Reels
市场数据	`market-stats`	20s	16:9	月度报告
社区探访	`neighborhood-tour`	45s	16:9	区域营销
Agent介绍	`agent-intro`	15s	9:16	个人品牌打造
客户证言	`testimonial`	20s	16:9	社交证明
新上市房源	`just-listed`	12s	9:16	新房源提醒
刚售出房源	`just-sold`	12s	9:16	销售业绩证明
开放看房	`open-house`	15s	9:16	活动推广
降价通知	`price-drop`	10s	9:16	价格下调提醒

Data Flow

数据流

[Listing URL] → [Firecrawl Extract] → [Property Data]
                                           ↓
[AI Script Generator] ← [Property Data + Video Type]
         ↓
[Remotion Composition] → [Rendered Video]
         ↓
[Optional: OpenAI TTS] → [Voiceover Audio]

[Listing URL] → [Firecrawl Extract] → [Property Data]
                                           ↓
[AI Script Generator] ← [Property Data + Video Type]
         ↓
[Remotion Composition] → [Rendered Video]
         ↓
[Optional: OpenAI TTS] → [Voiceover Audio]

API Usage

API使用方法

Generate Video

生成视频

typescript

POST /api/video/generate
{
  listingUrl: "https://zillow.com/...",
  videoType: "property-showcase",
  voiceoverEnabled: true,
  branding: {
    agentName: "John Doe",
    brokerageName: "Apex Realty",
    logoUrl: "https://...",
    primaryColor: "#0dccf2"
  }
}

// Response
{
  success: true,
  videoId: "vid_abc123",
  status: "rendering",
  estimatedTime: 120 // seconds
}

typescript

POST /api/video/generate
{
  listingUrl: "https://zillow.com/...",
  videoType: "property-showcase",
  voiceoverEnabled: true,
  branding: {
    agentName: "John Doe",
    brokerageName: "Apex Realty",
    logoUrl: "https://...",
    primaryColor: "#0dccf2"
  }
}

// Response
{
  success: true,
  videoId: "vid_abc123",
  status: "rendering",
  estimatedTime: 120 // seconds
}

Check Status

检查状态

typescript

GET /api/video/status?id=vid_abc123

{
  status: "complete",
  videoUrl: "https://storage.../video.mp4",
  thumbnailUrl: "https://storage.../thumb.jpg",
  duration: 30,
  propertyData: { ... }
}

typescript

GET /api/video/status?id=vid_abc123

{
  status: "complete",
  videoUrl: "https://storage.../video.mp4",
  thumbnailUrl: "https://storage.../thumb.jpg",
  duration: 30,
  propertyData: { ... }
}

Template Details

模板详情

See individual rules for each video type:

Property Showcase: See rules/property-showcase.md
Social Shorts: See rules/social-shorts.md
Market Stats: See rules/market-stats.md
Neighborhood Tour: See rules/neighborhood-tour.md
Testimonial: See rules/testimonial-video.md

查看各视频类型的单独规则：

房产展示: 查看 rules/property-showcase.md
社交短视频: 查看 rules/social-short.md
市场数据: 查看 rules/market-stats.md
社区探访: 查看 rules/neighborhood-tour.md
客户证言: 查看 rules/testimonial-video.md

Branding System

品牌定制系统

All videos support custom branding:

Agent name and photo
Brokerage logo
Primary accent color
Contact information
Social media handles
Custom fonts (from Google Fonts)

所有视频支持自定义品牌元素：

Agent姓名和照片
经纪公司logo
主强调色
联系信息
社交媒体账号
自定义字体（来自Google Fonts）

Scene Structure

场景结构

Property Showcase (30s)

房产展示（30秒）

Hook (0-3s): Stunning hero shot + price
Stats (3-7s): Beds, baths, sqft animation
Gallery (7-20s): Photo slideshow with Ken Burns
Features (20-25s): Key highlights list
CTA (25-30s): Contact info + logo

钩子（0-3秒）：精美主图+价格
数据（3-7秒）：卧室数、卫生间数、平方英尺动画展示
图库（7-20秒）：带Ken Burns效果的照片轮播
特色（20-25秒）：核心亮点列表
行动号召（25-30秒）：联系信息+logo

Social Short (9s)

社交短视频（9秒）

Hook (0-2s): Eye-catching visual + text
Value (2-6s): 3 key stats animated
CTA (6-9s): Swipe up / Contact

钩子（0-2秒）：吸睛视觉+文案
价值点（2-6秒）：3个核心数据动画展示
行动号召（6-9秒）：上滑/联系

Integration Points

集成组件

Firecrawl: Property data extraction
Gemini AI: Script generation
OpenAI TTS: Voiceover generation
Remotion Lambda: Cloud rendering
Supabase Storage: Video hosting
Convex: Job tracking and history

Firecrawl：房产数据提取
Gemini AI：脚本生成
OpenAI TTS：语音生成
Remotion Lambda：云端渲染
Supabase Storage：视频存储
Convex：任务跟踪与历史记录