AI destekli YouTube localization ve growth intelligence platformu
SynchCaption, YouTube içerik üreticileri, ajanslar ve global pazarlara açılmak isteyen video yayıncıları için tasarlanmış web tabanlı bir localization SaaS platformudur. Sistem, tek bir video kaynağını hedef ülkelere göre altyazı, SEO başlık/açıklama, localized thumbnail, audio-only dublaj ve ülke bazlı büyüme önerileri üreten yönetilebilir bir iş akışına dönüştürür.
Platformun temel vizyonu, YouTube içeriklerinin yalnızca çevrilmesini değil; her hedef pazar için yayınlanabilir, ölçülebilir ve optimize edilebilir hale getirilmesini sağlamaktır. YouTube verisine göre multi-language audio kullanan creator'larda izlenme süresinin ortalama %25'ten fazlası videonun ana dili dışındaki izleyicilerden gelebilmektedir. Bu nedenle SynchCaption, creator ekonomisinde gerçek bir büyüme ihtiyacına karşılık gelen localization + publishing + analytics katmanlarını tek ürün mimarisinde birleştirir.
SynchCaption, YouTube videolarını ülke bazlı pazarlara hazırlayan AI destekli bir localization ve growth platformu olarak kurgulanmıştır.
Sistem, kullanıcıdan video/audio kaynağı, YouTube linki veya transcript alır; bu girdiyi transcription, master transcript, çok dilli subtitle, SEO metadata, thumbnail localization ve audio-only dubbing çıktıları için işlenebilir bir proje varlığına dönüştürür. Üretilen çıktılar kullanıcı tarafından düzenlenebilir, indirilebilir veya YouTube entegrasyonu kapsamında uygun API yüzeyleri üzerinden yayınlanabilir.
Executive düzeyde çözülen problem şudur:
- Creator'ların global pazarlara açılırken altyazı, SEO, thumbnail ve dublaj süreçlerini ayrı araçlarda yönetmesi operasyonel karmaşıklık yaratır.
- Hangi ülkeye yatırım yapılması gerektiği çoğu zaman sezgisel kararlarla belirlenir.
- YouTube API, analytics, quota, OAuth, dublaj erişimi ve export fallback süreçleri teknik olarak yönetilmesi gereken ayrı risk alanlarıdır.
SynchCaption bu alanları tek bir kontrollü workflow altında birleştirerek çoklu pazar yayını için üretim, düzenleme, yayınlama ve performans karar destek sistemini aynı platformda toplar.
SynchCaption; medya teknolojileri, creator economy, SaaS otomasyonu, AI operasyonları ve veri odaklı büyüme sistemleri kesişiminde konumlanır. Telekomünikasyon, enerji, savunma, medya ve kurumsal eğitim gibi çok dilli içerik ihtiyacı olan sektörlerde de uygulanabilecek bir mimari yaklaşımı temsil eder.
| Alan | Gösterilen Mühendislik Yetkinliği |
|---|---|
| AI Entegrasyonu | OpenAI, AssemblyAI, Gemini ve TTS sağlayıcılarının provider-router yaklaşımıyla soyutlanması |
| Otonom İş Akışları | Celery tabanlı uzun süreli transcription, localization, thumbnail ve dublaj job zincirleri |
| Veri Odaklı Karar Destek | YouTube Analytics verilerinden Country Opportunity Score hesaplanması |
| API ve Platform Entegrasyonu | YouTube OAuth, token encryption, caption/thumbnail/metadata publishing pipeline |
| Medya İşleme | FFmpeg, waveform editor, timing alignment, audio normalization ve segment-level dublaj kontrolü |
| Güvenlik ve Uyum | OAuth token şifreleme, frontend token izolasyonu, role-based admin panel ve audit log yaklaşımı |
| Ölçeklenebilir SaaS Tasarımı | Docker, PostgreSQL, Redis, worker queue, storage abstraction ve cloud migration hazırlığı |
- Country-first localization workspace: Her hedef ülke için subtitle, SEO, thumbnail, dubbing ve publish durumları ayrı takip edilir.
- AI destekli subtitle ve SEO üretimi: Master transcript üzerinden hedef dile ve pazara uygun metinler oluşturulur.
- Thumbnail localization: Referans thumbnail ve localized title/hook bilgisiyle ülke bazlı görsel varyasyonlar üretilir.
- Audio-only dubbing: OpenAI TTS veya premium TTS sağlayıcılarıyla WAV/MP3 dublaj çıktısı hazırlanır.
- Web Audio Editor: Orijinal ses ve dublaj sesi waveform üzerinden karşılaştırılır; problemli segmentler manuel düzenlemeye açılır.
- YouTube publishing workflow: Altyazı, metadata ve thumbnail çıktıları API üzerinden yayınlanabilir; API kısıtlarında manuel export fallback korunur.
- Analytics-driven recommendations: Ülke bazlı performans verisiyle dublaj, thumbnail veya SEO yatırımı önerilir.
| Kategori | Teknolojiler |
|---|---|
| Frontend | Next.js 14+ App Router, React, TypeScript, Tailwind CSS, shadcn/ui, Radix UI, TanStack Query |
| Media UI | Wavesurfer.js, Web Audio API, custom thumbnail workspace |
| Backend | Python 3.12+, FastAPI, Uvicorn, SQLAlchemy 2.0, Pydantic, Alembic |
| Async Processing | Celery, Redis, Celery Beat, retry/backoff job orchestration |
| Database | PostgreSQL 16, JSONB fields, unique constraints, upsert-based analytics storage |
| AI/ML Providers | OpenAI GPT-4o, OpenAI TTS, AssemblyAI, Gemini, ElevenLabs |
| Media Processing | FFmpeg, ffprobe, audio time-stretching, loudness normalization |
| Authentication & Security | Clerk, Google OAuth, encrypted YouTube tokens, role-based admin access |
| YouTube Integration | YouTube Data API, YouTube Analytics API, OAuth capability checks, quota monitoring |
| Payments & Billing | Stripe Billing, Stripe Webhooks, credit ledger, pre-flight credit reservation |
| Storage | Local VPS storage for MVP, Cloudflare R2 / AWS S3 migration path |
| Infrastructure | Docker, Docker Compose, Turborepo, pnpm, VPS deployment, reverse proxy-ready architecture |
| Monitoring | Sentry, PostHog, Better Stack / Uptime Kuma, provider health dashboards |
Next.js Web App
|
| REST API / authenticated requests
v
FastAPI Backend
|
| creates domain records, validates credits, enqueues jobs
v
Redis Queue <----> Celery Workers
| |
| | AI providers, FFmpeg, YouTube APIs
v v
PostgreSQL Storage Layer
|
| dashboard, workspace, analytics, audit logs
v
User-facing Review / Publish / Export Workflow
-
Source Intake Kullanıcı YouTube linki, MP4, WAV, MP3 veya transcript dosyası yükler. FastAPI, kaynak tipini doğrular ve medya kaydını storage abstraction üzerinden saklar.
-
Project & Target Country Setup Kullanıcı hedef ülkeleri seçer. Sistem her ülke için subtitle, SEO, thumbnail, dubbing ve publish durumlarını izlenebilir domain kayıtlarına dönüştürür.
-
Transcription & Master Transcript AssemblyAI veya uygun transcription provider kullanılarak kaynak ses metne çevrilir. OpenAI GPT-4o ile İngilizce master transcript normalize edilir.
-
Localization Generation Celery worker zinciri; hedef ülkelere göre subtitle, SEO başlık/açıklama, sponsor blokları ve country linkleri üretir. AI çıktıları doğrudan yayınlanmaz; kullanıcı onayı ve düzenleme adımları korunur.
-
Thumbnail Generation Onaylı master transcript ve localized hook bilgisi kullanılarak ülke bazlı thumbnail brief oluşturulur. Gemini veya OpenAI image provider üzerinden PNG/JPEG varyasyonları üretilir.
-
Audio-only Dubbing Dublaj pipeline'ı segment bazında TTS üretir, süre uyumunu ffprobe ile ölçer, gerekli durumlarda FFmpeg
atempoile sınırlı hız düzeltmesi uygular veya LLM destekli daha kısa rewrite üretir. -
Review & Edit Workspace Kullanıcı subtitle, SEO metadata, thumbnail ve dublaj segmentlerini inceler. Dublaj editöründe orijinal ses ve üretilen dublaj waveform olarak karşılaştırılır.
-
Publish / Export Uygun çıktılar YouTube API üzerinden caption, thumbnail ve metadata olarak yayınlanabilir. Dublaj için kanalın multi-language audio erişimine bağlı olarak WAV/MP3 export ve manuel YouTube Studio yükleme paketi sunulur.
-
Analytics Sync Celery Beat, YouTube Analytics verisini gece çalışan job'larla çeker. Veriler PostgreSQL'e upsert edilir; dashboard doğrudan YouTube API yerine yerel analitik tablolardan beslenir.
-
Country Opportunity Score Sistem ülke bazlı views, watch time, retention, subscriber gain ve revenue/RPM metriklerini normalize ederek yatırım önceliği üretir. Sonuçlar dublaj, thumbnail testi veya SEO iyileştirme önerisine dönüştürülür.
Transcription, localization, thumbnail generation ve dublaj işlemleri saniyeler değil dakikalar sürebilen görevlerdir. Bu nedenle request/response döngüsü içinde çalıştırılmaları yerine Celery + Redis tabanlı queue mimarisi kurgulanmıştır. Her job; status, provider metadata, retry policy, hata mesajı ve progress alanlarıyla takip edilir.
YouTube entegrasyonu için access token ve refresh token değerleri frontend'e asla taşınmaz. Token'lar backend tarafında simetrik şifreleme ile saklanır; Celery worker yalnızca API çağrısından hemen önce token'ı çözer. Token refresh başarısız olursa kanal needs_reconnect durumuna geçirilir.
YouTube API quota, OAuth verification ve multi-language audio erişim kısıtları ürün davranışına doğrudan etki eder. Bu nedenle sistem yalnızca API upload'a bağımlı değildir; caption, thumbnail, metadata ve dubbing çıktıları her zaman indirilebilir export paketi olarak da hazırlanır.
Diller arası metin uzunluğu farkı, dublaj kalitesinde temel darboğazdır. Pipeline; segment süresini ölçer, 1.05 altındaki farkları kabul eder, 1.25x'e kadar FFmpeg time-stretch uygular, daha yüksek sapmalarda LLM destekli rewrite üretir ve çözülemeyen segmentleri manuel review'a yönlendirir.
Dashboard yüklenirken YouTube Analytics API'ye senkron istek atılmaz. Bunun yerine Celery Beat, verileri zamanlanmış şekilde çeker ve PostgreSQL'e yazar. Bu yaklaşım hem API limitlerini korur hem de dashboard yanıt sürelerini stabil tutar.
AI maliyetleri kullanıma bağlı olduğundan billing sistemi transaction-safe credit ledger yaklaşımıyla tasarlanmıştır. Job kuyruğa alınmadan önce kredi rezervasyonu yapılır; job tamamlandığında gerçek kullanım capture edilir, hata durumunda refund kaydı oluşturulur.
MVP aşamasında local VPS storage kullanılabilir; ancak dosya kayıtları storage_provider ve storage_key alanlarıyla tutulduğu için Cloudflare R2 veya AWS S3'e geçiş için mimari bağımlılık minimize edilmiştir.
synchcaption/
├── README.md # Public architectural overview and technical showcase
├── turbo.json # Monorepo orchestration
├── package.json # Workspace-level scripts
├── pnpm-workspace.yaml # pnpm monorepo definition
├── docker-compose.yml # Local development services
├── docker-compose.prod.yml # VPS / production-oriented service layout
├── .env.example # Environment variable template
│
├── apps/
│ ├── web/ # Next.js 14+ frontend
│ │ ├── src/app/ # App Router routes
│ │ │ ├── (marketing)/ # Landing, pricing, feature pages
│ │ │ ├── (auth)/ # Sign-in and sign-up flows
│ │ │ └── (app)/ # Authenticated dashboard workspace
│ │ ├── src/components/ # UI, layout, wizard and workspace components
│ │ ├── src/features/ # Domain modules: projects, countries, seo, exports
│ │ ├── src/hooks/ # Client-side workflow hooks
│ │ ├── src/lib/ # API client, auth helpers, utility functions
│ │ └── src/types/ # Shared frontend type definitions
│ │
│ └── api/ # FastAPI backend and Celery worker code
│ ├── alembic/ # Database migrations
│ └── app/
│ ├── main.py # FastAPI application entrypoint
│ ├── config.py # Runtime configuration
│ ├── database.py # SQLAlchemy session and engine setup
│ ├── models/ # PostgreSQL domain models
│ ├── schemas/ # Pydantic request/response contracts
│ ├── routers/ # REST API endpoints
│ ├── services/ # Business services and YouTube API client
│ ├── providers/ # OpenAI, AssemblyAI, Gemini, ElevenLabs adapters
│ ├── workers/ # Celery orchestration and background jobs
│ ├── storage/ # Local/R2/S3 storage abstraction
│ ├── media/ # FFmpeg, waveform and audio utility layer
│ └── tests/ # Backend unit/integration tests
│
├── packages/
│ ├── config/ # Shared ESLint, Prettier and TypeScript config
│ └── contracts/ # Shared enums, API contracts and generated OpenAPI types
│
├── infra/
│ ├── nginx/ # Reverse proxy configuration
│ ├── docker/ # Container build helpers
│ └── scripts/ # Deployment and maintenance scripts
│
└── docs/
├── specs/ # Product and architecture design specs by MVP phase
└── plans/ # Implementation plans and task-level execution notes
- MVP 1 - Core Localization: Video/audio upload, YouTube link import, transcription, English master transcript, subtitle generation, SEO metadata ve manuel export.
- MVP 2 - Brand & Sponsor: Brand template, sponsor script generator, country links ve master approval workflow.
- MVP 3 - Thumbnail: Referans thumbnail, localized hook, AI image generation, varyasyon üretimi ve ZIP export entegrasyonu.
- MVP 4 - YouTube Integration: Google OAuth, encrypted token storage, caption/thumbnail/metadata publishing ve quota-aware fallback.
- MVP 5 - Analytics: YouTube Analytics sync, ülke bazlı dashboard, Country Opportunity Score ve yatırım önerileri.
- MVP 6 - Audio-only Dubbing: TTS provider router, FFmpeg alignment, Web Audio Editor ve YouTube-ready WAV/MP3 export.
- Admin, Billing & Security: Stripe Billing, credit ledger, admin panel, provider health, audit logs ve role-based authorization.
- Cloud Storage Migration: Local VPS storage'dan Cloudflare R2 veya AWS S3 tabanlı object storage'a geçiş.
- Advanced Growth Intelligence: Trend enrichment, cohort analysis, thumbnail A/B test önerileri ve ülke bazlı budget planning.
- Enterprise Media Pipeline: Lip-sync video dubbing, multi-speaker voice mapping ve kurumsal compliance policy engine.
- Operational Hardening: Google OAuth verification, rate limiting, observability dashboards, backup policy ve production incident runbook'ları.
🔒 Repository Status Note: Due to the proprietary nature of the algorithms/commercial considerations, the core source code for this project is maintained in a private repository. This public repository serves as an architectural overview, documentation, and technical showcase of the system.