lex-openai

OpenAI integration for LegionIO. Provides runners for chat completions, image generation, audio processing, embeddings, file management, and content moderation via the OpenAI API.

gem install lex-openai

Or add to your Gemfile:

gem 'lex-openai'

• create - Create a chat completion

• list - List available models
• retrieve - Get model details
• delete - Delete a fine-tuned model

• generate - Generate images from text prompts (DALL-E 3 default)
• edit - Edit images with text prompts and masks (DALL-E 2)
• variation - Create variations of an image (DALL-E 2)

• speech - Generate speech from text (TTS, default model: tts-1)
• transcribe - Transcribe audio to text (Whisper)
• translate - Translate audio to English text (Whisper)

• create - Generate vector embeddings (default model: text-embedding-3-small)

• list - List uploaded files
• upload - Upload a file
• retrieve - Get file metadata
• delete - Delete a file
• content - Download file content

• create - Classify content for policy compliance

Set your API key in your LegionIO settings:

{
  "openai": {
    "api_key": "sk-..."
  }
}

Runner modules can be extended directly onto any module or object. Each runner method requires api_key: as a keyword argument.

require 'legion/extensions/openai/runners/chat'
require 'legion/extensions/openai/runners/images'

# Chat completion
module ChatClient
  extend Legion::Extensions::Openai::Runners::Chat
end

result = ChatClient.create(
  model: 'gpt-4o',
  messages: [{ role: 'user', content: 'Hello!' }],
  api_key: ENV['OPENAI_API_KEY']
)
puts result[:result]['choices'].first['message']['content']

# Image generation
module ImageClient
  extend Legion::Extensions::Openai::Runners::Images
end

image = ImageClient.generate(
  prompt: 'A futuristic city at sunset',
  model: 'dall-e-3',
  api_key: ENV['OPENAI_API_KEY']
)
puts image[:result]['data'].first['url']

• faraday >= 2.0 - HTTP client
• faraday-multipart >= 1.0 - Multipart file uploads (images, audio, files)
• multi_json - JSON parser abstraction

• Ruby >= 3.4
• LegionIO framework (optional for standalone runner usage)
• OpenAI API key

MIT