Helper Reference

Tum helper dosyalari ve public fonksiyonlari.

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
# Cloudinary SDK'yi baslat

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.

# Hesap
get_account_info() -> Dict
# Returns: {username, followers_count, media_count}

# Yayinlama
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
# Returns: {success, id}

# Video donusum
convert_video_for_instagram(video_path) -> Dict
# Returns: {success, output_path, converted}

# Insights
get_media_insights(media_id) -> Dict
get_recent_media(limit=10) -> List

# CDN upload
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
# Returns: {media_type, media_product_type, is_reels}

get_instagram_reels_insights(media_id) -> Dict
# Returns: plays, reach, saves, shares, engagement_rate

get_instagram_image_insights(media_id) -> Dict
# Returns: impressions, reach, saves, likes, engagement_rate

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}
# complexity: high -> sora-2-pro, medium -> sora-2, low -> veo3

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

veo_helper.py

Google Veo video uretimi.

generate_video_veo3(prompt, aspect_ratio="9:16", duration_seconds=8) -> Dict
# Returns: {success, video_path, file_size_mb, model, duration}

generate_video_with_retry(prompt, max_retries=2) -> Dict
# Retry mekanizmali versiyon

gemini_helper.py (devre disi)

Google Gemini gorsel uretimi. Aktif degil, FLUX tercih ediliyor.

generate_realistic_image(topic, post_text, output_dir) -> str  # filepath
create_image_prompt(topic, post_text) -> str  # Ingilizce prompt
test_gemini_connection() -> Dict

claude_helper.py

Claude CLI wrapper ve template generation.

# CLI
run_claude_code(prompt, timeout=60) -> str
# Claude CLI calistir, response dondur

# Icerik
generate_post_text(topic) -> str
# Sosyal medya post metni olustur

# Template generation (HTML)
generate_dashboard_html(data) -> str
generate_feature_grid_html(data) -> str
generate_timeline_html(data) -> str
generate_before_after_html(data) -> str
generate_comparison_html(data) -> str
generate_quote_html(data) -> str
generate_billboard_html(data) -> str
generate_big_number_html(data) -> str
generate_process_html(data) -> str
generate_checklist_html(data) -> str

renderer.py

HTML -> PNG rendering.

render_html_to_png(html_content, output_path=None, width=1080, height=1080) -> str
# Returns: PNG dosya yolu

render_html_file_to_png(html_path, output_path=None) -> str
# HTML dosyasindan render

save_html_and_render(html_content, base_name=None) -> Tuple[str, str]
# Returns: (html_path, png_path)

get_browser() -> Browser  # Playwright browser
close_browser() -> None
cleanup() -> 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.gemini_api_key
settings.flux_api_key
settings.openai_api_key
settings.cloudinary_cloud_name

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

# Timeouts
settings.claude_timeout_post  # 60s
settings.claude_timeout_visual  # 90s
settings.api_timeout_video  # 300s

# Thresholds
settings.min_review_score  # 7.0
settings.max_instagram_words  # 120

Dosya Konumlari

Helper	Konum
flux_helper.py	app/flux_helper.py
cloudinary_helper.py	app/cloudinary_helper.py
instagram_helper.py	app/instagram_helper.py
insights_helper.py	app/insights_helper.py
sora_helper.py	app/sora_helper.py
veo_helper.py	app/veo_helper.py
gemini_helper.py	app/gemini_helper.py
claude_helper.py	app/claude_helper.py
renderer.py	app/renderer.py
config.py	app/config.py