OpenAILanguageModel: OpenAI Language Model Class

In aisdk: Unified Interface for AI Model Providers

OpenAI Language Model Class

Description

Language model implementation for OpenAI's chat completions API. Exported so that OpenAI-compatible providers in companion packages (e.g. aisdk.providers) can inherit from it across package boundaries.

Super class

aisdk::LanguageModelV1 -> OpenAILanguageModel

Methods

Public methods

• OpenAILanguageModel$new()

• OpenAILanguageModel$get_config()

• OpenAILanguageModel$build_payload()

• OpenAILanguageModel$execute_request()

• OpenAILanguageModel$parse_response()

• OpenAILanguageModel$do_generate()

• OpenAILanguageModel$build_stream_payload()

• OpenAILanguageModel$do_stream()

• OpenAILanguageModel$format_tool_result()

• OpenAILanguageModel$get_history_format()

• OpenAILanguageModel$clone()

Inherited methods

• aisdk::LanguageModelV1$generate()
• aisdk::LanguageModelV1$has_capability()
• aisdk::LanguageModelV1$stream()

---

Method new()

Initialize the OpenAI language model.

Usage

OpenAILanguageModel$new(model_id, config, capabilities = list())

Arguments

model_id

The model ID (e.g., "gpt-4o").

config

Configuration list with api_key, base_url, headers, etc.

capabilities

Optional list of capability flags.

---

Method get_config()

Get the configuration list.

Usage

OpenAILanguageModel$get_config()

Returns

A list with provider configuration.

---

Method build_payload()

Build the request payload for non-streaming generation. Subclasses can override to customize payload construction.

Usage

OpenAILanguageModel$build_payload(params)

Arguments

params

A list of call options.

Returns

A list with url, headers, and body.

---

Method execute_request()

Execute the API request.

Usage

OpenAILanguageModel$execute_request(
  url,
  headers,
  body,
  timeout_seconds = NULL,
  total_timeout_seconds = NULL,
  first_byte_timeout_seconds = NULL,
  connect_timeout_seconds = NULL,
  idle_timeout_seconds = NULL
)

Arguments

url

The API endpoint URL.

headers

A named list of HTTP headers.

body

The request body.

timeout_seconds

Legacy alias for total_timeout_seconds.

total_timeout_seconds

Optional total request timeout override in seconds.

first_byte_timeout_seconds

Optional time-to-first-byte timeout override in seconds.

connect_timeout_seconds

Optional connection timeout override in seconds.

idle_timeout_seconds

Optional stall timeout override in seconds.

Returns

The parsed API response.

---

Method parse_response()

Parse the API response into a GenerateResult. Subclasses can override to extract provider-specific fields (e.g., reasoning_content).

Usage

OpenAILanguageModel$parse_response(response)

Arguments

response

The parsed API response.

Returns

A GenerateResult object.

---

Method do_generate()

Generate text (non-streaming). Uses template method pattern.

Usage

OpenAILanguageModel$do_generate(params)

Arguments

params

A list of call options including messages, temperature, etc.

Returns

A GenerateResult object.

---

Method build_stream_payload()

Build the request payload for streaming generation. Subclasses can override to customize stream payload construction.

Usage

OpenAILanguageModel$build_stream_payload(params)

Arguments

params

A list of call options.

Returns

A list with url, headers, and body.

---

Method do_stream()

Generate text (streaming).

Usage

OpenAILanguageModel$do_stream(params, callback)

Arguments

params

A list of call options.

callback

A function called for each chunk: callback(text, done).

Returns

A GenerateResult object.

---

Method format_tool_result()

Format a tool execution result for OpenAI's API.

Usage

OpenAILanguageModel$format_tool_result(tool_call_id, tool_name, result_content)

Arguments

tool_call_id

The ID of the tool call.

tool_name

The name of the tool (not used by OpenAI but kept for interface consistency).

result_content

The result content from executing the tool.

Returns

A list formatted as a message for OpenAI's API.

---

Method get_history_format()

Get the message format for OpenAI.

Usage

OpenAILanguageModel$get_history_format()

---

Method clone()

The objects of this class are cloneable with this method.

Usage

OpenAILanguageModel$clone(deep = FALSE)

Arguments

deep

Whether to make a deep clone.

aisdk documentation built on May 29, 2026, 9:07 a.m.