اختيار بنية العميل
تتلقى تطبيقات JavaScript وPython وcurl الخام بأسلوب OpenAI العنوان https://cicora.ai/api/v1 وتضيف المسارات من دون /v1 ثانية.
تتلقى حزم Messages SDK و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 على Messages SDK، ولا تضف /v1 يدويًا إلى جذر بوابته.
بعد تغيير المرجع، حدّث العميل وتحقق من المسار الرئيسي عبر النماذج قبل الإصدار.