SDK 概覽

Vecstruct 提供三個官方 SDK，讓你在最熟悉的語言中直接使用所有功能。

SDK	最低版本需求	安裝
Node.js / TypeScript	Node.js v22+	npm install @vecstruct/sdk
Python	Python 3.12+	pip install vecstruct
Go	Go 1.25+	go get github.com/vecstruct/vecstruct-sdk-go

SDK 覆蓋的功能

所有 SDK 都支援：

• AI Gateway（Chat Completions、Embeddings、Rerank）
• RAG 知識庫查詢
• Memory 管理、語義搜尋、自動萃取
• 文件管理（上傳、索引、查詢段落）
• 稽核日誌查詢與匯出
• 認證資訊查詢

也可以用 OpenAI SDK

Vecstruct AI Gateway 與 OpenAI API 100% 相容。如果你只需要 Chat Completions 功能，直接用現有的 OpenAI SDK，替換 base_url 就好：

Node.js

npm install openai dotenv

import 'dotenv/config';
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.VECSTRUCT_API_KEY,
  baseURL: 'https://api.vecstruct.com/v1',
});

Python

pip install openai python-dotenv

import os
from dotenv import load_dotenv
from openai import OpenAI

load_dotenv()

client = OpenAI(
    api_key=os.environ["VECSTRUCT_API_KEY"],
    base_url="https://api.vecstruct.com/v1",
)

Go

go get github.com/sashabaranov/go-openai
go get github.com/joho/godotenv

import (
    openai "github.com/sashabaranov/go-openai"
    "github.com/joho/godotenv"
    "os"
)

godotenv.Load()

cfg := openai.DefaultConfig(os.Getenv("VECSTRUCT_API_KEY"))
cfg.BaseURL = "https://api.vecstruct.com/v1"
client := openai.NewClientWithConfig(cfg)

RAG、Memory、Documents、稽核日誌等 Vecstruct 專屬功能需要使用 Vecstruct SDK。

程式碼範例

各 SDK 的 GitHub 儲存庫提供更多完整範例：

• vecstruct-sdk-node
• vecstruct-sdk-python
• vecstruct-sdk-go