Helper Reference

Tum helper dosyalari ve public fonksiyonlari.

kling_helper.py

Kling AI Direct API video uretimi (fal.ai yerine dogrudan API).

from app.kling_helper import KlingHelper

kling = KlingHelper()

# Video uret (Kling 3.0 Pro)
result = await kling.generate_video(
    prompt="...",
    duration=10,              # 5, 10, 15 saniye
    aspect_ratio="9:16",
    model_name="kling-v3",
    mode="pro",
    negative_prompt="blur, distort, low quality",
    cfg_scale=0.5,
    generate_audio=True       # Native audio
)
# Returns: {success, video_path, video_id, duration, model}

# Base URL: https://api-singapore.klingai.com
# Auth: JWT (HS256) with KLING_ACCESS_KEY / KLING_SECRET_KEY

nanobananahelper.py

fal-ai/nano-banana-pro (via fal.ai) ile infographic/carousel uretimi (HTML template'lerin yerini aldi).

from app.nano_banana_helper import (
    generate_infographic,
    generate_carousel_slides,
    add_logo_overlay
)

# Tek infographic
result = await generate_infographic(topic, post_text)
# Returns: {success, image_path}

# Carousel slide'lari
slides = await generate_carousel_slides(topic, slide_data, count=5)
# Returns: [{success, image_path}, ...]

# Logo overlay
add_logo_overlay(image_path, position="bottom_left", logo_scale=0.12)

video_models.py

Video model konfigurasyonlari (3 model).

from app.video_models import (
    get_model_config, get_available_models,
    get_model_durations, get_max_duration,
    validate_duration, should_disable_audio
)

models = get_available_models()
# ["sora-2", "sora-2-pro", "kling-3.0-pro"]

config = get_model_config("kling-3.0-pro")
# {name, provider, durations, default_duration, max_duration, ...}

duration = validate_duration("kling-3.0-pro", 20)  # -> 15 (clamped)
disable = should_disable_audio("kling-3.0-pro", voice_mode=True)  # -> True

video_styles.py

Gorsel stil sistemi (10 stil).

from app.video_styles import VIDEO_STYLES, get_style_config

# 10 stil: cinematic_4k, anime, cartoon_3d, watercolor, 3d_render,
#          pixel_art, comic_book, claymation, minimalist, neon_cyberpunk

style = get_style_config("cinematic_4k")
# -> {character_descriptions, scene_settings, voice_type}

flux_helper.py

FLUX.2 Pro gorsel uretimi.

generate_image_flux(prompt, width=1024, height=1024, output_format="png") -> Dict
# Returns: {success, image_path, duration, cost}

get_credits() -> Dict
# Returns: {success, credits}

cloudinary_helper.py

Video CDN yonetimi.

configure_cloudinary() -> bool
upload_video_to_cloudinary(video_path, folder="olivenet-reels") -> Dict
# Returns: {success, url, public_id, duration}

delete_from_cloudinary(public_id) -> Dict
# Returns: {success}

instagram_helper.py

Instagram Graph API v21.0.

get_account_info() -> Dict
post_photo_to_instagram(image_url, caption) -> str  # post_id
post_video_to_instagram(video_url, caption) -> str  # post_id
post_carousel_to_instagram(image_urls, caption) -> str  # post_id
post_reels_to_instagram(video_path, caption) -> Dict
convert_video_for_instagram(video_path) -> Dict
get_media_insights(media_id) -> Dict
get_recent_media(limit=10) -> List
upload_image_to_cdn(image_path) -> str  # public URL

insights_helper.py

Instagram Analytics.

get_instagram_account_info() -> Dict
get_instagram_media_type(media_id) -> Dict
get_instagram_reels_insights(media_id) -> Dict
get_instagram_image_insights(media_id) -> Dict
get_instagram_insights() -> List  # Son 10 post
get_best_performing_content() -> List  # Top 20
sync_insights_to_database() -> int  # Guncellenen post sayisi

sora_helper.py

OpenAI Sora video uretimi.

generate_video_sora(prompt, duration=8, size="720x1280", model="sora-2") -> Dict
# Returns: {success, video_path, video_id, model, file_size_mb}

analyze_prompt_complexity(prompt, topic="") -> Dict
# Returns: {complexity, model, duration}

generate_video_smart(prompt, topic="", force_model=None, duration=8) -> Dict
# Otomatik model secimi + fallback
# Returns: {success, video_path, model_used}

openaittshelper.py

OpenAI TTS (Turkce seslendirme, gpt-4o-mini-tts).

generate_speech_with_retry(text, voice_id=None, max_retries=3) -> Dict
# Returns: {success, audio_path, duration_seconds}
generate_dialog_audio(dialog_lines, male_voice_id=None, female_voice_id=None) -> Dict
# Returns: {success, audio_path, total_duration, audio_segments}

claude_helper.py

Claude CLI wrapper.

run_claude_code(prompt, timeout=60) -> str
generate_post_text(topic) -> str

renderer.py

HTML -> PNG rendering (carousel slide'lari icin hala kullaniliyor).

render_html_to_png(html_content, output_path=None, width=1080, height=1080) -> str
save_html_and_render(html_content, base_name=None) -> Tuple[str, str]
get_browser() -> Browser
close_browser() -> None

config.py

Konfigürasyon ve ayarlar.

settings.telegram_bot_token
settings.telegram_admin_chat_id
settings.instagram_access_token
settings.instagram_user_id
settings.flux_api_key
settings.openai_api_key
settings.kling_access_key       # Kling Direct API
settings.kling_secret_key       # Kling Direct API
settings.cloudinary_cloud_name

# Paths
settings.base_dir
settings.context_dir
settings.templates_dir
settings.outputs_dir
settings.database_path

Dosya Konumlari

Silinen Helper'lar (v2'de yok)

• falhelper.py → Kling: klinghelper.py (Direct API)
• geminihelper.py → Gorsel: nanobanana_helper.py (fal-ai/nano-banana-pro)