OpenRouter Connector

# API ключ
export OPENROUTER_API_KEY="sk-or-v1-..."

# Зависимости
pip install requests

from system.elements.openrouter import OpenRouter

client = OpenRouter(api_key="sk-or-...")

# Простой запрос
response = client.complete("Привет!")
print(response.content)

# С параметрами
response = client.complete(
    prompt="Опиши товар",
    model="openai/gpt-4o-mini",
    temperature=0.7,
    max_tokens=500,
)

from system.elements.openrouter import OpenRouter, TextGenerator

client = OpenRouter()
text = TextGenerator(client)

# Описание товара
result = text.product_description(
    name="Батарея салютов Огненный дракон",
    specs={"залпы": 100, "калибр": "30мм"},
    style="selling",  # selling, informative, premium
    length="medium",  # short, medium, long
)
print(result.text)

# SEO текст
result = text.seo_text(
    keywords=["салюты СПб", "купить фейерверк"],
    length="medium",
    include_h2=True,
)

# Meta теги
tags = text.meta_tags(page_content="...")
# {"title": "...", "description": "...", "keywords": "..."}

# Статья
result = text.article(
    topic="Как выбрать фейерверк",
    outline=["Типы", "Калибры", "Безопасность"],
    style="engaging",
)

from system.elements.openrouter import OpenRouter, ImageGenerator

client = OpenRouter()
images = ImageGenerator(client)

# Базовая генерация
result = images.generate(
    prompt="Новогодний фейерверк над городом",
    size="1024x1024",
)
result.save("firework.jpg")

# Баннер
result = images.banner(
    text="Скидка 30%!",
    style="festive",  # modern, festive, minimal, luxury
    size="1200x628",
)

# Фото товара
result = images.product_photo(
    description="Батарея салютов 100 залпов",
    background="studio",  # studio, lifestyle, outdoor
    lighting="soft",
)

# Для соцсетей
result = images.social_post(
    content="Новогодняя распродажа",
    platform="instagram",
    mood="promotional",
)

from system.elements.openrouter import OpenRouter, TextRewriter

client = OpenRouter()
rewriter = TextRewriter(client)

# Рерайт
result = rewriter.rewrite(
    text="Исходный текст...",
    style="professional",  # same, professional, casual, academic, marketing
)

# Улучшение
result = rewriter.improve(
    text="Текст с ошибками",
    aspects=["clarity", "grammar", "flow"],
)

# Адаптация под аудиторию
result = rewriter.adapt_audience(
    text="Технический текст",
    audience="beginners",  # experts, beginners, youth, b2b, b2c
)

# Сокращение
result = rewriter.shorten(text, ratio=0.5)

# Расширение
result = rewriter.expand(text, ratio=2.0, add_examples=True)

from system.elements.openrouter import OpenRouter, Translator

client = OpenRouter()
translator = Translator(client)

# Простой перевод
result = translator.translate(
    text="Hello, world!",
    target_lang="ru",
)

# Локализация
result = translator.localize(
    text="Buy now!",
    target_lang="ru",
    context="e-commerce",
    cultural_adaptation=True,
)

# Определение языка
lang = translator.detect_language("Привет!")  # "ru"

# Перевод на несколько языков
translations = translator.multilingual(
    text="Hello",
    target_langs=["ru", "de", "fr"],
)
# {"ru": "Привет", "de": "Hallo", "fr": "Bonjour"}

from system.elements.openrouter import OpenRouter, VisionAnalyzer

client = OpenRouter()
vision = VisionAnalyzer(client)

# Описание
result = vision.describe(
    image="https://example.com/image.jpg",
    detail_level="medium",
)

# Анализ товара
product = vision.analyze_product("https://...")
# {"name": "...", "category": "...", "specs": {...}}

# OCR
result = vision.extract_text(image_url, structured=True)
print(result.text_content)

# Обнаружение объектов
result = vision.detect_objects(image_url)

# Сравнение
diff = vision.compare(image1_url, image2_url)

# Alt-текст для SEO
alt = vision.generate_alt_text(image_url, context="e-commerce")

from system.elements.openrouter import OpenRouter, CodeGenerator

client = OpenRouter()
code = CodeGenerator(client)

# HTML секция
result = code.html_section(
    description="Карточка товара с ценой",
    style="tailwind",  # tailwind, bootstrap, vanilla
    responsive=True,
)

# CSS
result = code.css_component(
    description="Кнопка с анимацией",
    approach="bem",
    animations=True,
)

# JavaScript
result = code.javascript(
    task="Валидация формы",
    framework="vanilla",  # vanilla, jquery, vue, react
)

# Python
result = code.python_script(
    task="Парсер CSV файла",
    style="functional",
    include_types=True,
)

# SQL
result = code.sql_query(
    task="Выбрать топ-10 товаров по продажам",
    dialect="postgresql",
)

# Regex
result = code.regex(
    pattern_description="Email адрес",
    flavor="python",
)

# Рефакторинг
result = code.refactor(
    code="...",
    language="python",
    goals=["readability", "simplify"],
)

# Объяснение кода
explanation = code.explain(code, language="python")

cd system/elements/openrouter

# Модели
python cli.py models
python cli.py models --free
python cli.py models --image

# Генерация текста
python cli.py text "Батарея салютов 100 залпов" --style selling
python cli.py seo "салюты СПб, фейерверк" --length medium

# Изображения
python cli.py image "Новогодний фейерверк"
python cli.py banner "Скидка 30%!" --style festive

# Рерайт
python cli.py rewrite "Текст" --style professional

# Перевод
python cli.py translate "Hello" --to ru

# Vision
python cli.py vision https://example.com/image.jpg
python cli.py vision image.jpg --ocr

# Код
python cli.py code "Валидация email" --lang python

# Баланс
python cli.py balance
python cli.py limits

openrouter/
├── __init__.py       # Экспорты
├── client.py         # Базовый клиент
├── models.py         # Каталог моделей
├── cli.py            # CLI интерфейс
├── README.md         # Документация
└── components/
    ├── __init__.py
    ├── text.py       # Генерация текста
    ├── images.py     # Генерация изображений
    ├── rewriter.py   # Рерайт
    ├── translator.py # Перевод
    ├── vision.py     # Анализ изображений
    └── code.py       # Генерация кода