cicora.ai
Italiano
Specifica APICodice client

SDK e client HTTP

Usa URL di base diversi per i client in stile OpenAI e Messages: fanno riferimento a un'unica specifica ma compongono i percorsi in modo diverso.

Riferimento per l'integrazione: scegli i parametri e le funzionalità disponibili dalle impostazioni API del tuo account e dal catalogo dei modelli per il tuo ambiente.

Scegli la struttura del client

JavaScript e Python in stile OpenAI e curl diretto ricevono https://cicora.ai/api/v1 e aggiungono i percorsi senza un secondo /v1.

Gli SDK Messages e Claude Code ricevono la radice del gateway https://cicora.ai/api perché aggiungono autonomamente /v1/messages. Gli esempi seguenti mostrano entrambe le strutture.

Client JavaScript in stile 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" }],
});
Client Python in stile 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"}],
)
Client Messages Python
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"}],
)
Client Messages JavaScript
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" }],
});
Gateway Messages per 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.

Confine dell'integrazione

  • Crea un client per ogni processo o confine sicuro dell'applicazione.
  • Passa timeout e AbortSignal dal flusso di lavoro chiamante.
  • Restituisci lo stato HTTP e un corpo di errore strutturato al codice chiamante.

Versioni e aggiornamenti

Non applicare l'URL di base in stile OpenAI a un SDK Messages e non aggiungere manualmente /v1 alla radice del gateway.

Dopo una modifica del riferimento, aggiorna il client e verifica il percorso principale tramite i modelli prima del rilascio.

Continua con