ai_providers library

🎯 AI PROVIDERS PLUGIN - RESTRICTED ACCESS API

🚨 IMPORTANTE: Este plugin ahora SOLO expone la API AI.* No se puede acceder directamente a managers, services o registry.

✅ ÚNICO USO PERMITIDO:

import 'package:ai_providers/ai_providers.dart';

// 🎯 API Ultra-Limpia - ÚNICA FORMA DE USAR AI
final textResponse = await AI.text(history, context);
final audioResponse = await AI.speak('¡Hola mundo!');
final imageResponse = await AI.image('Un gato espacial');
final transcription = await AI.listen(audioFile);
final chatResponse = await AI.chat(message, profile);

❌ YA NO PERMITIDO:

// ❌ PROHIBIDO - No se exporta AIProviderManager
final manager = AIProviderManager.instance; // COMPILE ERROR

// ❌ PROHIBIDO - No se exportan services individuales
final service = TextGenerationService(); // COMPILE ERROR

// ❌ PROHIBIDO - No se exporta registry
final registry = ProviderRegistry.instance; // COMPILE ERROR

Classes

AI
🎯 Clase AI - API Principal Ultra-Directa
AiAudio
Modelo de audio generado por proveedores de IA.
AiAudioEmotion
Constantes para emociones comunes en síntesis de voz.
AiAudioFormat
Constantes para formatos de audio de salida final.
AiAudioParams
Parámetros específicos para síntesis de voz (TTS - Text-to-Speech).
AICapabilityUtils
Utility class for working with AI capabilities
AiImage
Modelo de imagen generado por proveedores de IA.
AiImageAspectRatio
Constantes para relaciones de aspecto válidas.
AiImageBackground
Constantes para tipos de fondo de imagen.
AiImageFidelity
Constantes para niveles de fidelidad en ediciones.
AiImageFormat
Constantes para formatos de imagen válidos.
AiImageParams
Parámetros específicos para generación de imágenes con validación tipada.
AiImageQuality
Constantes para niveles de calidad de imagen.
AIInitConfig
Configuration model for initializing AI Providers system from external sources. This model is designed to be simple and focused only on what ai_providers needs.
AIProvider
Simple AI Provider model for public API exposure.
AIResponse
Respuesta unificada de proveedores de IA.
AISystemPrompt
Generic AI context that works with any AI application. No external dependencies - completely self-contained.
AudioPlaybackConfig
Configuración para la reproducción de audio
AudioPlaybackResult
Resultado de una operación de reproducción de audio
AudioRecordingResult
Resultado de una operación de grabación de audio
HybridConversationService
🎙️ HybridConversationService
ProviderResponse
Internal response returned by providers to the AIProviderManager.
SynthesisResult
Resultado de una operación de síntesis de voz
VoiceInfo
Representa una voz disponible en un provider de AI
VoiceSettings
Configuración específica para síntesis de voz

Enums

AICapability
Enumeration of AI capabilities that providers can support.
AudioMode
Enumeración para los diferentes modos de audio soportados
AudioPlaybackState
Estados posibles para la reproducción de audio
HybridConversationState
Estados de la conversación híbrida
VoiceAge
Edades de voz disponibles
VoiceEmotion
Emociones que puede expresar una voz
VoiceGender
Géneros de voz disponibles

Extensions

AICapabilityExtension on AICapability
Extension methods for AICapability enum
AudioModeExtension on AudioMode
Extensión para AudioMode con funcionalidades útiles

Exceptions / Errors

AudioException
Excepción base para operaciones de audio
AudioFileException
Excepción específica para archivos de audio
AudioPermissionException
Excepción para problemas de permisos de audio
AudioPlaybackException
Excepción para problemas de reproducción de audio
AudioRecorderException
Excepción para problemas de grabación de audio
VoiceSynthesisException
Excepción para problemas de síntesis de voz