cicora.ai
Spesifikasi APIKode klien

SDK dan klien HTTP

Gunakan URL dasar yang berbeda untuk klien bergaya OpenAI dan Messages: keduanya menargetkan spesifikasi yang sama, tetapi menyusun path dengan cara berbeda.

Referensi integrasi: pilih parameter dan kemampuan yang tersedia dari pengaturan API akun Anda dan katalog model untuk lingkungan Anda.

Pilih bentuk klien

Klien bergaya OpenAI untuk JavaScript dan Python, serta curl mentah, menerima https://cicora.ai/api/v1 dan menambahkan rute tanpa /v1 kedua.

Messages SDK dan Claude Code menerima root gateway https://cicora.ai/api karena keduanya menambahkan /v1/messages sendiri. Contoh di bawah menunjukkan kedua bentuk tersebut.

Klien bergaya OpenAI untuk JavaScript
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 bergaya OpenAI untuk Python
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 untuk 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 untuk 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" }],
});
Gateway Messages untuk 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.

Batas integrasi

  • Buat satu klien per proses atau per batas aplikasi yang aman.
  • Teruskan timeout dan AbortSignal dari alur kerja pemanggil.
  • Kembalikan status HTTP dan isi kesalahan terstruktur ke kode pemanggil.

Versi dan pembaruan

Jangan terapkan URL dasar bergaya OpenAI pada Messages SDK atau menambahkan /v1 secara manual ke root gateway-nya.

Setelah perubahan referensi API, perbarui klien dan verifikasi jalur utama melalui model sebelum rilis.