Hướng dẫn sử dụng

Hướng dẫn tích hợp endpoint LynoC vào IDE, CLI và Agent của bạn.

Endpoint chưa được cấu hình

Địa chỉ API bên dưới là tạm thời. Sau khi deploy proxy lên VPS, endpoint thật sẽ được cập nhật ở đây.

Địa chỉ gốc: https://<YOUR-VPS-DOMAIN>/v1

Giới thiệu

LynoC là một cổng API (API gateway) cho phép bạn gọi nhiều model AI qua một endpoint duy nhất, tương thích chuẩn OpenAI. Bạn dùng cùng một API key và cùng một định dạng request cho mọi model.

Tài liệu này hướng dẫn bạn lấy API key, gọi request đầu tiên, dùng streaming, và tích hợp vào IDE, CLI hoặc agent.

Bắt đầu nhanh

Ba bước để gọi model đầu tiên: (1) tạo API key trong bảng điều khiển, (2) đặt key vào biến môi trường, (3) gửi request tới endpoint chat completions.

export OPENAI_API_KEY="sk-lyno-xxxxxxxxxxxxxxxxxxxxxxxx"

curl https://<YOUR-VPS-DOMAIN>/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4.6",
    "messages": [{"role": "user", "content": "Xin chào LynoC!"}]
  }'

Xác thực

Mọi request cần header Authorization dạng Bearer token với API key của bạn. Tạo và quản lý key trong mục API Keys của bảng điều khiển.

Authorization: Bearer sk-lyno-xxxxxxxxxxxxxxxxxxxxxxxx

Không nhúng key trực tiếp vào mã nguồn hay commit lên repo. Dùng biến môi trường hoặc trình quản lý secret.

Gọi API đầu tiên

Ví dụ với Python (thư viện openai — chỉ cần đổi base_url trỏ về LynoC):

from openai import OpenAI

client = OpenAI(
    base_url="https://<YOUR-VPS-DOMAIN>/v1",
    api_key="sk-lyno-xxxxxxxxxxxxxxxxxxxxxxxx",
)

resp = client.chat.completions.create(
    model="anthropic/claude-sonnet-4.6",
    messages=[{"role": "user", "content": "Giải thích REST API trong 2 câu."}],
)
print(resp.choices[0].message.content)

Hoặc với JavaScript / TypeScript:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://<YOUR-VPS-DOMAIN>/v1",
  apiKey: process.env.OPENAI_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-4.6",
  messages: [{ role: "user", content: "Hello LynoC!" }],
});
console.log(resp.choices[0].message.content);

Streaming

Đặt stream: true để nhận kết quả theo từng token qua Server-Sent Events, hiển thị dần cho người dùng.

stream = client.chat.completions.create(
    model="anthropic/claude-sonnet-4.6",
    messages=[{"role": "user", "content": "Viết một bài thơ ngắn."}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content or ""
    print(delta, end="", flush=True)

Chọn model

Truyền model theo dạng provider/model, ví dụ anthropic/claude-opus-4.8. Xem danh sách đầy đủ và trạng thái trong tab Model của bảng điều khiển.

{
  "model": "anthropic/claude-opus-4.8",
  "messages": [ ... ]
}

Xử lý lỗi

API trả về mã HTTP chuẩn. Các mã thường gặp: 401 (key sai/thiếu), 402 (hết credit/hạn mức), 429 (quá nhiều request), 503 (model tạm dừng hoặc chưa hỗ trợ).

{
  "error": {
    "type": "insufficient_quota",
    "message": "Không đủ credit để thực hiện request."
  }
}

Tích hợp CLI / IDE / Agent

LynoC tương thích chuẩn OpenAI, nên hầu hết công cụ chỉ cần đổi Base URL và API Key. Chọn công cụ của bạn:

export OPENAI_BASE_URL="https://<YOUR-VPS-DOMAIN>/v1"
export OPENAI_API_KEY="sk-lyno-xxxxxxxxxxxxxxxxxxxxxxxx"