> ## Documentation Index
> Fetch the complete documentation index at: https://ikun.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cerebras OpenAI

> 了解如何使用 Cerebras OpenAI 与 Agno。

## OpenAI 兼容集成

您也可以通过 OpenAI 兼容的接口使用 Cerebras，从而轻松地将其与期望 OpenAI API 的工具和库集成。

### 使用 OpenAI 兼容类

`CerebrasOpenAI` 类为 Cerebras 模型提供了 OpenAI 风格的接口：

首先，安装 openai：

```shell theme={null}
pip install openai
```

```python theme={null}
from agno.agent import Agent
from agno.models.cerebras import CerebrasOpenAI

agent = Agent(
    model=CerebrasOpenAI(
        id="llama-4-scout-17b-16e-instruct",  # 要使用的模型 ID
        # base_url="https://api.cerebras.ai", # 可选：Cerebras 的默认端点
    ),
    markdown=True,
)

# 在终端中打印响应
agent.print_response("写一个两句话的恐怖故事")
```

### 配置选项

`CerebrasOpenAI` 类接受以下参数：

| 参数         | 类型  | 描述                                         | 默认值                                                  |
| ---------- | --- | ------------------------------------------ | ---------------------------------------------------- |
| `id`       | str | 模型标识符（例如，“llama-4-scout-17b-16e-instruct”） | **必需**                                               |
| `name`     | str | 模型的显示名称                                    | "Cerebras"                                           |
| `provider` | str | 提供商名称                                      | "Cerebras"                                           |
| `api_key`  | str | API 密钥（回退到 CEREBRAS\_API\_KEY 环境变量）        | None                                                 |
| `base_url` | str | Cerebras OpenAI 兼容端点的 URL                  | "[https://api.cerebras.ai](https://api.cerebras.ai)" |

### 示例

* 在此处查看更多示例 [here](../examples/models/cerebras_openai)。