cicora.ai
Svenska
API-specifikationKlientkod

SDK:er och HTTP-klienter

Använd olika bas-URL:er för OpenAI-kompatibla klienter och Messages-klienter: de riktar sig mot en specifikation men sätter samman sökvägar på olika sätt.

Integrationsreferens: välj parametrar och tillgängliga funktioner från API-inställningarna för ditt konto och modellkatalogen för din miljö.

Välj klientform

OpenAI-kompatibel JavaScript, Python och rå curl tar emot https://cicora.ai/api/v1 och lägger till sökvägar utan ytterligare /v1.

Messages SDK:er och Claude Code tar emot gateway-roten https://cicora.ai/api eftersom de själva lägger till /v1/messages. Exemplen nedan visar båda formerna.

OpenAI-kompatibel JavaScript-klient
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-kompatibel Python-klient
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 för 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 för 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" }],
});
Messages-gateway för 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.

Integrationsgräns

  • Skapa en klient per process eller säker applikationsgräns.
  • Vidarebefordra timeout och AbortSignal från det anropande arbetsflödet.
  • Returnera HTTP-status och felsvarets strukturerade innehåll till anropskoden.

Versioner och uppdateringar

Använd inte den OpenAI-kompatibla bas-URL:en för ett Messages SDK och lägg inte till /v1 manuellt i dess gateway-rot.

Efter en referensändring uppdaterar du klienten och verifierar huvudflödet genom models före lansering.

Fortsätt med