> ## 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.

# Comece com a CometAPI: crie uma chave de API e faça sua primeira chamada

> Comece com a CometAPI criando uma chave de API, definindo a URL base e enviando sua primeira solicitação de API com curl, Python ou Node.js.

## Crie uma conta e uma chave de API

Crie uma conta CometAPI e uma chave de API antes de chamar a API.

<Steps>
  <Step title="Faça login ou crie uma conta">
    Abra a [página de login da CometAPI](https://www.cometapi.com/console/login). Continue com Google, continue com GitHub ou insira seu e-mail ou nome de usuário. Se você não tiver uma conta, conclua a criação da conta a partir desta página.

    <Frame>
      <img src="https://mintcdn.com/cometapi/BtE3Lagaukxd3efj/images/overview/cometapi-console-login.png?fit=max&auto=format&n=BtE3Lagaukxd3efj&q=85&s=988bee0055bf1ce2552a8d877a48a97d" alt="Página de login da CometAPI com opções de acesso pelo Google, GitHub e e-mail" width="1280" height="720" data-path="images/overview/cometapi-console-login.png" />
    </Frame>
  </Step>

  <Step title="Abra as chaves de API">
    Depois de fazer login, abra a [página de chaves de API](https://www.cometapi.com/console/token). Você também pode selecionar **API Keys** na barra lateral do painel.
  </Step>

  <Step title="Crie uma chave de API">
    Clique em **Create API Key**, insira um nome claro, como `local-test`, e mantenha **Unlimited Quota** ativado para um primeiro teste, a menos que você queira definir um limite de gastos. Clique em **Create**.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="Página de chaves de API da CometAPI com o botão Create API Key e a caixa de criação em destaque" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>
  </Step>

  <Step title="Copie a chave de API">
    Clique no botão de cópia na coluna **Key**. Armazene a chave copiada em uma variável de ambiente no lado do servidor ou em um arquivo `.env` local. Não cole uma chave de API real em repositórios públicos, código de frontend, capturas de tela ou tickets de suporte.

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="Tabela de chaves de API da CometAPI com o botão de cópia destacado para uma chave de API mascarada" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>
</Steps>

Os exemplos de solicitação leem `COMETAPI_KEY` do seu ambiente.

## Armazene sua chave de API localmente

Para testes locais, exporte sua chave de API como uma variável de ambiente:

```bash theme={null}
read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY
```

## URL base

Use esta URL base para SDKs compatíveis com OpenAI e chamadas de API:

```text theme={null}
https://api.cometapi.com/v1
```

## Mudança em 30 segundos do OpenAI

Depois de ter uma chave de API da CometAPI, use esta diferença de duas configurações ao mudar um cliente OpenAI SDK para CometAPI:

```diff theme={null}
- base_url="https://api.openai.com/v1"
- api_key=os.environ["OPENAI_API_KEY"]
+ base_url="https://api.cometapi.com/v1"
+ api_key=os.environ["COMETAPI_KEY"]
```

A CometAPI usa formatos de solicitação compatíveis com OpenAI para fluxos de trabalho comuns de texto, imagem, áudio e vídeo. Se o seu app já usa o OpenAI SDK, comece alterando a URL base e a chave de API.

## Faça sua primeira chamada

Depois de definir `COMETAPI_KEY` no seu ambiente, substitua `your-model-id` por um model ID atual da [página de Models](/pt/overview/models).

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.cometapi.com/v1/chat/completions \
    -H "Authorization: Bearer $COMETAPI_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "your-model-id",
      "messages": [
        {
          "role": "user",
          "content": "Write a one-sentence bedtime story."
        }
      ]
    }'
  ```

  ```python Python theme={null}
  import os
  from openai import OpenAI

  client = OpenAI(
      api_key=os.environ["COMETAPI_KEY"],
      base_url="https://api.cometapi.com/v1",
  )

  completion = client.chat.completions.create(
      model="your-model-id",
      messages=[
          {
              "role": "user",
              "content": "Write a one-sentence bedtime story.",
          }
      ],
  )

  print(completion.choices[0].message.content)
  ```

  ```javascript Node.js theme={null}
  import OpenAI from "openai";

  const client = new OpenAI({
    apiKey: process.env.COMETAPI_KEY,
    baseURL: "https://api.cometapi.com/v1",
  });

  const completion = await client.chat.completions.create({
    model: "your-model-id",
    messages: [
      {
        role: "user",
        content: "Write a one-sentence bedtime story.",
      },
    ],
  });

  console.log(completion.choices[0].message.content);
  ```
</CodeGroup>

## Escolha um modelo

Escolha um model ID na [página de Models](/pt/overview/models) e, em seguida, passe esse valor no campo `model`.

| Objetivo                 | Por onde começar                                                                                                                                     |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Chat ou texto geral      | Use um modelo GPT, Claude, Gemini, DeepSeek ou outro modelo de chat com [Chat Completions](/api/text/chat).                                          |
| Programação e raciocínio | Use um modelo de programação ou raciocínio com [Responses](/api/text/responses) quando o modelo exigir a API Responses.                              |
| Geração de imagem        | Use um modelo de imagem com [Create image](/api/image/openai/images) ou um guia de imagem específico do provedor.                                    |
| Geração de vídeo         | Use um modelo de vídeo com a página da API de vídeo que corresponda ao fluxo de trabalho do provedor, como [Create video](/api/video/sora-2/create). |

## O que vem a seguir

* Para falhas de solicitação, consulte [Error Codes & Handling](/pt/errors/error-codes-handling).
* Para orientações sobre retry, consulte [how to handle rate limits](/api/text/chat#how-to-handle-rate-limits).
* Para uso específico de modelo, comece com [Chat Completions](/api/text/chat), [Responses](/api/text/responses), [Create image](/api/image/openai/images) ou [Create video](/api/video/sora-2/create).
* Para detalhes de cobrança, consulte [About Pricing](/pt/pricing/about-pricing).
* Para convidar membros da equipe e gerenciar Credits compartilhados, consulte [Gerenciar uma equipe com o Workspace](/pt/workspace/overview).
* Para ajuda, consulte o [Help Center](/pt/support/help-center) ou entre em contato com o [suporte da CometAPI](https://www.cometapi.com/support/).

## FAQ

<AccordionGroup>
  <Accordion title="Como crio uma conta CometAPI?">
    Abra a [página de login da CometAPI](https://www.cometapi.com/console/login) e continue com Google, continue com GitHub ou insira seu e-mail ou nome de usuário. Se você não tiver uma conta, conclua a criação da conta na mesma página.
  </Accordion>

  <Accordion title="Como obtenho uma chave de API da CometAPI?">
    Abra a [página de chave de API](https://www.cometapi.com/console/token) no painel da CometAPI, clique em **Create API Key**, insira um nome, clique em **Create** e copie a chave de API gerada. Use `$COMETAPI_KEY` nos exemplos em vez de uma chave de API real.
  </Accordion>

  <Accordion title="Onde devo armazenar minha chave de API?">
    Armazene sua chave de API em uma variável de ambiente no lado do servidor ou em um arquivo `.env` local. Não faça commit dela em repositórios públicos, não a cole em código de frontend, não a inclua em capturas de tela nem a envie em tickets de suporte.
  </Accordion>

  <Accordion title="Qual é a URL base da CometAPI para chamadas de API?">
    Use `https://api.cometapi.com/v1` para SDKs compatíveis com OpenAI e endpoints como `/v1/chat/completions`.
  </Accordion>

  <Accordion title="A CometAPI funciona com o SDK Python da OpenAI?">
    Sim. Crie um cliente `OpenAI`, defina `api_key` como sua chave de API da CometAPI e defina `base_url` como `https://api.cometapi.com/v1`.
  </Accordion>

  <Accordion title="Como faço para migrar da OpenAI para a CometAPI?">
    Altere a URL base para `https://api.cometapi.com/v1`, substitua a chave de API pela sua chave de API da CometAPI e use um model ID da CometAPI da [página Models](/pt/overview/models).
  </Accordion>

  <Accordion title="Qual model ID devo usar primeiro?">
    Escolha o model ID de acordo com o caso de uso. Comece pela [página Models](/pt/overview/models) e, em seguida, selecione um modelo de chat, coding, imagem ou vídeo que corresponda à página da API que você pretende chamar.
  </Accordion>

  <Accordion title="Quais linguagens de programação a CometAPI oferece suporte?">
    A CometAPI funciona com qualquer linguagem de programação que possa enviar requisições HTTPS. Comece com os exemplos de curl, Python e Node.js nesta página ou use um SDK compatível com OpenAI que permita substituir a URL base.
  </Accordion>

  <Accordion title="A CometAPI oferece teste grátis ou chave de API gratuita?">
    Você pode criar uma chave de API da CometAPI no painel. Para verificar a disponibilidade de teste grátis, créditos de teste grátis e detalhes de faturamento, consulte a [página de preços da CometAPI](https://www.cometapi.com/pricing/) e [Sobre preços](/pt/pricing/about-pricing).
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "name": "Início rápido da CometAPI: crie uma chave de API e faça sua primeira chamada",
        "description": "Início rápido da CometAPI para usuários de primeira viagem: entre, crie uma chave de API, copie a chave, defina a URL base e faça sua primeira chamada de API com curl, Python ou Node.js.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#sign-in-or-create-an-account",
            "name": "Entre ou crie uma conta",
            "text": "Abra https://www.cometapi.com/console/login e continue com Google, GitHub ou e-mail."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#open-api-keys",
            "name": "Abra as chaves de API",
            "text": "Depois de entrar, abra https://www.cometapi.com/console/token ou selecione API Keys na barra lateral do painel."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#create-an-api-key",
            "name": "Crie uma chave de API",
            "text": "Clique em Create API Key, insira um nome, escolha a configuração de cota e clique em Create."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/overview/quick-start#copy-the-api-key",
            "name": "Copie a chave de API",
            "text": "Clique no botão de copiar na coluna Key e armazene a chave em uma variável de ambiente no lado do servidor ou em um arquivo .env local."
          },
          {
            "@type": "HowToStep",
            "name": "Defina a URL base",
            "text": "Use https://api.cometapi.com/v1 como URL base para SDKs compatíveis com OpenAI e chamadas de API."
          },
          {
            "@type": "HowToStep",
            "name": "Faça sua primeira chamada",
            "text": "Chame /v1/chat/completions com curl, Python ou Node.js e substitua your-model-id por um model ID atual da página Models da CometAPI."
          }
        ]
      },
      {
        "@type": "FAQPage",
        "mainEntity": [
          {
            "@type": "Question",
            "name": "Como crio uma conta CometAPI?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Abra a página de login da CometAPI e continue com Google, GitHub ou e-mail. Se você não tiver uma conta, conclua a criação da conta na mesma página."
            }
          },
          {
            "@type": "Question",
            "name": "Como obtenho uma chave de API da CometAPI?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Abra a página de chave de API no painel da CometAPI, clique em Create API Key, insira um nome, clique em Create e copie a chave de API gerada."
            }
          },
          {
            "@type": "Question",
            "name": "Onde devo armazenar minha chave de API?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Armazene sua chave de API em uma variável de ambiente no lado do servidor ou em um arquivo .env local. Não faça commit dela em repositórios públicos, não a cole em código de frontend, não a inclua em capturas de tela nem a envie em tickets de suporte."
            }
          },
          {
            "@type": "Question",
            "name": "Qual é a URL base da CometAPI para chamadas de API?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Use https://api.cometapi.com/v1 para SDKs e endpoints compatíveis com OpenAI."
            }
          },
          {
            "@type": "Question",
            "name": "A CometAPI funciona com o SDK Python da OpenAI?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Sim. Crie um cliente OpenAI, defina api_key como sua chave de API da CometAPI e defina base_url como https://api.cometapi.com/v1."
            }
          },
          {
            "@type": "Question",
            "name": "Como faço para migrar da OpenAI para a CometAPI?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Altere a URL base para https://api.cometapi.com/v1, substitua a chave de API pela sua chave de API da CometAPI e use um model ID da CometAPI da página Models."
            }
          },
          {
            "@type": "Question",
            "name": "Qual model ID devo usar primeiro?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Escolha o model ID de acordo com o caso de uso. Comece pela página Models e, em seguida, selecione um modelo de chat, coding, imagem ou vídeo que corresponda à página da API que você pretende chamar."
            }
          },
          {
            "@type": "Question",
            "name": "Quais linguagens de programação a CometAPI oferece suporte?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "A CometAPI funciona com qualquer linguagem de programação que possa enviar requisições HTTPS. Comece com os exemplos de curl, Python e Node.js ou use um SDK compatível com OpenAI que permita substituir a URL base."
            }
          },
          {
            "@type": "Question",
            "name": "A CometAPI oferece teste grátis ou chave de API gratuita?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Você pode criar uma chave de API da CometAPI no painel. Para verificar a disponibilidade de teste grátis, créditos de teste grátis e detalhes de faturamento, consulte a página de preços da CometAPI e a página Sobre preços."
            }
          }
        ]
      }
    ]
    }
    `}
</script>