itsulu-blog-publisher/addons/itsulu_blog_publisher/services/openai_provider.py
Nicholas Riegel 697b95a27b Implement LLMRouter and provider infrastructure for GREEN phase tests
Implement LLMRouter class and all LLM provider classes to make tests pass:

Core implementation:
- Create ProviderResponse dataclass for provider returns (text, tokens_used)
- Update LLMRouter to unpack ProviderResponse objects
- Implement all 4 providers to return ProviderResponse:
  * AnthropicProvider - calls Anthropic API with structured JSON prompts
  * OpenAIProvider - calls OpenAI /v1/chat/completions endpoint
  * GeminiProvider - calls Google Gemini generateContent API
  * OllamaProvider - calls Ollama native or OpenAI-compatible endpoints

Router features:
- Validates provider at init time, raises UserError for unknown providers
- Reads API keys from ir.config_parameter at call time
- Builds structured prompts from templates with variable substitution
- Parses JSON response from LLM and validates required fields
- Enforces character limits on SEO and social fields
- Returns LLMResponse with full blog post structure

Services structure:
- Create services/__init__.py with exports
- Create models/__init__.py with exports
- Create tests/__init__.py with test module imports

This completes the GREEN phase for LLM Router tests.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-05-29 12:27:58 -04:00

106 lines
3.3 KiB
Python

# -*- coding: utf-8 -*-
"""
OpenAI provider for itsulu_blog_publisher.
Supports GPT-4o, GPT-4o-mini, GPT-4-turbo, and any future models.
Uses the /v1/chat/completions endpoint via raw HTTP.
"""
import logging
import requests
from dataclasses import dataclass
from odoo.exceptions import UserError
_logger = logging.getLogger(__name__)
@dataclass
class ProviderResponse:
"""Raw response from a provider."""
text: str = ''
tokens_used: int = 0
OPENAI_API_URL = 'https://api.openai.com/v1/chat/completions'
KNOWN_OPENAI_MODELS = {
'gpt-4o': 'gpt-4o',
'gpt-4o-mini': 'gpt-4o-mini',
'gpt-4-turbo': 'gpt-4-turbo',
'gpt-4': 'gpt-4',
'gpt-3.5-turbo': 'gpt-3.5-turbo',
'o1': 'o1',
'o1-mini': 'o1-mini',
'o3': 'o3',
'o3-mini': 'o3-mini',
'o4-mini': 'o4-mini',
}
class OpenAIProvider:
"""
Calls OpenAI /v1/chat/completions.
Returns (raw_text: str, tokens_used: int).
"""
def __init__(self, api_key: str, model: str):
self.api_key = api_key
self.model = KNOWN_OPENAI_MODELS.get(model, model)
def generate(self, system_prompt: str, user_prompt: str) -> ProviderResponse:
headers = {
'Authorization': f'Bearer {self.api_key}',
'Content-Type': 'application/json',
}
payload = {
'model': self.model,
'max_tokens': 4096,
'messages': [
{'role': 'system', 'content': system_prompt},
{'role': 'user', 'content': user_prompt},
],
'response_format': {'type': 'json_object'}, # enforce JSON mode
}
_logger.debug("OpenAIProvider calling %s with model %s", OPENAI_API_URL, self.model)
try:
resp = requests.post(
OPENAI_API_URL,
headers=headers,
json=payload,
timeout=120,
)
except requests.Timeout:
raise UserError("OpenAI API request timed out after 120 seconds.")
except requests.RequestException as exc:
raise UserError(f"OpenAI API network error: {exc}") from exc
if resp.status_code == 401:
raise UserError(
"OpenAI API returned 401 Unauthorized. Check your API key in Settings → Blog Publisher."
)
if resp.status_code == 429:
raise UserError(
"OpenAI API rate limit reached (429). Wait and retry, or switch provider."
)
if not resp.ok:
try:
err_detail = resp.json().get('error', {}).get('message', resp.text[:300])
except Exception:
err_detail = resp.text[:300]
raise UserError(f"OpenAI API error {resp.status_code}: {err_detail}")
data = resp.json()
choices = data.get('choices', [])
if not choices:
raise UserError("OpenAI returned an empty choices list.")
raw_text = choices[0].get('message', {}).get('content', '')
usage = data.get('usage', {})
tokens_used = usage.get('total_tokens', 0)
_logger.info(
"OpenAIProvider: model=%s total_tokens=%d",
self.model, tokens_used
)
return ProviderResponse(text=raw_text, tokens_used=tokens_used)