OpenAI Responses

Overview

OpenAI Responses API is the newer, recommended API for reasoning models (o-series) and advanced features like code execution. It provides better support for multi-turn conversations and built-in tools. Model Class: OpenAIResponsesModel

Authentication

export OPENAI_API_KEY="sk-..."

Examples

from upsonic import Agent, Task
from upsonic.models.openai import OpenAIResponsesModel

model = OpenAIResponsesModel(model_name="gpt-4o-mini")
agent = Agent(model=model)

task = Task("Hello, how are you?")
result = agent.do(task)
print(result)

Model Settings

You can set model parameters in two ways: on the model or on the Agent. On the model:

from upsonic import Agent, Task
from upsonic.models.openai import OpenAIResponsesModel, OpenAIResponsesModelSettings

model = OpenAIResponsesModel(
    model_name="gpt-4o-mini",
    settings=OpenAIResponsesModelSettings(max_tokens=1024, openai_reasoning_summary="concise")
)
agent = Agent(model=model)

On the Agent:

from upsonic import Agent, Task
from upsonic.models.openai import OpenAIResponsesModelSettings

agent = Agent(
    model="openai/gpt-4o-mini",
    settings=OpenAIResponsesModelSettings(max_tokens=1024)
)

Parameters

Parameter	Type	Description	Default	Source
`max_tokens`	`int`	Maximum tokens to generate	Model-specific	Base
`seed`	`int`	Random seed for deterministic outputs	None	Base
`stop_sequences`	`list[str]`	Sequences that stop generation	None	Base
`timeout`	`float`	Request timeout in seconds	600	Base
`extra_headers`	`dict[str, str]`	Additional HTTP headers	None	Base
`extra_body`	`object`	Additional request body params	None	Base
`openai_reasoning_effort`	`'low' \| 'medium' \| 'high'`	Computational effort for reasoning	None	Specific
`openai_reasoning_summary`	`'detailed' \| 'concise'`	Reasoning summary detail level	None	Specific
`openai_send_reasoning_ids`	`bool`	Send reasoning part IDs in history	False	Specific
`openai_truncation`	`'disabled' \| 'auto'`	Context window truncation strategy	’auto’	Specific
`openai_text_verbosity`	`'low' \| 'medium' \| 'high'`	Text response verbosity	None	Specific
`openai_previous_response_id`	`'auto' \| str`	Continue from previous response	None	Specific
`openai_include_code_execution_outputs`	`bool`	Include code interpreter outputs	False	Specific
`openai_include_web_search_sources`	`bool`	Include web search sources	False	Specific
`openai_builtin_tools`	`Sequence[...]`	Built-in tools to enable	None	Specific

GET STARTED

CONCEPTS

STARTING AN AGENT PROJECT

READY TO USE SNIPPETS

DEPLOYMENT

FURTHER READINGS

Overview

Authentication

Examples

Model Settings

Parameters

​Overview

​Authentication

​Examples

​Model Settings

​Parameters

Overview

Authentication

Examples

Model Settings

Parameters