Inicio rápido

Siga esta guía para crear una clave de API y enviar su primera solicitud de chat con gpt-5.6-sol. Antes de empezar, asegúrese de poder acceder a la consola de Vergora y de disponer de saldo suficiente para una solicitud de prueba.

Antes de empezar

También necesita una terminal que ejecute cURL. Los comandos siguientes funcionan en macOS, Linux y entornos compatibles con Bash o Zsh.

1. Inicie sesión y abra la consola

1. Seleccione Iniciar sesión en la cabecera del sitio.
2. Complete la verificación de la cuenta siguiendo las instrucciones de la página.
3. Abra la consola y confirme que usa la cuenta y el espacio de trabajo correctos.
4. Compruebe el saldo disponible y el estado de las claves de API existentes.

Si un código de verificación es incorrecto o no llega, revise la dirección de correo, la carpeta de spam y el mensaje de la página antes de solicitar otro.

2. Cree una clave de API

1. Abra Claves de API en la consola.
2. Cree una nueva clave de API.
3. Use un nombre que identifique su aplicación y entorno, como demo-development.
4. Siga las instrucciones para copiar y guardar de forma segura la clave de API completa.

Una clave de API es una credencial privada. No la exponga en código del navegador, repositorios públicos, mensajes de chat, registros ni capturas de pantalla.

3. Guarde la clave de API en su terminal

Use el siguiente comando para introducir la clave de API. La terminal no la muestra mientras escribe.

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

Esta variable de entorno solo está disponible en la sesión actual de la terminal. Debe configurarla de nuevo al cerrarla. Las aplicaciones de producción deben guardar las credenciales en variables de entorno del servidor o un gestor de secretos.

4. Envíe su primera solicitud

Ejecute el siguiente comando en la misma 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": "Preséntese en una frase."
      }
    ],
    "stream": false
  }'

Este ejemplo usa el endpoint Chat Completions. Antes de cambiar de modelo, confirme que admite el mismo endpoint, estructura de mensajes y parámetros.

5. Lea la respuesta

Una respuesta compatible con Chat Completions sin streaming suele incluir contenido del mensaje e información de uso. Los siguientes campos y valores solo ilustran dónde leer el resultado:

{
  "id": "example-response-id",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "¡Hola! Soy un asistente de IA."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 8,
    "total_tokens": 20
  }
}

Compruebe lo siguiente:

1. La solicitud HTTP se completó correctamente.
2. El cuerpo de la respuesta contiene la salida del modelo.
3. Su aplicación puede leer choices[0].message.content.
4. La respuesta incluye información de uso o un identificador para localizar la solicitud.

La ausencia de un error en la terminal no demuestra que la solicitud se completara correctamente.

6. Revise el registro de la solicitud

Abra Registros de API en la consola. Localice la solicitud por hora y modelo y revise:

Si el registro aún no aparece, actualice la página y revise los filtros activos antes de enviar de nuevo la misma solicitud.

Solución de problemas

Tras completar su primera solicitud, continúe con Autenticación para aprender a usar y proteger las claves de API.