Início rápido

Siga este guia para criar uma chave de API e enviar sua primeira solicitação de chat com gpt-5.6-sol. Antes de começar, verifique se consegue acessar o console da Vergora e se tem saldo disponível suficiente para uma solicitação de teste.

Antes de começar

Você também precisa de um terminal que execute cURL. Os comandos abaixo funcionam no macOS, Linux e em ambientes compatíveis com Bash ou Zsh.

1. Entre e abra o console

1. Selecione Entrar no cabeçalho do site.
2. Conclua a verificação da conta conforme as instruções da página.
3. Abra o console e confirme que está usando a conta e o espaço de trabalho corretos.
4. Verifique o saldo disponível e o status das chaves de API existentes.

Se um código de verificação estiver incorreto ou não chegar, confira o endereço de e-mail, a pasta de spam e a mensagem da página antes de solicitar outro.

2. Crie uma chave de API

1. Abra Chaves de API no console.
2. Crie uma nova chave de API.
3. Use um nome que identifique a aplicação e o ambiente, como demo-development.
4. Siga as instruções da página para copiar e armazenar com segurança a chave de API completa.

Uma chave de API é uma credencial privada. Não a exponha em código do navegador, repositórios públicos, mensagens de chat, logs ou capturas de tela.

3. Armazene a chave de API no terminal

Use o comando abaixo para inserir a chave de API. O terminal não exibe a chave enquanto você digita.

printf "Vergora API Key: "
read -r -s VERGORA_API_KEY
printf "\n"
export VERGORA_API_KEY

Essa variável de ambiente está disponível apenas na sessão atual do terminal. Você precisa defini-la novamente após fechar o terminal. Aplicações de produção devem armazenar credenciais em variáveis de ambiente do servidor ou em um gerenciador de segredos.

4. Envie sua primeira solicitação

Execute o comando abaixo no mesmo terminal:

curl --silent --show-error --include \
  "https://api.vergora.ai/v1/chat/completions" \
  -H "Authorization: Bearer ${VERGORA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      {
        "role": "user",
        "content": "Apresente-se em uma frase."
      }
    ],
    "stream": false
  }'

Este exemplo usa o endpoint Chat Completions. Antes de trocar de modelo, confirme que o modelo de destino aceita o mesmo endpoint, estrutura de mensagens e parâmetros.

5. Leia a resposta

Uma resposta compatível com Chat Completions sem streaming normalmente inclui conteúdo da mensagem e informações de uso. Os campos e valores abaixo apenas ilustram onde ler o resultado:

{
  "id": "example-response-id",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Olá! Sou um assistente de IA."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 8,
    "total_tokens": 20
  }
}

Verifique o seguinte:

1. A solicitação HTTP foi concluída com sucesso.
2. O corpo da resposta contém a saída do modelo.
3. Sua aplicação consegue ler choices[0].message.content.
4. A resposta inclui informações de uso ou um identificador que ajuda a localizar a solicitação.

A ausência de erro no terminal não comprova o sucesso da solicitação.

6. Revise o registro da solicitação

Abra Logs de API no console. Localize a solicitação pelo horário e modelo e revise:

Se o registro ainda não aparecer, atualize a página e confira os filtros ativos antes de enviar a mesma solicitação novamente.

Solução de problemas

Após concluir sua primeira solicitação, continue em Autenticação para aprender a usar e proteger chaves de API.