[F2-10] Proveedor OpenAI (texto, voz, imagen) #38

Fase: F2 · Tamaño: M · Depende de: #32 (F2-07)
Decisiones: D-17 en #1

Objetivo

Que el usuario pueda usar su clave de OpenAI para texto, narración e imágenes.

Alcance

• SDK oficial openai.
• Text: salida estructurada estricta (response_format: json_schema) a partir del zod.
• TTS: listVoices con las voces del modelo TTS elegido; synthesize con instrucciones de estilo si el modelo las admite (inlineDirections en el catálogo); salida mp3.
• Image: generación en vertical (el tamaño más cercano a 9:16 que admita el modelo; el recorte final lo hace el montaje, [F2-04] Montaje slideshow: imágenes con Ken Burns + voz + música → MP4 9:16 #31).
• Mapeo de errores a ProviderError (incluida la moderación de OpenAI → safety).
• Catálogo con los modelos vigentes y sus precios, verificados en la documentación oficial al implementar (fecha en priceReviewedAt).
• validateKey: listar modelos.

Criterios de aceptación

• Pasa la suite de contrato ([F2-07] Interfaz de proveedores de IA, registro y suite de contrato #32) con fixtures grabados.
• Test: un error de moderación simulado produce ProviderError('safety').
• Test opcional con clave real (OPENAI_TEST_KEY), excluido de CI por defecto: texto, 5 s de voz y una imagen.