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.

ttl: Optional[Literal["30m", "12h"]]

The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

One of the following:

"30m"

"12h"

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.

ttl: Optional[Literal["30m", "12h"]]

The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

One of the following:

"30m"

"12h"

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.

ttl: Optional[Literal["30m", "12h"]]

The minimum lifetime of this cache breakpoint. Defaults to the request TTL.

One of the following:

"30m"

"12h"