cicora.ai
API-specifikationKlientkode

SDK'er og HTTP-klienter

Brug forskellige basis-URL'er til klienter i OpenAI-stil og Messages-klienter: de er målrettet samme specifikation, men sammensætter stier forskelligt.

Integrationsreference: Vælg parametre og tilgængelige funktioner fra API-indstillingerne for kontoen og modelkataloget for dit miljø.

Vælg klientform

JavaScript, Python og rå curl i OpenAI-stil modtager https://cicora.ai/api/v1 og tilføjer ruter uden endnu en /v1.

Messages-SDK'er og Claude Code modtager gateway-roden https://cicora.ai/api fordi de selv tilføjer /v1/messages. Eksemplerne nedenfor viser begge former.

JavaScript-klient i OpenAI-stil
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" }],
});
Python-klient i OpenAI-stil
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-klient for 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"}],
)
JavaScript-klient for 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" }],
});
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.

Integrationsgrænse

  • Opret én klient pr. proces eller sikker applikationsgrænse.
  • Send timeout og AbortSignal fra den kaldende arbejdsgang.
  • Returnér HTTP-status og en struktureret brødtekst fra fejlsvaret til den kaldende kode.

Versioner og opdateringer

Brug ikke basis-URL'en i OpenAI-stil til et Messages-SDK, og føj ikke /v1 manuelt til dets gateway-rod.

Efter en referenceændring opdaterer du klienten og kontrollerer hovedforløbet gennem modeller før lancering.