@ghostspeak/plugin-gateway-ghost

Unified Vercel AI Gateway plugin for ElizaOS - one API key for all model types.

Features

• Single API Key: One AI_GATEWAY_API_KEY for all model operations
• January 2026 Models: Claude Haiku/Opus 4.5, FLUX 2 Pro, Grok 2 Vision
• Full Model Coverage: Text, embeddings, images, vision, speech, transcription
• Streaming Support: Full async streaming for text generation
• Local Tokenization: Uses js-tiktoken, no API calls needed

Supported Model Types

| ModelType | Default Model | Description | |-----------|---------------|-------------| | TEXT_SMALL | anthropic/claude-haiku-4.5 | Fast, efficient text | | TEXT_LARGE | anthropic/claude-opus-4.5 | Best quality reasoning | | TEXT_EMBEDDING | openai/text-embedding-3-large | 3072-dim embeddings | | OBJECT_SMALL | anthropic/claude-haiku-4.5 | Structured JSON output | | OBJECT_LARGE | anthropic/claude-opus-4.5 | Complex structured output | | IMAGE | bfl/flux-2-pro | Image generation (FLUX) | | IMAGE_DESCRIPTION | xai/grok-2-vision | Vision/multimodal | | TRANSCRIPTION | openai/whisper-1 | Speech-to-text | | TEXT_TO_SPEECH | openai/tts-1-hd | Text-to-speech (HD) | | TEXT_TOKENIZER_* | (local) | Token encode/decode |

Installation

npm install @ghostspeak/plugin-gateway-ghost
# or
bun add @ghostspeak/plugin-gateway-ghost

Configuration

Environment Variables

# Required
AI_GATEWAY_API_KEY=your_vercel_ai_gateway_key

# Optional (with defaults)
AI_GATEWAY_BASE_URL=https://ai-gateway.vercel.sh/v1
AI_GATEWAY_TEXT_SMALL_MODEL=anthropic/claude-haiku-4.5
AI_GATEWAY_TEXT_LARGE_MODEL=anthropic/claude-opus-4.5
AI_GATEWAY_EMBEDDING_MODEL=openai/text-embedding-3-large
AI_GATEWAY_IMAGE_MODEL=bfl/flux-2-pro
AI_GATEWAY_VISION_MODEL=xai/grok-2-vision
AI_GATEWAY_TRANSCRIPTION_MODEL=openai/whisper-1
AI_GATEWAY_TTS_MODEL=openai/tts-1-hd
AI_GATEWAY_TTS_VOICE=alloy

Character Configuration

{
  "name": "YourAgent",
  "plugins": ["@ghostspeak/plugin-gateway-ghost"],
  "bio": "Your agent bio..."
}

Usage

The plugin automatically registers model handlers when loaded. ElizaOS will use these handlers for all model operations:

// The plugin registers handlers for:
// - runtime.generateText() -> TEXT_SMALL/TEXT_LARGE
// - runtime.embed() -> TEXT_EMBEDDING
// - runtime.generateObject() -> OBJECT_SMALL/OBJECT_LARGE
// - runtime.generateImage() -> IMAGE
// - etc.

Development

# Install dependencies
bun install

# Build
bun run build

# Test (requires AI_GATEWAY_API_KEY)
AI_GATEWAY_API_KEY=your_key bun test

License

MIT