§
    l¬¸j  ã                  ót   — d dl mZ d dlZd dlmZ d dlmZ d dlZd dlZ	d dl
mZ d dlmZ  G d„ d¦  «        ZdS )	é    )ÚannotationsN)ÚPath)ÚAny)ÚImage)Úcheck_requirementsc                  ó„   — e Zd ZdZ	 	 	 	 	 ddd„Zdd d„Zd!d„Zdd d„Zd!d„Zd"d„Z	d#d$d„Z
ed%d„¦   «         Zd&d„Zd&d„ZdS )'ÚLLMa7  OpenAI-compatible large language model interface.

    Attributes:
        model (str): Model name sent with each request.
        api (str): API format, either "responses" or "chat.completions".
        base_url (str | None): Optional OpenAI-compatible API base URL.
        prompt (str | None): Optional instruction prepended to scalar text or image inputs.
        overrides (dict): Default arguments passed to each request.
        client (OpenAI | None): Lazily initialized synchronous client.
        async_client (AsyncOpenAI | None): Lazily initialized asynchronous client.

    Methods:
        __call__: Run synchronous inference.
        async_call: Run asynchronous inference.

    Examples:
        >>> from ultralytics import LLM
        >>> model = LLM("gpt-5.6-luna")
        >>> response = model("What is YOLO?")

        Analyze an image:
        >>> response = model("Describe this image", image="bus.jpg")

        Use the Chat Completions API:
        >>> model = LLM("gpt-5.6-luna", api="chat.completions")
        >>> response = model("What is YOLO?")
    úgpt-5.6-lunaÚ	responsesNÚmodelÚstrÚapiÚbase_urlú
str | NoneÚapi_keyÚpromptÚkwargsr   ÚreturnÚNonec                ó¤   — |dvrt          d|›d�¦  «        ‚|| _        || _        || _        || _        || _        d| _        d| _        || _        dS )aû  Initialize an OpenAI-compatible LLM.

        Args:
            model (str): Model name.
            api (str): API format, either "responses" or "chat.completions".
            base_url (str, optional): OpenAI-compatible API base URL.
            api_key (str, optional): API key. Defaults to the OPENAI_API_KEY environment variable.
            prompt (str, optional): Instruction prepended to scalar text or image inputs.
            **kwargs (Any): Default arguments passed to each API request.
        >   úchat.completionsr   zUnsupported API format z(. Use 'responses' or 'chat.completions'.N)	Ú
ValueErrorr   r   r   r   Ú	overridesÚclientÚasync_clientÚ_api_key)Úselfr   r   r   r   r   r   s          úf/root/private/project/pallet_detection_v2/.venv/lib/python3.11/site-packages/ultralytics/models/llm.pyÚ__init__zLLM.__init__-   sg   € ð& Ð7Ð7Ð7ÝÐf°sÐfÐfÐfÑgÔgÐgàˆŒ
ØˆŒØ ˆŒØˆŒØˆŒØˆŒØ ˆÔØˆŒˆˆó    ÚsourceÚimagec                óV   — |                       |                      ||¦  «        |¦  «        S )z(Run inference with the configured model.)Ú_callÚ_prepare©r   r!   r"   r   s       r   Ú__call__zLLM.__call__L   s$   € à�zŠz˜$Ÿ-š-¨°Ñ6Ô6¸Ñ?Ô?Ð?r    údict[str, Any]c                ó¾   — |                       ||¦  «        }|                      ¦   «         }| j        dk    r |j        j        di |¤Žn |j        j        j        di |¤ŽS )z3Send prepared input through the synchronous client.r   © )Ú_requestÚ_get_clientr   r   ÚcreateÚchatÚcompletions©r   r!   r   Úrequestr   s        r   r$   z	LLM._callP   sp   € à—-’- ¨Ñ/Ô/ˆØ×!Ò!Ñ#Ô#ˆà26´(¸kÒ2IÐ2IÐ#ˆFÔÔ#Ð.Ð. gÐ.Ð.Ð.ÐOmÈvÌ{ÔOfÔOmÐOxÐOxÐpwÐOxÐOxð	
r    c              ‹  óf   K  — |                       |                      ||¦  «        |¦  «        ƒ d{V —†S )z5Run asynchronous inference with the configured model.N)Ú_async_callr%   r&   s       r   Ú
async_callzLLM.async_callX   s<   è è € à×%Ò% d§m¢m°F¸EÑ&BÔ&BÀFÑKÔKÐKÐKÐKÐKÐKÐKÐKr    c              ƒ  óÚ   K  — |                       ||¦  «        }|                      ¦   «         }| j        dk    r |j        j        di |¤Žƒ d{V —†n |j        j        j        di |¤Žƒ d{V —†S )z4Send prepared input through the asynchronous client.r   Nr*   )r+   Ú_get_async_clientr   r   r-   r.   r/   r0   s        r   r3   zLLM._async_call\   s›   è è € à—-’- ¨Ñ/Ô/ˆØ×'Ò'Ñ)Ô)ˆð Œx˜;Ò&Ð&ð *�&Ô"Ô)Ð4Ð4¨GÐ4Ð4Ð4Ð4Ð4Ð4Ð4Ð4Ð4à5�v”{Ô.Ô5Ð@Ð@¸Ð@Ð@Ð@Ð@Ð@Ð@Ð@Ð@ð	
r    c                ó”   — d| j         i| j        ¥|¥}| j        dk    r|�||d<   n"|� t          |t          ¦  «        rd|dœgn||d<   |S )ai  Build a Responses or Chat Completions request.

        Args:
            source (Any, optional): Responses input or chat messages. Strings become a user message for Chat
                Completions.
            kwargs (dict): Request arguments overriding constructor defaults.

        Returns:
            (dict): Native OpenAI SDK request arguments.
        r   r   NÚinputÚuser©ÚroleÚcontentÚmessages)r   r   r   Ú
isinstancer   )r   r!   r   r1   s       r   r+   zLLM._requestf   sq   € ð ˜DœJÐC¨$¬.ÐC¸FÐCˆØŒ8�{Ò"Ð"ØÐ!Ø#)�˜Ñ øØÐÝKUÐV\Õ^aÑKbÔKbÐ"n¨F¸vÐ#FÐ#FÐ"GÐ"GÐhnˆG�JÑØˆr    c                óˆ  — |€c|€| j         S t          |t          t          t          f¦  «        r|S t          |t
          ¦  «        r| j         r| j         › d|› �n|S |}| j         pd}n |pd}| j         r|r| j         › d|› �n| j         }|                      |¦  «        }| j        dk    rdd|dœd|d	œgd
œgS dd|dœdd|id	œgd
œgS )zNNormalize scalar text or image input while preserving native message payloads.Nz

zDescribe the image.r   r9   Ú
input_text)ÚtypeÚtextÚinput_image)rA   Ú	image_urlr:   rB   rD   Úurl)r   r>   ÚlistÚtupleÚdictr   Ú
_image_urlr   )r   r!   r"   r   rD   s        r   r%   zLLM._preparey   s=  € àˆ=Øˆ~Ø”{Ð"Ý˜&¥4­µÐ"5Ñ6Ô6ð Ø�Ý˜&¥#Ñ&Ô&ð OØ7;´{ÐN˜$œ+Ð3Ð3¨6Ð3Ð3Ð3ÈÐNØˆEØ”[Ð9Ð$9ˆFˆFàÐ4Ð4ˆFØŒ{ð QØ9?ÐP˜DœKÐ5Ð5¨VÐ5Ð5Ð5ÀTÄ[�Ø—O’O EÑ*Ô*ˆ	ØŒ8�{Ò"Ð"ð #à!-°vÐ>Ð>Ø!.¸YÐGÐGð ðð ðð ð à#¨VÐ4Ð4Ø(¸¸yÐ7IÐJÐJððð ð
ð 	
r    c                óˆ  — t          | t          ¦  «        r|                      d¦  «        r| S t          | t          t          f¦  «        r"t	          j        t          | ¦  «        ¦  «        }nrt          | t          j        ¦  «        rDt	          j        t          j	        |  
                    d¦  «        ¦  «        t          j        ¦  «        nt          j	        | ¦  «        }|€t          d| ›d�¦  «        ‚t	          j        d|¦  «        \  }}|st          d¦  «        ‚dt          j        |¦  «                             ¦   «         › �S )	z<Convert an image URL, path, or array to an OpenAI image URL.)zhttp://zhttps://zdata:image/ÚRGBNzUnable to read image source ú.z.jpgz&Unable to encode image source as JPEG.zdata:image/jpeg;base64,)r>   r   Ú
startswithr   Úcv2Úimreadr   ÚcvtColorÚnpÚasarrayÚconvertÚCOLOR_RGB2BGRr   ÚimencodeÚbase64Ú	b64encodeÚdecode)r!   r"   ÚsuccessÚbuffers       r   rI   zLLM._image_url�   s#  € õ �f�cÑ"Ô"ð 	 v×'8Ò'8Ð9_Ñ'`Ô'`ð 	ØˆMÝ�f�s¥D˜kÑ*Ô*ð 	Ý”J�s 6™{œ{Ñ+Ô+ˆEˆEõ ˜f¥e¤kÑ2Ô2ð(•”�RœZ¨¯ª°uÑ(=Ô(=Ñ>Ô>ÅÔ@QÑRÔRÐRå”Z Ñ'Ô'ð ð
 ˆ=ÝÐG¸FÐGÐGÐGÑHÔHÐHÝœ, v¨uÑ5Ô5‰ˆ�Øð 	GÝÐEÑFÔFÐFØL­Ô)9¸&Ñ)AÔ)A×)HÒ)HÑ)JÔ)JÐLÐLÐLr    c                ó¸   — | j         €Mt          d¦  «         ddlm} d„ | j        | j        dœ                     ¦   «         D ¦   «         } |di |¤Ž| _         | j         S )z,Create the OpenAI client on first inference.Núopenai>=2.0.0r   )ÚOpenAIc                ó   — i | ]
\  }}|®||“ŒS ©Nr*   ©Ú.0ÚkÚvs      r   ú
<dictcomp>z#LLM._get_client.<locals>.<dictcomp>·   ó$   € ÐvÐvÐv™t˜q !ÐhiÐhu�a˜ÐhuÐhuÐhur    ©r   r   r*   )r   r   Úopenair]   r   r   Úitems)r   r]   r   s      r   r,   zLLM._get_client±   st   € àŒ;ÐÝ˜Ñ/Ô/Ð/Ø%Ð%Ð%Ð%Ð%Ð%àvÐv°4´=ÈdÌmÐ'\Ð'\×'bÒ'bÑ'dÔ'dÐvÑvÔvˆFØ ˜&Ð*Ð* 6Ð*Ð*ˆDŒKØŒ{Ðr    c                ó¸   — | j         €Mt          d¦  «         ddlm} d„ | j        | j        dœ                     ¦   «         D ¦   «         } |di |¤Ž| _         | j         S )z9Create the asynchronous OpenAI client on first inference.Nr\   r   )ÚAsyncOpenAIc                ó   — i | ]
\  }}|®||“ŒS r_   r*   r`   s      r   rd   z)LLM._get_async_client.<locals>.<dictcomp>Á   re   r    rf   r*   )r   r   rg   rj   r   r   rh   )r   rj   r   s      r   r6   zLLM._get_async_client»   sw   € àÔÐ$Ý˜Ñ/Ô/Ð/Ø*Ð*Ð*Ð*Ð*Ð*àvÐv°4´=ÈdÌmÐ'\Ð'\×'bÒ'bÑ'dÔ'dÐvÑvÔvˆFØ + Ð 5Ð 5¨fÐ 5Ð 5ˆDÔØÔ Ð r    )r
   r   NNN)r   r   r   r   r   r   r   r   r   r   r   r   r   r   )NN)r!   r   r"   r   r   r   r   r   )r!   r   r   r(   r   r   )r!   r   r   r(   r   r(   r_   )r!   r   r"   r   r   r   )r!   r   r   r   )r   r   )Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   r'   r$   r4   r3   r+   r%   ÚstaticmethodrI   r,   r6   r*   r    r   r	   r	      s&  € € € € € ðð ð< $ØØ#Ø"Ø!ð ð  ð  ð  ð  ð>@ð @ð @ð @ð @ð
ð 
ð 
ð 
ðLð Lð Lð Lð Lð
ð 
ð 
ð 
ðð ð ð ð&"
ð "
ð "
ð "
ð "
ðH ðMð Mð Mñ „\ðMð&ð ð ð ð!ð !ð !ð !ð !ð !r    r	   )Ú
__future__r   rV   Úpathlibr   Útypingr   rN   ÚnumpyrQ   ÚPILr   Úultralytics.utils.checksr   r	   r*   r    r   ú<module>rw      s»   ðð #Ð "Ð "Ð "Ð "Ð "à €€€Ø Ð Ð Ð Ð Ð Ø Ð Ð Ð Ð Ð à 
€
€
€
Ø Ð Ð Ð Ø Ð Ð Ð Ð Ð à 7Ð 7Ð 7Ð 7Ð 7Ð 7ðs!ð s!ð s!ð s!ð s!ñ s!ô s!ð s!ð s!ð s!r    