Class: Ask::Providers::OpenAI

Inherits:
Ask::Provider
  • Object
show all
Defined in:
lib/ask/provider/openai.rb

Overview

OpenAI API provider. Also handles all OpenAI-compatible providers (OpenRouter, DeepSeek, Azure, XAI, Perplexity, GPUStack, etc.) via base_url override.

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(config = {}) ⇒ OpenAI

Returns a new instance of OpenAI.



9
10
11
12
13
 
# File 'lib/ask/provider/openai.rb', line 9

def initialize(config = {})
  config = normalize_config(config)
  super(config)
  @http = build_http
end

Class Method Details

.capabilities ⇒ Object 



55
56
57
 
# File 'lib/ask/provider/openai.rb', line 55

def capabilities
  { chat: true, streaming: true, tool_calls: true, vision: true, thinking: true, structured_output: true, embed: true, transcribe: true, paint: true, moderate: true }
end

.configuration_options ⇒ Object 



58
 
# File 'lib/ask/provider/openai.rb', line 58

def configuration_options; %i[api_key base_url organization_id project_id]; end

.configuration_requirements ⇒ Object 



59
 
# File 'lib/ask/provider/openai.rb', line 59

def configuration_requirements; %i[api_key]; end

.configured?(config) ⇒ Boolean

Returns:

  • (Boolean) 


60
61
62
63
 
# File 'lib/ask/provider/openai.rb', line 60

def configured?(config)
  (config.respond_to?(:api_key) && !config.api_key.to_s.empty?) ||
    (config.respond_to?(:openai_api_key) && !config.openai_api_key.to_s.empty?)
end

.slug ⇒ Object 



54
 
# File 'lib/ask/provider/openai.rb', line 54

def slug; "openai"; end

Instance Method Details

#api_base ⇒ Object 



15
16
17
 
# File 'lib/ask/provider/openai.rb', line 15

def api_base
  @config.base_url || "https://api.openai.com/v1"
end

#chat(messages, model:, tools: nil, temperature: nil, stream: nil, schema: nil, **params, &block) ⇒ Object 



28
29
30
31
32
 
# File 'lib/ask/provider/openai.rb', line 28

def chat(messages, model:, tools: nil, temperature: nil, stream: nil, schema: nil, **params, &block)
  msgs = messages.is_a?(Ask::Conversation) ? messages.to_a : messages
  payload = build_chat_payload(msgs, model, tools, temperature, stream, schema, **params)
  stream ? chat_stream(payload, model, &block) : chat_nonstream(payload, model)
end

#embed(texts, model:) ⇒ Object 



34
35
36
37
38
39
40
 
# File 'lib/ask/provider/openai.rb', line 34

def embed(texts, model:)
  texts = Array(texts)
  response = @http.post("embeddings") { |r| r.body = { model: model, input: texts } }
  raise LLM::HTTP.map_error(response.status, response.body, provider: "OpenAI") unless response.success?
  embeddings = response.body["data"].map { |d| d["embedding"] }
  Ask::Result.success(embeddings.one? ? embeddings.first : embeddings)
end

#headers ⇒ Object 



19
20
21
22
23
24
25
26
 
# File 'lib/ask/provider/openai.rb', line 19

def headers
  key = @config.api_key || @config.openai_api_key
  h = { "Content-Type" => "application/json" }
  h["Authorization"] = "Bearer #{key}" if key
  h["OpenAI-Organization"] = @config.organization_id if @config.organization_id
  h["OpenAI-Project"] = @config.project_id if @config.project_id
  h
end

#list_models ⇒ Object 



42
43
44
45
46
 
# File 'lib/ask/provider/openai.rb', line 42

def list_models
  response = @http.get("models")
  return [] unless response.success?
  response.body["data"].map { |m| Ask::ModelInfo.new(id: m["id"], provider: slug, metadata: { owned_by: m["owned_by"] }) }
end

#parse_error(response) ⇒ Object 



48
49
50
51
 
# File 'lib/ask/provider/openai.rb', line 48

def parse_error(response)
  body = response.body rescue nil
  body&.dig("error", "message") || body&.dig("error", "code")
end