cicora.ai
Deutsch
API-SpezifikationClient-Code

SDKs und HTTP-Clients

Verwenden Sie unterschiedliche Basis-URLs für OpenAI-kompatible Clients und Messages-Clients: Sie zielen auf dieselbe Spezifikation ab, setzen Pfade jedoch unterschiedlich zusammen.

Integrationsreferenz: Wählen Sie Parameter und verfügbare Funktionen in den API-Einstellungen Ihres Kontos und im Modellkatalog für Ihre Umgebung aus.

Client-Form auswählen

OpenAI-kompatibles JavaScript und Python sowie reines curl erhalten https://cicora.ai/api/v1 und hängen Routen ohne ein zweites /v1 an.

Messages SDKs und Claude Code erhalten https://cicora.ai/api als Gateway-Stammverzeichnis, da sie /v1/messages selbst anhängen. Die folgenden Beispiele zeigen beide Formen.

OpenAI-kompatibler JavaScript-Client
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" }],
});
OpenAI-kompatibler Python-Client
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"}],
)
Python-Messages-Client
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"}],
)
JavaScript-Messages-Client
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" }],
});
Claude-Code-Messages-Gateway
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.

Integrationsgrenze

  • Erstellen Sie einen Client pro Prozess oder sicherer Anwendungsgrenze.
  • Übergeben Sie Timeout und AbortSignal aus dem aufrufenden Arbeitsablauf.
  • Geben Sie HTTP-Status und einen strukturierten Fehlertext an den aufrufenden Code zurück.

Versionen und Aktualisierungen

Wenden Sie die OpenAI-kompatible Basis-URL nicht auf ein Messages SDK an und hängen Sie /v1 nicht manuell an dessen Gateway-Stammverzeichnis an.

Aktualisieren Sie den Client nach einer Referenzänderung und prüfen Sie den Hauptpfad über Modelle vor der Veröffentlichung.

Fortfahren mit