Cómo trabajar con la API de Cohere

Daniel Costa

Daniel Costa

15 April 2025

Cómo trabajar con la API de Cohere

Cohere proporciona a los desarrolladores acceso a sofisticados Modelos de Lenguaje Grande (LLMs) capaces de entender y generar texto similar al humano. Para interactuar con estos modelos de manera programática, necesitas una clave API. Esta clave actúa como tu identificador único y contraseña, permitiendo que los sistemas de Cohere autentiquen tus solicitudes y rastreen tu uso.

Esta guía te llevará a través de los pasos esenciales: obtener tu clave API, entender las diferencias críticas entre los tipos de claves (especialmente respecto a costos y límites de uso), y realizar una prueba inicial simple utilizando la herramienta Apidog para asegurarte de que tu clave está funcionando correctamente.

Paso 1: Obtener Tu Clave API de Cohere

Obtener tu clave es el primer y más crucial paso. Cohere hace que este proceso sea relativamente simple a través de su panel en línea.

  1. Navegar al Panel de Cohere: Abre tu navegador web y ve al punto de acceso principal de la plataforma Cohere. Normalmente encontrarás una página de inicio de sesión o registro.
  2. Accede a Tu Cuenta:

Localiza la Sección de Claves API: Una vez que hayas iniciado sesión con éxito en el panel de Cohere, busca una sección dedicada específicamente a gestionar las Claves API. Esto puede estar bajo la configuración de la cuenta, una sección para desarrolladores, o accesible directamente a través de un elemento de menú etiquetado como "Claves API". La interfaz está diseñada para ser fácil de usar, por lo que debería ser relativamente prominente.

Iniciar la Generación de Claves: Dentro de la sección de Claves API, encontrarás una opción para crear una nueva clave. Es probable que veas opciones que diferencian entre tipos de claves, especialmente "Clave de Prueba" y potencialmente "Clave de Producción". Para pruebas iniciales y aprendizaje, selecciona la opción para generar una Clave de Prueba.

Asignar un Nombre: Se te pedirá que nombres tu clave. Elige un nombre descriptivo que te ayude a recordar su propósito más tarde, especialmente si generas múltiples claves para diferentes proyectos. Ejemplos incluyen "MiPrimeraClaveDePrueba", "ClaveDeProyectoDeAprendizaje" o "ClaveDePruebaDeApidog".

Generar y Asegurar Tu Clave: Haz clic en el botón para confirmar y generar la clave (por ejemplo, "Generar Clave de Prueba"). Cohere luego mostrará tu clave API recién generada. Esta es la única vez que se mostrará la clave completa. Es absolutamente esencial que copies esta clave inmediatamente y la guardes en un lugar muy seguro, como un administrador de contraseñas o una nota segura. Trátala con el mismo nivel de seguridad que una contraseña. No la compartas públicamente, no la incrustes directamente en código del lado del cliente, ni la comprometas en sistemas de control de versiones como Git. Una vez que cierres la ventana emergente o navegues a otra parte, no podrás recuperar la clave completa nuevamente por razones de seguridad (aunque puedes ver el nombre de la clave y potencialmente sus primeros/últimos caracteres en el panel). Si la pierdes, necesitarás generar una nueva.

Con tu clave API copiada y asegurada, estás listo para entender qué puedes hacer con ella y las reglas asociadas.

Paso 2: Entender los Tipos de Claves, Costos y Límites de Uso

No todas las claves API de Cohere son iguales. El tipo de clave que tienes dicta cuánto puedes usar la API, qué tan rápido, y si incurre en costos. Entender estas diferencias es vital para evitar interrupciones o cargos inesperados.

A. Claves API de Prueba: Gratis para Evaluación

Cuando te registras por primera vez o generas una clave sin configurar la facturación, normalmente recibes una Clave de Prueba. Estas están diseñadas para exploración, aprendizaje y pruebas a pequeña escala.

Las claves de prueba son ideales para:

Si constantemente alcanzas el límite mensual o los límites de tasa por minuto, es un fuerte indicador de que necesitas actualizar a una clave de Producción.

B. Claves API de Producción: Para Construir y Escalar

Cuando estés listo para construir aplicaciones con usuarios reales, manejar cargas de trabajo más significativas, o ir más allá de las limitaciones de prueba, necesitarás una Clave de Producción. Esto requiere configurar la información de facturación en tu cuenta de Cohere.

Las claves de producción son necesarias para:

C. Elegir la Clave Correcta:

Bien, aquí está la sección revisada del Paso 3 centrada en probar la solicitud de chat en streaming proporcionada en el comando curl usando Apidog, presentada en Markdown:

Paso 3: Realizar una Llamada de Prueba Básica de API para Chat en Streaming con Apidog

Antes de integrar la API en código complejo, especialmente para respuestas en streaming, es útil realizar una prueba directa. Apidog te permite replicar la estructura del comando curl para verificar tu clave y entender el flujo básico de solicitud/respuesta para streaming.

  1. Lanza Apidog: Abre la aplicación Apidog en tu computadora.
  2. Crea una Nueva Solicitud: Haz clic en el botón '+' o equivalente para crear una nueva solicitud de API. Nómbrala algo descriptivo, como "Prueba de Chat en Streaming de Cohere".
  3. Configura el Punto Final:

4. Configura los Encabezados:

5. Construye el Cuerpo de la Solicitud (con Streaming Habilitado):

{
  "stream": true,
  "model": "command-r",
  "messages": [
    {
      "role": "user",
      "content": "¡Hola mundo!"
    }
  ]
}

(Nota: El ejemplo de curl utilizó "role": "user" (minúscula) y modelo "command-a-03-2025". He mantenido "role": "USER" y modelo "command-r" para consistencia con ejemplos anteriores, pero debes ajustar el modelo y la capitalización del rol en el JSON anterior para que coincida exactamente con la solicitud específica que planeas probar si es diferente.)

6. Ejecuta la Solicitud: Haz clic en el botón "Enviar" en Apidog.

7. Analiza la Respuesta (Especificaciones de Streaming):

Esta prueba ayuda a confirmar que la API acepta tu solicitud de streaming y que tu clave es válida para este tipo de interacción, incluso si Apidog en sí no es la herramienta ideal para visualizar la naturaleza en tiempo real de la transmisión. Verifica que la configuración fundamental de la solicitud sea correcta.

Conclusión

Ahora tienes tu clave API de Cohere y entiendes las diferencias cruciales entre las claves de Prueba y Producción, particularmente respecto al límite de 1,000 llamadas mensuales y los límites de tasa por minuto en las claves de prueba frente a la facturación por uso, basada en tokens y límites más altos de las claves de producción. También has realizado una prueba básica pero vital usando Apidog para confirmar que tu clave funciona y que puedes estructurar una llamada API simple.

Esta base es esencial para interactuar de manera efectiva con la API de Cohere. Recuerda mantener tu clave segura, monitorear tu uso frente a los límites (especialmente en una clave de prueba), y consultar la documentación de Cohere para obtener información detallada sobre modelos específicos, parámetros avanzados y uso de SDK a medida que comiences a construir aplicaciones más sofisticadas.

Practica el diseño de API en Apidog

Descubre una forma más fácil de construir y usar APIs