One of the following:
str

A text input, equivalent to a message with the user role.

List[ResponseSteerInputItemList]

A non-empty list of message inputs to queue for the response.

One of the following:
class ResponseSteerInputItemListMessage: …
content: Union[List[BetaResponseSteerInputContent], str]

The message content, as an array of content parts.

One of the following:
List[BetaResponseSteerInputContent]
One of the following:
class BetaResponseInputTextContent: …

A text input to the model.

text: str

The text input to the model.

maxLength10485760
type: Literal["input_text"]

The type of the input item. Always input_text.

prompt_cache_breakpoint: Optional[PromptCacheBreakpoint]

Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the request’s prompt_cache_options.ttl; the boundary is not rounded to a token block.

mode: Literal["explicit"]

The breakpoint mode. Always explicit.

class BetaResponseInputImageContent: …

An image input to the model. Learn about image inputs

type: Literal["input_image"]

The type of the input item. Always input_image.

detail: Optional[BetaImageDetail]

The detail level of the image to be sent to the model. One of high, low, auto, or original. Defaults to auto.

file_id: Optional[str]

The ID of the file to be sent to the model.

image_url: Optional[str]

The URL of the image to be sent to the model. A fully qualified URL or base64 encoded image in a data URL.

maxLength20971520
formaturi
prompt_cache_breakpoint: Optional[PromptCacheBreakpoint]

Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the request’s prompt_cache_options.ttl; the boundary is not rounded to a token block.

mode: Literal["explicit"]

The breakpoint mode. Always explicit.

class BetaResponseInputFileContent: …

A file input to the model.

type: Literal["input_file"]

The type of the input item. Always input_file.

detail: Optional[Literal["auto", "low", "high"]]

The detail level of the file to be sent to the model. Use auto to let the system select the detail level; for GPT-5.6 and later models, auto uses high-quality rendering, which may increase input token usage. Use low for lower-cost rendering, or high to render the file at higher quality. Defaults to auto.

One of the following:
"auto"
"low"
"high"
file_data: Optional[str]

The base64-encoded data of the file to be sent to the model.

maxLength73400320
file_id: Optional[str]

The ID of the file to be sent to the model.

file_url: Optional[str]

The URL of the file to be sent to the model.

formaturi
filename: Optional[str]

The name of the file to be sent to the model.

prompt_cache_breakpoint: Optional[PromptCacheBreakpoint]

Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the request’s prompt_cache_options.ttl; the boundary is not rounded to a token block.

mode: Literal["explicit"]

The breakpoint mode. Always explicit.

str

The message content, as a single string.

role: Literal["user"]

The message role. Always user.

type: Literal["message"]

The item type. Always message.

id: Optional[str]

The unique ID of this message item.

agent: Optional[ResponseSteerInputItemListMessageAgent]

The agent that produced this item.

agent_name: str

The canonical name of the agent that produced this item.

status: Optional[str]

The status of the message item.

class ResponseSteerInputItemListFunctionCallOutput: …

The output of a function tool call.

output: Union[str, BetaResponseFunctionCallOutputItemList]

Text, image, or file output of the function tool call.

One of the following:
str

A JSON string of the output of the function tool call.

One of the following:
class BetaResponseInputTextContent: …

A text input to the model.

text: str

The text input to the model.

maxLength10485760
type: Literal["input_text"]

The type of the input item. Always input_text.

prompt_cache_breakpoint: Optional[PromptCacheBreakpoint]

Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the request’s prompt_cache_options.ttl; the boundary is not rounded to a token block.

mode: Literal["explicit"]

The breakpoint mode. Always explicit.

class BetaResponseInputImageContent: …

An image input to the model. Learn about image inputs

type: Literal["input_image"]

The type of the input item. Always input_image.

detail: Optional[BetaImageDetail]

The detail level of the image to be sent to the model. One of high, low, auto, or original. Defaults to auto.

file_id: Optional[str]

The ID of the file to be sent to the model.

image_url: Optional[str]

The URL of the image to be sent to the model. A fully qualified URL or base64 encoded image in a data URL.

maxLength20971520
formaturi
prompt_cache_breakpoint: Optional[PromptCacheBreakpoint]

Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the request’s prompt_cache_options.ttl; the boundary is not rounded to a token block.

mode: Literal["explicit"]

The breakpoint mode. Always explicit.

class BetaResponseInputFileContent: …

A file input to the model.

type: Literal["input_file"]

The type of the input item. Always input_file.

detail: Optional[Literal["auto", "low", "high"]]

The detail level of the file to be sent to the model. Use auto to let the system select the detail level; for GPT-5.6 and later models, auto uses high-quality rendering, which may increase input token usage. Use low for lower-cost rendering, or high to render the file at higher quality. Defaults to auto.

One of the following:
"auto"
"low"
"high"
file_data: Optional[str]

The base64-encoded data of the file to be sent to the model.

maxLength73400320
file_id: Optional[str]

The ID of the file to be sent to the model.

file_url: Optional[str]

The URL of the file to be sent to the model.

formaturi
filename: Optional[str]

The name of the file to be sent to the model.

prompt_cache_breakpoint: Optional[PromptCacheBreakpoint]

Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the request’s prompt_cache_options.ttl; the boundary is not rounded to a token block.

mode: Literal["explicit"]

The breakpoint mode. Always explicit.

type: Literal["function_call_output"]

The type of the function tool call output. Always function_call_output.

id: Optional[str]

The unique ID of the function tool call output. Populated when this item is returned via API.

agent: Optional[ResponseSteerInputItemListFunctionCallOutputAgent]

The agent that produced this item.

agent_name: str

The canonical name of the agent that produced this item.

call_id: Optional[str]

The unique ID of the function tool call generated by the model.

minLength1
maxLength64
caller: Optional[ResponseSteerInputItemListFunctionCallOutputCaller]

The execution context that produced this tool call.

One of the following:
class ResponseSteerInputItemListFunctionCallOutputCallerDirect: …
type: Literal["direct"]

The caller type. Always direct.

class ResponseSteerInputItemListFunctionCallOutputCallerProgram: …
caller_id: str

The call ID of the program item that produced this tool call.

minLength1
maxLength64
type: Literal["program"]

The caller type. Always program.

name: Optional[str]

The name of the tool that produced the output.

minLength1
maxLength128
namespace: Optional[str]

The namespace of the tool that produced the output.

minLength1
maxLength64
status: Optional[Literal["in_progress", "completed", "incomplete"]]

The status of the item. One of in_progress, completed, or incomplete. Populated when items are returned via API.

One of the following:
"in_progress"
"completed"
"incomplete"