cicora.ai
Ελληνικά
Προδιαγραφή APIΚώδικας πελάτη

SDK και πελάτες HTTP

Χρησιμοποιήστε διαφορετικές βασικές διευθύνσεις URL για πελάτες τύπου OpenAI και Messages: στοχεύουν μία προδιαγραφή, αλλά συνθέτουν διαφορετικά τις διαδρομές.

Αναφορά ενσωμάτωσης: επιλέξτε παραμέτρους και διαθέσιμες δυνατότητες από τις ρυθμίσεις API του λογαριασμού σας και τον κατάλογο μοντέλων για το περιβάλλον σας.

Επιλέξτε τη μορφή πελάτη

Οι πελάτες JavaScript και Python τύπου OpenAI και το ανεπεξέργαστο curl λαμβάνουν https://cicora.ai/api/v1 και προσθέτουν διαδρομές χωρίς δεύτερο /v1.

Τα SDK Messages και το Claude Code λαμβάνουν τη ρίζα πύλης https://cicora.ai/api επειδή προσθέτουν μόνα τους /v1/messages. Τα παρακάτω παραδείγματα δείχνουν και τις δύο μορφές.

Πελάτης τύπου OpenAI για 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" }],
});
Πελάτης τύπου OpenAI για 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"}],
)
Πελάτης 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"}],
)
Πελάτης 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" }],
});
Πύλη 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.

Όριο ενσωμάτωσης

  • Δημιουργήστε έναν πελάτη ανά διεργασία ή ασφαλές όριο εφαρμογής.
  • Περάστε timeout και AbortSignal από τη ροή εργασίας που καλεί.
  • Επιστρέψτε την κατάσταση HTTP και ένα δομημένο σώμα σφάλματος στον κώδικα που καλεί.

Εκδόσεις και ενημερώσεις

Μην εφαρμόζετε τη βασική διεύθυνση URL τύπου OpenAI σε SDK Messages και μην προσθέτετε χειροκίνητα /v1 στη ρίζα πύλης του.

Μετά από αλλαγή αναφοράς, ενημερώστε τον πελάτη και επαληθεύστε την κύρια διαδρομή μέσω μοντέλων πριν από την έκδοση.

Συνέχεια με