Skip to content

DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.

1.4 KB
Raw Blame
"""Resolved runtime configuration for image-generation providers.

This dataclass is the read-side adapter between the model catalog
(``services.imagegen``) and the HTTP adapter. It mirrors the shape of
:class:`TTSConfig` so a single OpenAI-compatible adapter can cover OpenAI
DALL·E / gpt-image, Volcengine Ark Seedream and compatible gateways by swapping
``base_url`` + ``api_key`` + ``model``.
"""

from __future__ import annotations

from dataclasses import dataclass, field

from deeptutor.services.generation_http import AUTH_BEARER


@dataclass(slots=True)
class ImagegenConfig:
    """Resolved text-to-image configuration for one generation call."""

    model: str
    provider_name: str = "openai"
    adapter: str = "openai_compat"
    auth_style: str = AUTH_BEARER
    api_key: str = ""
    base_url: str = ""
    api_version: str | None = None
    extra_headers: dict[str, str] = field(default_factory=dict)
    # Provider/model-specific generation knobs. Empty → omit from the request
    # and let the provider use its default.
    size: str = ""  # e.g. "1024x1024"
    quality: str = ""  # e.g. "standard" | "hd"
    style: str = ""  # e.g. "natural" | "vivid"
    response_format: str = ""  # "" | "url" | "b64_json"
    # Image generation is slow; allow generous wall-clock per request.
    request_timeout: int = 120
    poll_interval: float = 2.0
    poll_timeout: int = 300


__all__ = ["ImagegenConfig"]