# centml.py (updated) # Copyright (c) Meta Platforms, Inc. and affiliates. # All rights reserved. # # This source code is licensed under the terms described in the LICENSE file in # the root directory of this source tree. from typing import AsyncGenerator, List, Optional, Union from openai import OpenAI from pydantic import parse_obj_as from llama_models.datatypes import CoreModelId from llama_models.llama3.api.chat_format import ChatFormat from llama_models.llama3.api.tokenizer import Tokenizer from llama_stack.apis.common.content_types import InterleavedContent from llama_stack.apis.inference import ( ChatCompletionRequest, ChatCompletionResponse, CompletionRequest, CompletionResponse, EmbeddingsResponse, Inference, LogProbConfig, Message, ResponseFormat, ResponseFormatType, SamplingParams, ToolChoice, ToolConfig, ToolDefinition, ToolPromptFormat, ) from llama_stack.distribution.request_headers import NeedsRequestProviderData from llama_stack.providers.utils.inference.model_registry import ( build_model_entry, ModelRegistryHelper, ) from llama_stack.providers.utils.inference.openai_compat import ( convert_message_to_openai_dict, get_sampling_options, process_chat_completion_response, process_chat_completion_stream_response, process_completion_response, process_completion_stream_response, ) from llama_stack.providers.utils.inference.prompt_adapter import ( chat_completion_request_to_prompt, completion_request_to_prompt, content_has_media, interleaved_content_as_str, request_has_media, ) from .config import CentMLImplConfig # Example model aliases that map from CentML’s published model identifiers MODEL_ALIASES = [ build_model_entry( "meta-llama/Llama-3.2-3B-Instruct", CoreModelId.llama3_2_3b_instruct.value, ), build_model_entry( "meta-llama/Llama-3.3-70B-Instruct", CoreModelId.llama3_3_70b_instruct.value, ), ] class CentMLInferenceAdapter(ModelRegistryHelper, Inference, NeedsRequestProviderData): """ Adapter to use CentML's serverless inference endpoints, which adhere to the OpenAI chat/completions API spec, inside llama-stack. """ def __init__(self, config: CentMLImplConfig) -> None: super().__init__(MODEL_ALIASES) self.config = config async def initialize(self) -> None: pass async def shutdown(self) -> None: pass def _get_api_key(self) -> str: """ Obtain the CentML API key either from the adapter config or from the dynamic provider data in request headers. """ if self.config.api_key is not None: return self.config.api_key.get_secret_value() else: provider_data = self.get_request_provider_data() if provider_data is None or not provider_data.centml_api_key: raise ValueError( 'Pass CentML API Key in the header X-LlamaStack-ProviderData as { "centml_api_key": "" }' ) return provider_data.centml_api_key def _get_client(self) -> OpenAI: """ Creates an OpenAI-compatible client pointing to CentML's base URL, using the user's CentML API key. """ api_key = self._get_api_key() return OpenAI(api_key=api_key, base_url=self.config.url) # # COMPLETION (non-chat) # async def completion( self, model_id: str, content: InterleavedContent, sampling_params: Optional[SamplingParams] = SamplingParams(), response_format: Optional[ResponseFormat] = None, stream: Optional[bool] = False, logprobs: Optional[LogProbConfig] = None, ) -> AsyncGenerator: """ For "completion" style requests (non-chat). """ model = await self.model_store.get_model(model_id) request = CompletionRequest( model=model.provider_resource_id, content=content, sampling_params=sampling_params, response_format=response_format, stream=stream, logprobs=logprobs, ) if stream: return self._stream_completion(request) else: return await self._nonstream_completion(request) async def _nonstream_completion( self, request: CompletionRequest) -> ChatCompletionResponse: params = await self._get_params(request) if request.response_format is not None: # For structured output, use the chat completions endpoint. response = self._get_client().chat.completions.create(**params) try: result = process_chat_completion_response(response, request) except KeyError as e: if str(e) == "'parameters'": # CentML's structured output may not include a tool call. # Use the raw message content as the structured JSON. raw_content = response.choices[0].message.content message_obj = parse_obj_as( Message, { "role": "assistant", "content": raw_content, "stop_reason": "end_of_message" }) result = ChatCompletionResponse( completion_message=message_obj, logprobs=None, ) else: raise # If the processed content is still None, use the raw API content. if result.completion_message.content is None: raw_content = response.choices[0].message.content if isinstance(result.completion_message, dict): result.completion_message["content"] = raw_content else: updated_msg = result.completion_message.copy( update={"content": raw_content}) result = result.copy( update={"completion_message": updated_msg}) else: response = self._get_client().completions.create(**params) result = process_completion_response(response) # If structured output returns token lists, join them. if request.response_format is not None: if isinstance(result.completion_message, dict): content = result.completion_message.get("content") if isinstance(content, list): result.completion_message["content"] = "".join(content) else: if isinstance(result.completion_message.content, list): updated_msg = result.completion_message.copy(update={ "content": "".join(result.completion_message.content) }) result = result.copy( update={"completion_message": updated_msg}) return result async def _stream_completion(self, request: CompletionRequest) -> AsyncGenerator: params = await self._get_params(request) async def _to_async_generator(): if request.response_format is not None: stream = self._get_client().chat.completions.create(**params) else: stream = self._get_client().completions.create(**params) for chunk in stream: yield chunk stream = _to_async_generator() if request.response_format is not None: async for chunk in process_chat_completion_stream_response( stream, request): yield chunk else: async for chunk in process_completion_stream_response(stream): yield chunk # # CHAT COMPLETION # async def chat_completion( self, model_id: str, messages: List[Message], sampling_params: Optional[SamplingParams] = SamplingParams(), tools: Optional[List[ToolDefinition]] = None, tool_choice: Optional[ToolChoice] = ToolChoice.auto, tool_prompt_format: Optional[ToolPromptFormat] = None, response_format: Optional[ResponseFormat] = None, stream: Optional[bool] = False, logprobs: Optional[LogProbConfig] = None, tool_config: Optional[ToolConfig] = None, ) -> AsyncGenerator: """ For "chat completion" style requests. """ model = await self.model_store.get_model(model_id) request = ChatCompletionRequest( model=model.provider_resource_id, messages=messages, sampling_params=sampling_params, tools=tools or [], tool_choice=tool_choice, tool_prompt_format=tool_prompt_format, response_format=response_format, stream=stream, logprobs=logprobs, ) if stream: return self._stream_chat_completion(request) else: return await self._nonstream_chat_completion(request) async def _nonstream_chat_completion( self, request: ChatCompletionRequest) -> ChatCompletionResponse: params = await self._get_params(request) if "messages" in params: response = self._get_client().chat.completions.create(**params) else: response = self._get_client().completions.create(**params) result = process_chat_completion_response(response, request) if request.response_format is not None: if isinstance(result.completion_message, dict): content = result.completion_message.get("content") if isinstance(content, list): result.completion_message["content"] = "".join(content) else: if isinstance(result.completion_message.content, list): updated_msg = result.completion_message.copy(update={ "content": "".join(result.completion_message.content) }) result = result.copy( update={"completion_message": updated_msg}) return result async def _stream_chat_completion( self, request: ChatCompletionRequest) -> AsyncGenerator: params = await self._get_params(request) async def _to_async_generator(): if "messages" in params: stream = self._get_client().chat.completions.create(**params) else: stream = self._get_client().completions.create(**params) for chunk in stream: yield chunk stream = _to_async_generator() async for chunk in process_chat_completion_stream_response( stream, request): yield chunk # # HELPER METHODS # async def _get_params( self, request: Union[ChatCompletionRequest, CompletionRequest]) -> dict: input_dict = {} media_present = request_has_media(request) llama_model = self.get_llama_model(request.model) if request.response_format is not None: if isinstance(request, ChatCompletionRequest): input_dict["messages"] = [ await convert_message_to_openai_dict(m) for m in request.messages ] else: prompt_str = await completion_request_to_prompt(request) input_dict["messages"] = [{ "role": "user", "content": prompt_str }] else: if isinstance(request, ChatCompletionRequest): if media_present or not llama_model: input_dict["messages"] = [ await convert_message_to_openai_dict(m) for m in request.messages ] else: input_dict[ "prompt"] = await chat_completion_request_to_prompt( request, llama_model) else: input_dict["prompt"] = await completion_request_to_prompt( request) params = { "model": request.model, **input_dict, "stream": request.stream, **self._build_options(request.sampling_params, request.logprobs, request.response_format), } return params def _build_options( self, sampling_params: Optional[SamplingParams], logprobs: Optional[LogProbConfig], fmt: Optional[ResponseFormat], ) -> dict: options = get_sampling_options(sampling_params) if fmt: if fmt.type == ResponseFormatType.json_schema.value: options["response_format"] = { "type": "json_schema", "json_schema": { "name": "schema", "schema": fmt.json_schema }, } elif fmt.type == ResponseFormatType.grammar.value: raise NotImplementedError( "Grammar response format not supported yet") else: raise ValueError(f"Unknown response format {fmt.type}") if logprobs and logprobs.top_k: options["logprobs"] = logprobs.top_k return options # # EMBEDDINGS # async def embeddings( self, task_type: str, model_id: str, text_truncation: Optional[str], output_dimension: Optional[int], contents: List[InterleavedContent], ) -> EmbeddingsResponse: model = await self.model_store.get_model(model_id) # CentML does not support media for embeddings. assert all(not content_has_media(c) for c in contents), ( "CentML does not support media for embeddings") resp = self._get_client().embeddings.create( model=model.provider_resource_id, input=[interleaved_content_as_str(c) for c in contents], ) embeddings = [item.embedding for item in resp.data] return EmbeddingsResponse(embeddings=embeddings)