cicora.ai
Bahasa Melayu
Spesifikasi APIKod klien

SDK dan klien HTTP

Gunakan URL asas berbeza untuk klien gaya OpenAI dan Messages: kedua-duanya menyasarkan satu spesifikasi tetapi menyusun laluan secara berbeza.

Rujukan penyepaduan: pilih parameter dan keupayaan yang tersedia daripada tetapan API akaun serta katalog model untuk persekitaran anda.

Pilih bentuk klien

Klien JavaScript dan Python gaya OpenAI serta curl mentah menerima https://cicora.ai/api/v1 dan menambah laluan tanpa /v1 kedua.

SDK Messages dan Claude Code menerima akar gerbang https://cicora.ai/api kerana ia menambah /v1/messages sendiri. Contoh di bawah menunjukkan kedua-dua bentuk.

Klien JavaScript gaya 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" }],
});
Klien Python gaya 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"}],
)
Klien 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"}],
)
Klien 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" }],
});
Gerbang Messages 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.

Sempadan penyepaduan

  • Cipta satu klien bagi setiap proses atau sempadan aplikasi yang selamat.
  • Salurkan timeout dan AbortSignal daripada aliran kerja pemanggil.
  • Kembalikan status HTTP dan badan ralat berstruktur kepada kod pemanggil.

Versi dan kemas kini

Jangan gunakan URL asas gaya OpenAI pada SDK Messages atau menambah /v1 secara manual pada akar gerbangnya.

Selepas perubahan rujukan, kemas kini klien dan sahkan laluan utama melalui models sebelum keluaran.

Teruskan dengan