cicora.ai
Đặc tả APIMã ứng dụng khách

SDK và ứng dụng khách HTTP

Dùng URL cơ sở khác nhau cho ứng dụng khách kiểu OpenAI và Messages: chúng nhắm đến một đặc tả nhưng ghép đường dẫn khác nhau.

Tài liệu tham khảo tích hợp: chọn tham số và năng lực khả dụng từ cài đặt API tài khoản và danh mục mô hình cho môi trường của bạn.

Chọn dạng ứng dụng khách

JavaScript, Python kiểu OpenAI và curl thô nhận https://cicora.ai/api/v1 rồi nối các tuyến mà không thêm /v1 lần thứ hai.

Messages SDK và Claude Code nhận URL gốc của cổng API https://cicora.ai/api vì chúng tự nối /v1/messages. Các ví dụ bên dưới minh họa cả hai dạng.

Ứng dụng khách JavaScript kiểu 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" }],
});
Ứng dụng khách Python kiểu 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"}],
)
Ứng dụng khách Python Messages
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"}],
)
Ứng dụng khách JavaScript Messages
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" }],
});
Cổng API Messages cho 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.

Ranh giới tích hợp

  • Tạo một ứng dụng khách cho mỗi tiến trình hoặc ranh giới ứng dụng an toàn.
  • Truyền timeout và AbortSignal từ quy trình gọi.
  • Trả trạng thái HTTP và nội dung lỗi có cấu trúc cho mã gọi.

Phiên bản và cập nhật

Không áp dụng URL cơ sở kiểu OpenAI cho Messages SDK hoặc tự nối /v1 vào URL gốc của cổng API mà SDK đó dùng.

Sau khi tham chiếu thay đổi, cập nhật ứng dụng khách và xác minh đường đi chính qua models trước khi phát hành.