# CometAPI (/models/providers/gateways/cometapi/overview)



<Badge icon="code-branch" color="orange">
  <Tooltip tip="Introduced in v2.0.8" cta="View release notes" href="https://github.com/agno-agi/agno/releases/tag/v2.0.8">
    v2.0.8
  </Tooltip>
</Badge>

CometAPI is a platform for providing endpoints for large language models.

See all CometAPI supported models and pricing [here](https://www.cometapi.com/pricing/).

## Authentication [#authentication]

Set your `COMETAPI_KEY` environment variable. Get your API key from [here](https://www.cometapi.com/console/token).

<CodeBlockTabs defaultValue="Mac">
  <CodeBlockTabsList>
    <CodeBlockTabsTrigger value="Mac">
      Mac
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="Windows">
      Windows
    </CodeBlockTabsTrigger>
  </CodeBlockTabsList>

  <CodeBlockTab value="Mac">
    ```bash
    export COMETAPI_KEY="your_value_here"
    ```
  </CodeBlockTab>

  <CodeBlockTab value="Windows">
    ```powershell
    $Env:COMETAPI_KEY="your_value_here"
    ```
  </CodeBlockTab>
</CodeBlockTabs>

## Example [#example]

Install the `openai` package:

```shell
uv pip install -U agno openai
```

Use `CometAPI` with your `Agent`:

<CodeBlockTabs defaultValue="agent.py">
  <CodeBlockTabsList>
    <CodeBlockTabsTrigger value="agent.py">
      agent.py
    </CodeBlockTabsTrigger>
  </CodeBlockTabsList>

  <CodeBlockTab value="agent.py">
    ```python
    from agno.agent import Agent
    from agno.models.cometapi import CometAPI

    agent = Agent(model=CometAPI(), markdown=True)

    # Print the response in the terminal
    agent.print_response("Explain quantum computing in simple terms")

    ```
  </CodeBlockTab>
</CodeBlockTabs>

<Note>
   View more examples 

  [here](/models/providers/gateways/cometapi/usage/basic-stream)

  . 
</Note>

## Parameters [#parameters]

| Parameter  | Type            | Default                         | Description                                                  |
| ---------- | --------------- | ------------------------------- | ------------------------------------------------------------ |
| `id`       | `str`           | `"gpt-5-mini"`                  | The ID of the model to use                                   |
| `name`     | `str`           | `"CometAPI"`                    | The name of the model                                        |
| `api_key`  | `Optional[str]` | `None`                          | The API key for CometAPI (defaults to COMETAPI\_KEY env var) |
| `base_url` | `str`           | `"https://api.cometapi.com/v1"` | The base URL for the CometAPI                                |

`CometAPI` extends the OpenAI-compatible interface and supports most parameters from the [OpenAI model](/models/providers/native/openai/completion/overview).

## Available Models [#available-models]

CometAPI provides access to 300+ AI models. You can fetch the available models programmatically:

```python
from agno.models.cometapi import CometAPI

model = CometAPI()
available_models = model.get_available_models()
print(available_models)
```

The helper returns an empty list when credentials are missing or a request/parsing error occurs; `[]` is not proof that the provider has no models.