AIGNE Hub | ArcBlock

AIGNE Hub 提供一個統一的代理層，用於存取來自多個供應商的各種大型語言模型（LLM）、圖像和影片生成服務。透過使用 @aigne/aigne-hub 套件，您可以無縫切換不同的 AI 模型，而無需更改您的用戶端應用程式邏輯，將所有請求導向一個單一、一致的 API 端點。

本指南涵蓋了 AIGNEHubChatModel、AIGNEHubImageModel 和 AIGNEHubVideoModel 類別的安裝、設定和使用，以將您的應用程式連接到 AIGNE Hub。

概覽

AIGNE Hub 作為一個閘道，聚合了如 OpenAI、Anthropic、Google 等主要 AI 供應商。這種架構透過抽象化每個供應商 API 的特定要求，簡化了整合過程。您只需傳遞模型的唯一識別碼（包含供應商前綴，例如 openai/gpt-4o-mini 或 anthropic/claude-3-sonnet），即可與任何支援的模型進行互動。

主要功能

統一存取：為所有 LLM、圖像和影片生成請求提供單一端點。
多供應商支援：存取來自 OpenAI、Anthropic、AWS Bedrock、Google、DeepSeek、Ollama、xAI 和 OpenRouter 的模型。
安全驗證：透過單一 API 金鑰（apiKey）管理存取。
聊天、圖像和影片模型：支援聊天完成、圖像生成和影片創作。
串流處理：為聊天回應提供即時、權杖層級的串流。
無縫整合：設計用於與更廣泛的 AIGNE 框架協同工作。

支援的供應商

AIGNE Hub 透過其統一的 API 支援眾多 AI 供應商。

供應商	識別碼
OpenAI	`openai`
Anthropic	`anthropic`
AWS Bedrock	`bedrock`
DeepSeek	`deepseek`
Google	`google`
Ollama	`ollama`
OpenRouter	`openRouter`
xAI	`xai`

安裝

若要開始，請在您的專案中安裝 @aigne/aigne-hub 和 @aigne/core 套件。

npm install

npm install @aigne/aigne-hub @aigne/core

yarn add

yarn add @aigne/aigne-hub @aigne/core

pnpm add

pnpm add @aigne/aigne-hub @aigne/core

設定

聊天、圖像和影片模型需要進行設定才能連接到您的 AIGNE Hub 實例。主要選項包括 Hub 的 URL、存取金鑰和所需的模型識別碼。

模型設定

設定選項在 AIGNEHubChatModel、AIGNEHubImageModel 和 AIGNEHubVideoModel 中是一致的。

baseUrl string (required) — 您的 AIGNE Hub 實例的基礎 URL（例如，https://your-aigne-hub-instance/ai-kit）。
apiKey string (required) — 用於向 AIGNE Hub 進行驗證的 API 存取金鑰。
model string (required) — 模型識別碼，以供應商為前綴（例如，openai/gpt-4o-mini）。
modelOptions object — 可選的模型特定參數，將傳遞給供應商的 API。

使用方式

聊天完成

若要執行聊天完成，請使用您的設定實例化 AIGNEHubChatModel 並呼叫 invoke 方法。

基本聊天完成

import { AIGNEHubChatModel } from "@aigne/aigne-hub";

const model = new AIGNEHubChatModel({
  baseUrl: "https://your-aigne-hub-instance/ai-kit",
  apiKey: "your-access-key-secret",
  model: "openai/gpt-4o-mini",
});

const result = await model.invoke({
  messages: [{ role: "user", content: "Hello, world!" }],
});

console.log(result);

回應範例

{
  "text": "Hello! How can I help you today?",
  "model": "openai/gpt-4o-mini",
  "usage": {
    "inputTokens": 8,
    "outputTokens": 9
  }
}

模型範例：

openai/gpt-4o-mini
anthropic/claude-3-sonnet
google/gemini-pro
xai/grok-1
openRouter/mistralai/mistral-7b-instruct
ollama/llama3

串流聊天回應

若要獲得即時回應，請在 invoke 呼叫中將 streaming 選項設為 true。這會返回一個非同步迭代器，在回應區塊可用時產生它們。

串流範例

import { AIGNEHubChatModel } from "@aigne/aigne-hub";
import { isAgentResponseDelta } from "@aigne/core";

const model = new AIGNEHubChatModel({
  baseUrl: "https://your-aigne-hub-instance/ai-kit",
  apiKey: "your-access-key-secret",
  model: "openai/gpt-4o-mini",
});

const stream = await model.invoke(
  {
    messages: [{ role: "user", content: "Hello, who are you?" }],
  },
  { streaming: true },
);

let fullText = "";
for await (const chunk of stream) {
  if (isAgentResponseDelta(chunk)) {
    const text = chunk.delta.text?.text;
    if (text) {
      fullText += text;
      process.stdout.write(text);
    }
  }
}

console.log("\n--- Response Complete ---");
console.log(fullText);

圖像生成

AIGNE Hub 支援來自多個供應商的圖像生成。實例化 AIGNEHubImageModel 並提供提示和模型特定參數。

OpenAI DALL-E

使用 DALL-E 3 生成

import { AIGNEHubImageModel } from "@aigne/aigne-hub";

const model = new AIGNEHubImageModel({
  baseUrl: "https://your-aigne-hub-instance/ai-kit",
  apiKey: "your-access-key-secret",
  model: "openai/dall-e-3",
});

const result = await model.invoke({
  prompt: "A futuristic cityscape with flying cars and neon lights",
  n: 1,
  size: "1024x1024",
  quality: "standard",
  style: "natural",
});

console.log(result.images[0].url);

參考資料：OpenAI Images API Documentation

Google Gemini Imagen

使用 Imagen 生成

import { AIGNEHubImageModel } from "@aigne/aigne-hub";

const model = new AIGNEHubImageModel({
  baseUrl: "https://your-aigne-hub-instance/ai-kit",
  apiKey: "your-access-key-secret",
  model: "google/imagen-4.0-generate-001",
});

const result = await model.invoke({
  prompt: "A serene mountain landscape at sunset",
  n: 1,
  aspectRatio: "1:1",
});

console.log(result.images[0].base64); // 注意：Gemini 模型返回 base64 資料

參考資料：Google AI Generative Models API

Ideogram

使用 Ideogram 生成

import { AIGNEHubImageModel } from "@aigne/aigne-hub";

const model = new AIGNEHubImageModel({
  baseUrl: "https://your-aigne-hub-instance/ai-kit",
  apiKey: "your-access-key-secret",
  model: "ideogram/ideogram-v3",
});

const result = await model.invoke({
  prompt: "A cyberpunk character with glowing blue eyes, cinematic style",
  aspectRatio: "1:1",
  styleType: "cinematic",
});

console.log(result.images[0].url);

參考資料：Ideogram API Documentation

影片生成

AIGNE Hub 將其統一的 API 擴展到由 AI 驅動、來自領先供應商的影片生成服務。若要創建影片，請使用適當的設定實例化 AIGNEHubVideoModel。

OpenAI Sora

使用 Sora 生成

import { AIGNEHubVideoModel } from "@aigne/aigne-hub";

const model = new AIGNEHubVideoModel({
  baseUrl: "https://your-aigne-hub-instance/ai-kit",
  apiKey: "your-access-key-secret",
  model: "openai/sora-2",
});

const result = await model.invoke({
  prompt: "A serene beach scene with gentle waves at sunset",
  size: "1280x720",
  seconds: "8",
  outputFileType: "url",
});

console.log(result);

回應範例

{
  "videos": [{ "url": "https://...", "type": "url" }],
  "usage": {
    "inputTokens": 0,
    "outputTokens": 0,
    "aigneHubCredits": 200
  },
  "model": "openai/sora-2",
  "seconds": 8
}

參考資料：OpenAI Video API Documentation

Google Gemini Veo

使用 Veo 生成

import { AIGNEHubVideoModel } from "@aigne/aigne-hub";

const model = new AIGNEHubVideoModel({
  baseUrl: "https://your-aigne-hub-instance/ai-kit",
  apiKey: "your-access-key-secret",
  model: "google/veo-3.1-generate-preview",
});

const result = await model.invoke({
  prompt: "A majestic eagle soaring through mountain valleys",
  aspectRatio: "16:9",
  size: "1080p",
  seconds: "6",
  outputFileType: "url",
});

console.log(result);

回應範例

{
  "videos": [{ "url": "https://...", "type": "url" }],
  "usage": {
    "inputTokens": 0,
    "outputTokens": 0,
    "aigneHubCredits": 150
  },
  "model": "google/veo-3.1-generate-preview",
  "seconds": 6
}

參考資料：Google Gemini Video API Documentation

總結

@aigne/aigne-hub 套件為 AIGNE Hub 服務提供了一個統一的用戶端，簡化了多供應商 LLM 的整合。透過抽象化聊天、圖像和影片模型的供應商特定邏輯，它使開發人員能夠建構更靈活、更易於維護的 AI 驅動應用程式。

有關特定模型及其功能的更多詳細資訊，請參閱各 AI 供應商提供的文件。若要探索其他模型整合，請參閱模型概覽。