cicora.ai
Especificación de la APIRespuestas

Preguntas frecuentes para desarrolladores

Respuestas prácticas breves sobre claves, URL base, modelos, coste y diagnóstico de integraciones.

Referencia de integración: elige los parámetros y las capacidades disponibles en la configuración de la API de tu cuenta y en el catálogo de modelos de tu entorno.

¿Por dónde empiezo?

Crea una clave separada, configura la URL base de estilo OpenAI https://cicora.ai/api/v1, y ejecuta GET /models. Después envía una solicitud mínima de chat con el identificador de un modelo seleccionado.

Para un SDK de Messages, usa la raíz de la pasarela https://cicora.ai/api. Ante un 404, compara la URL final con el protocolo del cliente: uno añade una ruta tras /v1 y el otro añade /v1/messages.

Una primera solicitud de diagnóstico segura
bash
curl --include --request GET https://cicora.ai/api/v1/models \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Accept: application/json'

Soluciones habituales

  • No guardes una clave en código de cliente ni la publiques en una incidencia o captura.
  • No trates un ejemplo de precio como precio actual: consulta el catálogo y los metadatos de respuesta.
  • No transfieras parámetros ni capacidades entre modelos sin comprobar el modelo.

Cuando se necesite soporte

Recopila la marca de tiempo, el método, la URL sin secretos de consulta, el estado HTTP, el ID de solicitud y un cuerpo de error sin datos identificativos.

No adjuntes una clave, indicaciones completas con datos restringidos ni archivos salvo que sean necesarios para reproducir el problema.