cicora.ai
API-specifikációKlienskód

SDK-k és HTTP-kliensek

Az OpenAI-stílusú és Messages-kliensekhez eltérő alap-URL-t használjon: ugyanazt a specifikációt célozzák, de eltérően állítják össze az útvonalakat.

Integrációs referencia: válassza ki a paramétereket és az elérhető képességeket a fiókja API-beállításaiból és a környezetéhez tartozó modellkatalógusból.

A kliens alakjának kiválasztása

Az OpenAI-stílusú JavaScript, Python és nyers curl a https://cicora.ai/api/v1 címet kapja, és az útvonalakat második /v1 nélkül fűzi hozzá.

A Messages SDK-k és a Claude Code a https://cicora.ai/api átjárógyökeret kapják, mert maguk fűzik hozzá a /v1/messages útvonalat. Az alábbi példák mindkét alakot bemutatják.

JavaScript OpenAI-stílusú kliens
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 OpenAI-stílusú kliens
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-kliens
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-kliens
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-átjáró
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.

Integrációs határ

  • Folyamatonként vagy biztonságos alkalmazáshatáronként egy klienst hozzon létre.
  • A hívó munkafolyamatból adja át az időtúllépést és az AbortSignal értéket.
  • Adja vissza a HTTP-állapotot és a strukturált hibatörzset a hívó kódnak.

Verziók és frissítések

Ne használja az OpenAI-stílusú alap-URL-t Messages SDK-hoz, és ne fűzze kézzel a /v1 elemet az átjárógyökeréhez.

Referenciamódosítás után frissítse a klienst, és kiadás előtt a models útvonalon ellenőrizze a fő folyamatot.