gpt4free/g4f/__init__.py

from __future__ import annotations
from g4f        import models
from .Provider  import BaseProvider
from .typing    import Any, CreateResult, Union
import random

logging = False

class ChatCompletion:
    @staticmethod
    def create(
        model    : Union[models.Model, str],
        messages : list[dict[str, str]],
        provider : Union[type[BaseProvider], None] = None,
        stream   : bool                            = False,
        auth     : Union[str, None]                = None, **kwargs: Any) -> Union[CreateResult, str]:

        if isinstance(model, str):
            if model in models.ModelUtils.convert:
                model = models.ModelUtils.convert[model]
            else:
                raise Exception(f'The model: {model} does not exist')

        if not provider:
            if isinstance(model.best_provider, list):
                if stream:
                    provider = random.choice([p for p in model.best_provider if p.supports_stream])
                else:
                    provider = random.choice(model.best_provider)
            else:
                provider = model.best_provider

        if not provider:
            raise Exception(f'No provider found')

        if not provider.working:
            raise Exception(f'{provider.__name__} is not working')

        if provider.needs_auth and not auth:
            raise Exception(
                f'ValueError: {provider.__name__} requires authentication (use auth=\'cookie or token or jwt ...\' param)')
            
        if provider.needs_auth:
            kwargs['auth'] = auth

        if not provider.supports_stream and stream:
            raise Exception(
                f'ValueError: {provider.__name__} does not support "stream" argument')

        if logging:
            print(f'Using {provider.__name__} provider')

        result = provider.create_completion(model.name, messages, stream, **kwargs)
        return result if stream else ''.join(result)