Tài liệu API

Mọi thứ bạn cần để tích hợp Seizn vào ứng dụng của mình. Thêm bộ nhớ lâu dài cho AI của bạn chỉ với vài dòng code.

Khởi động nhanh

Lấy API key của bạn từ bảng điều khiển, sau đó bắt đầu gửi yêu cầu:

bash

# Add a memory
curl -X POST https://seizn.com/api/memories \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "User prefers dark mode interfaces"}'

# Search memories
curl "https://seizn.com/api/memories?query=user+preferences" \
  -H "Authorization: Bearer YOUR_API_KEY"

Xác thực

Tất cả yêu cầu API đều cần API key trong x-api-key header.

bash

curl -H "Authorization: Bearer szn_your_api_key_here" \
  https://seizn.com/api/memories?query=test

Bảo mật: Giữ bí mật API key của bạn. Không bao giờ để lộ chúng trong code phía client. Sử dụng biến môi trường hoặc backend proxy.

API Endpoints

POST/api/memories

Thêm một ký ức mới vào kho lưu trữ của người dùng.

Request Body

content-string (required)

memory_type-string - fact, preference, experience, relationship, instruction

tags-string[]

namespace-string (default: "default")

scope-string - user, session, agent

session_id-string

agent_id-string

Phản hồi

{
  "success": true,
  "memory": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "content": "User prefers dark mode interfaces",
    "memory_type": "preference",
    "tags": ["ui", "settings"],
    "namespace": "default",
    "created_at": "2026-01-08T10:30:00Z"
  }
}

GET/api/memories

Tìm kiếm ký ức bằng độ tương đồng ngữ nghĩa.

Query Parameters

query-string (required)

limit-number (default: 10, max: 100)

threshold-number 0-1 (default: 0.7)

namespace-string

Phản hồi

{
  "success": true,
  "results": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "content": "User prefers dark mode interfaces",
      "memory_type": "preference",
      "tags": ["ui", "settings"],
      "similarity": 0.89
    }
  ],
  "count": 1
}

DELETE/api/memories

Xóa ký ức theo ID.

Query Parameters

ids-string (required) - comma-separated

Phản hồi

{
  "success": true,
  "deleted": 3
}

POST/api/extract

Trích xuất và lưu trữ ký ức từ cuộc hội thoại bằng AI.

Request Body

conversation-string (required)

model-string - haiku | sonnet (default: haiku)

auto_store-boolean (default: true)

namespace-string (default: "default")

Phản hồi

{
  "message": "Extracted 3 memories, stored 3",
  "extracted": [
    {
      "content": "User is a software developer working with Python",
      "memory_type": "fact",
      "tags": ["profession", "programming"],
      "confidence": 0.95,
      "importance": 7
    }
  ],
  "stored": [...]
}

POST/api/query

Nhận phản hồi từ AI sử dụng ký ức liên quan làm ngữ cảnh (RAG).

Request Body

query-string (required)

model-string - haiku | sonnet (default: haiku)

top_k-number (default: 5)

namespace-string

include_memories-boolean (default: true)

Phản hồi

{
  "response": "Based on your preferences, I'd recommend using VS Code with a dark theme...",
  "memories_used": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "content": "User prefers dark mode interfaces",
      "similarity": 0.85
    }
  ],
  "model_used": "haiku"
}

Giới hạn

Gói	Lượt gọi API hàng tháng	Ký ức tối đa	API Keys
Miễn phí	1,000	100	2
Starter	50,000	5,000	3
Plus	500,000	50,000	5
Pro	2,000,000	Không giới hạn	10
Enterprise	Không giới hạn	Không giới hạn	100

Khi bạn vượt quá giới hạn, API trả về 429 Too Many Requests phản hồi.

Mã lỗi

Mã	Mô tả
`200`	Thành công
`400`	Bad Request - Thiếu hoặc tham số không hợp lệ
`401`	Unauthorized - API key không hợp lệ hoặc thiếu
`429`	Too Many Requests - Vượt quá giới hạn
`500`	Internal Server Error - Đã xảy ra lỗi

Bảo mật & Quản trị

Bảo mật dữ liệu

✓Mã hóa khi lưu trữ: Tất cả dữ liệu được mã hóa bằng AES-256
✓Mã hóa khi truyền tải: TLS 1.3 cho tất cả kết nối
✓Cô lập tenant: Tách biệt dữ liệu hoàn toàn giữa các tài khoản

Quản lý API Key

✓Xoay key: Xoay key bất cứ lúc nào từ bảng điều khiển
✓Hết hạn key: Tự động hết hạn key sau 90 ngày (có thể cấu hình)
✓Theo dõi sử dụng: Giám sát sử dụng theo từng key theo thời gian thực

Lưu giữ & Xóa dữ liệu

✓Xuất: Xuất tất cả dữ liệu bất cứ lúc nào qua API hoặc bảng điều khiển
✓Xóa: Xóa vĩnh viễn không lưu giữ sau 30 ngày
✓GDPR/CCPA: Tuân thủ đầy đủ quyền của chủ thể dữ liệu

SDKs

Python

bash

pip install seizn

python

from seizn import Seizn

client = Seizn(api_key="your_api_key")

# Add memory
client.add("User prefers dark mode")

# Search
results = client.search("preferences")

# Extract from conversation
client.extract(conversation="...")

JavaScript

bash

npm install seizn

javascript

import { Seizn } from 'seizn';

const client = new Seizn({ apiKey: 'your_api_key' });

// Add memory
await client.add('User prefers dark mode');

// Search
const results = await client.search('preferences');

// Extract from conversation
await client.extract({ conversation: '...' });

MCP Server — Every Editor, One Memory

The Seizn MCP Server (seizn-mcp) bridges your Seizn memories to AI coding assistants via the Model Context Protocol. 40+ tools, MCP Resources, webhooks, OAuth device flow, and multi-editor config sync — all in one package.

bash

# Install globally or use npx
npx seizn-mcp@latest

# Or add to Claude Code settings (~/.claude/settings.json)
{
  "mcpServers": {
    "seizn": {
      "command": "npx",
      "args": ["-y", "seizn-mcp@latest"],
      "env": { "SEIZN_API_KEY": "your-api-key" }
    }
  }
}

Supported Editors

> Claude Code — native MCP
> Cursor — native MCP
> Windsurf — native MCP
> Cline — native MCP
~ GitHub Copilot — via config sync
~ Aider — via config sync
~ OpenAI Codex — via config sync

Key Features

> 40+ MCP Tools — memories, knowledge graph, profile, webhooks, config sync
> MCP Resources — seizn://memories/recent, seizn://profile, seizn://context/{format}
> OAuth Device Flow — browser auth, no API key copy
> Auto Context — detects project from package.json, pyproject.toml, Cargo.toml
> UTF-8 Support — Korean, Japanese, Chinese, Arabic and 100+ languages

Multi-Editor Config Sync

Seizn exports your memories as editor-specific configuration files. Your AI preferences follow you across every tool.

File	AI Tool	Method
CLAUDE.md	Claude Code	MCP + File
AGENTS.md	OpenAI Codex	File Sync
.cursor/rules	Cursor	MCP + File
.windsurfrules	Windsurf	MCP + File
.github/copilot-instructions.md	GitHub Copilot	File Sync
.clinerules	Cline	MCP + File
CONVENTIONS.md	Aider	File Sync

OAuth Device Flow

No more copying API keys. The MCP server supports RFC 8628 Device Authorization Grant for browser-based authentication.

Run auth_login tool

Enter code ABCD-1234 in browser

Token saved to ~/.seizn/

Zero-copy auth: The device flow generates a human-readable code, opens your browser, and saves credentials automatically. Works with any terminal or SSH session.