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

# Use o LiteLLM com o CometAPI

> Use este guia para configurar o LiteLLM com o CometAPI definindo a URL base, a chave de API e as opções de model ou provider.

O LiteLLM fornece uma API Python unificada para mais de 100 provedores de LLM. O CometAPI tem suporte nativo — use o prefixo `cometapi/` para rotear solicitações pelo catálogo de modelos do CometAPI.

## Pré-requisitos

* Python 3.6+
* Uma conta CometAPI com uma chave de API ativa — [obtenha a sua aqui](https://www.cometapi.com/console/token)

<Steps>
  <Step title="Instale o LiteLLM">
    ```bash theme={null}
    pip install litellm
    ```
  </Step>

  <Step title="Defina sua chave de API">
    Defina a chave de API como uma variável de ambiente (recomendado) ou passe-a inline:

    ```python theme={null}
    import os
    from litellm import completion

    # Recommended: environment variable
    os.environ["COMETAPI_KEY"] = "<COMETAPI_KEY>"

    # Alternative: pass inline
    api_key = "<COMETAPI_KEY>"
    ```

    <Note>
      Use variáveis de ambiente para evitar codificar credenciais sensíveis diretamente nos seus scripts.
    </Note>
  </Step>

  <Step title="Faça uma chamada completion">
    Use o formato `cometapi/<model-name>` para especificar modelos. Você pode passar a chave por variável de ambiente ou explicitamente:

    ```python theme={null}
    messages = [{"content": "Hello, how are you?", "role": "user"}]

    # Method 1: environment variable (recommended)
    response = completion(model="cometapi/your-model-id", messages=messages)

    # Method 2: explicit API key
    response = completion(model="cometapi/your-model-id", messages=messages, api_key=api_key)

    print(response.choices[0].message.content)
    ```
  </Step>

  <Step title="Chamadas assíncronas e Streaming">
    Use `acompletion` com `stream=True` para respostas não bloqueantes em tempo real:

    ```python theme={null}
    from litellm import acompletion
    import asyncio, traceback

    async def stream_call():
        try:
            response = await acompletion(
          model="cometapi/your-model-id",
                messages=[{"content": "Hello, how are you?", "role": "user"}],
                stream=True,
            )
            async for chunk in response:
                print(chunk)
        except Exception:
            print(f"Error: {traceback.format_exc()}")

    asyncio.run(stream_call())
    ```
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Dicas e solução de problemas">
    * **Formato do modelo**: Os modelos CometAPI usam o prefixo `cometapi/<model-name>`, por exemplo `cometapi/your-model-id`. Consulte a [página de modelos da CometAPI](/pt/overview/models) para ver os modelos disponíveis.
    * **Respostas de Fine-tuning**: O LiteLLM oferece suporte a `temperature`, `max_tokens` e `top_p` — adicione-os a qualquer chamada `completion()`, por exemplo `completion(..., temperature=0.7)`.
    * **Tratamento de erros**: Envolva as chamadas em `try/except` para capturar erros de chave inválida ou problemas de rede.
    * **Segurança**: Nunca envie chaves de API para o controle de versão. Use variáveis de ambiente ou um gerenciador de segredos.
    * **Limites de taxa**: Monitore o uso no [console da CometAPI](https://www.cometapi.com/console).
    * **Mais documentação**: [documentação do LiteLLM](https://docs.litellm.ai/docs/) — [início rápido da CometAPI](/pt/overview/quick-start)
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/litellm#howto",
        "name": "Use LiteLLM com CometAPI",
        "description": "Use este guia para configurar o LiteLLM com a CometAPI definindo a URL base, a chave de API e as opções de modelo ou provedor.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/litellm#step-1",
            "position": 1,
            "name": "Instale o LiteLLM",
            "text": "Conclua a etapa Instale o LiteLLM no guia Use LiteLLM com CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/litellm#step-2",
            "position": 2,
            "name": "Defina sua chave de API",
            "text": "Armazene sua chave de API da CometAPI na variável de ambiente ou no campo de configurações usado pela integração."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/litellm#step-3",
            "position": 3,
            "name": "Faça uma chamada completion",
            "text": "Conclua a etapa Faça uma chamada completion no guia Use LiteLLM com CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/litellm#step-4",
            "position": 4,
            "name": "Chamadas assíncronas e Streaming",
            "text": "Conclua a etapa Chamadas assíncronas e Streaming no guia Use LiteLLM com CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentação da CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrações",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Use LiteLLM com CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/litellm"
          }
        ]
      }
    ]
    }
    `}
</script>
