> ## Documentation Index
> Fetch the complete documentation index at: https://docs.camel-ai.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Camel.models.azure openai model

<a id="camel.models.azure_openai_model" />

<a id="camel.models.azure_openai_model.AzureOpenAIModel" />

## AzureOpenAIModel

```python theme={"system"}
class AzureOpenAIModel(BaseModelBackend):
```

Azure OpenAI API in a unified BaseModelBackend interface.

**Parameters:**

* **model\_type** (Union\[ModelType, str]): Model for which a backend is created, Should be the deployment name you chose when you deployed an azure model.
* **model\_config\_dict** (Optional\[Dict\[str, Any]], optional): A dictionary that will be fed into:obj:`openai.ChatCompletion.create()`. If :obj:`None`, :obj:`ChatGPTConfig().as_dict()` will be used. (default: :obj:`None`)
* **api\_key** (Optional\[str], optional): The API key for authenticating with the OpenAI service. (default: :obj:`None`)
* **url** (Optional\[str], optional): The url to the OpenAI service. (default: :obj:`None`)
* **api\_version** (Optional\[str], optional): The api version for the model. (default: :obj:`None`)
* **azure\_ad\_token** (Optional\[str], optional): Your Azure Active Directory token, [https://www.microsoft.com/en-us/security/business/](https://www.microsoft.com/en-us/security/business/) identity-access/microsoft-entra-id. (default: :obj:`None`)
* **azure\_ad\_token\_provider** (Optional\[AzureADTokenProvider], optional): A function that returns an Azure Active Directory token, will be invoked on every request. (default: :obj:`None`)
* **token\_counter** (Optional\[BaseTokenCounter], optional): Token counter to use for the model. If not provided, :obj:`OpenAITokenCounter` will be used. (default: :obj:`None`)
* **timeout** (Optional\[float], optional): The timeout value in seconds for API calls. If not provided, will fall back to the MODEL\_TIMEOUT environment variable or default to 180 seconds. (default: :obj:`None`)
* **max\_retries** (int, optional): Maximum number of retries for API calls. (default: :obj:`3`)
* **client** (Optional\[Any], optional): A custom synchronous AzureOpenAI client instance. If provided, this client will be used instead of creating a new one. Useful for RL frameworks like AReaL or rLLM that provide Azure OpenAI-compatible clients. The client should implement the AzureOpenAI client interface with `.chat.completions.create()` and `.beta.chat.completions.parse()` methods. (default: :obj:`None`)
* **async\_client** (Optional\[Any], optional): A custom asynchronous AzureOpenAI client instance. If provided, this client will be used instead of creating a new one. The client should implement the AsyncAzureOpenAI client interface. (default: :obj:`None`)
* **azure\_deployment\_name** (Optional\[str], optional): **Deprecated**. Use `model_type` parameter instead. This parameter is kept for backward compatibility and will be removed in a future version. (default: :obj:`None`) \*\*kwargs (Any): Additional arguments to pass to the client initialization. Ignored if custom clients are provided.
* **References**:
* **https**: //learn.microsoft.com/en-us/azure/ai-services/openai/

<a id="camel.models.azure_openai_model.AzureOpenAIModel.__init__" />

### **init**

```python theme={"system"}
def __init__(
    self,
    model_type: Union[ModelType, str],
    model_config_dict: Optional[Dict[str, Any]] = None,
    api_key: Optional[str] = None,
    url: Optional[str] = None,
    timeout: Optional[float] = None,
    token_counter: Optional[BaseTokenCounter] = None,
    api_version: Optional[str] = None,
    azure_ad_token_provider: Optional['AzureADTokenProvider'] = None,
    azure_ad_token: Optional[str] = None,
    max_retries: int = 3,
    client: Optional[Any] = None,
    async_client: Optional[Any] = None,
    azure_deployment_name: Optional[str] = None,
    **kwargs: Any
):
```

<a id="camel.models.azure_openai_model.AzureOpenAIModel.token_counter" />

### token\_counter

```python theme={"system"}
def token_counter(self):
```

**Returns:**

BaseTokenCounter: The token counter following the model's
tokenization style.

<a id="camel.models.azure_openai_model.AzureOpenAIModel._run" />

### \_run

```python theme={"system"}
def _run(
    self,
    messages: List[OpenAIMessage],
    response_format: Optional[Type[BaseModel]] = None,
    tools: Optional[List[Dict[str, Any]]] = None
):
```

Runs inference of Azure OpenAI chat completion.

**Parameters:**

* **messages** (List\[OpenAIMessage]): Message list with the chat history in OpenAI API format.
* **response\_format** (Optional\[Type\[BaseModel]]): The format of the response.
* **tools** (Optional\[List\[Dict\[str, Any]]]): The schema of the tools to use for the request.

**Returns:**

Union\[ChatCompletion, Stream\[ChatCompletionChunk]]:
`ChatCompletion` in the non-stream mode, or
`Stream[ChatCompletionChunk]` in the stream mode.
`ChatCompletionStreamManager[BaseModel]` for
structured output streaming.

<a id="camel.models.azure_openai_model.AzureOpenAIModel._request_chat_completion" />

### \_request\_chat\_completion

```python theme={"system"}
def _request_chat_completion(
    self,
    messages: List[OpenAIMessage],
    tools: Optional[List[Dict[str, Any]]] = None
):
```

<a id="camel.models.azure_openai_model.AzureOpenAIModel._request_parse" />

### \_request\_parse

```python theme={"system"}
def _request_parse(
    self,
    messages: List[OpenAIMessage],
    response_format: Type[BaseModel],
    tools: Optional[List[Dict[str, Any]]] = None
):
```

<a id="camel.models.azure_openai_model.AzureOpenAIModel._request_stream_parse" />

### \_request\_stream\_parse

```python theme={"system"}
def _request_stream_parse(
    self,
    messages: List[OpenAIMessage],
    response_format: Type[BaseModel],
    tools: Optional[List[Dict[str, Any]]] = None
):
```

Request streaming structured output parsing.

<a id="camel.models.azure_openai_model.AzureOpenAIModel.stream" />

### stream

```python theme={"system"}
def stream(self):
```

**Returns:**

bool: Whether the model is in stream mode.