cicora.ai
Español
Especificación de la APICódigo del cliente

SDK y clientes HTTP

Usa URL base distintas para clientes de estilo OpenAI y Messages: apuntan a la misma especificación, pero componen las rutas de forma diferente.

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.

Elige la forma del cliente

Los clientes JavaScript y Python de estilo OpenAI y las llamadas curl directas reciben https://cicora.ai/api/v1 y añaden las rutas sin un segundo /v1.

Los SDK de Messages y Claude Code reciben la raíz de la pasarela https://cicora.ai/api porque añaden /v1/messages por sí mismos. Los ejemplos siguientes muestran ambas formas.

Cliente JavaScript de estilo OpenAI
typescript
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://cicora.ai/api/v1",
  apiKey: process.env.CICORA_API_KEY,
});

const completion = await client.chat.completions.create({
  model: "openai/gpt-5.6-sol",
  messages: [{ role: "user", content: "Hello" }],
});
Cliente Python de estilo OpenAI
python
from openai import OpenAI
import os

client = OpenAI(
    base_url="https://cicora.ai/api/v1",
    api_key=os.environ["CICORA_API_KEY"],
)

completion = client.chat.completions.create(
    model="openai/gpt-5.6-sol",
    messages=[{"role": "user", "content": "Hello"}],
)
Cliente Python de Messages
python
from anthropic import Anthropic
import os

client = Anthropic(
    base_url="https://cicora.ai/api",
    auth_token=os.environ["CICORA_API_KEY"],
)

message = client.messages.create(
    model="anthropic/claude-sonnet-5",
    max_tokens=500,
    messages=[{"role": "user", "content": "Hello"}],
)
Cliente JavaScript de Messages
typescript
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://cicora.ai/api",
  authToken: process.env.CICORA_API_KEY,
});

const message = await client.messages.create({
  model: "anthropic/claude-sonnet-5",
  max_tokens: 500,
  messages: [{ role: "user", content: "Hello" }],
});
Pasarela Messages de Claude Code
bash
export ANTHROPIC_BASE_URL=https://cicora.ai/api
export ANTHROPIC_AUTH_TOKEN="$CICORA_API_KEY"
export ANTHROPIC_API_KEY=""

# The Messages client appends /v1/messages to the gateway root.
# Clear a preexisting API key so it cannot conflict with the Bearer token.

Límite de integración

  • Crea un cliente por proceso o límite seguro de aplicación.
  • Pasa timeout y AbortSignal desde el flujo que realiza la llamada.
  • Devuelve el estado HTTP y un cuerpo de error estructurado al código que realiza la llamada.

Versiones y actualizaciones

No apliques la URL base de estilo OpenAI a un SDK de Messages ni añadas /v1 manualmente a la raíz de su pasarela.

Tras un cambio de referencia, actualiza el cliente y verifica la ruta principal mediante models antes de publicar.

Continuar con