Messages
Create a Message
Count tokens in a Message
ModelsExpand Collapse
class Base64ImageSource:
required MediaType MediaType
class Base64PdfSource:
class BashCodeExecutionOutputBlock:
class BashCodeExecutionOutputBlockParam:
class BashCodeExecutionResultBlock:
required IReadOnlyList<BashCodeExecutionOutputBlock> Content
class BashCodeExecutionResultBlockParam:
required IReadOnlyList<BashCodeExecutionOutputBlockParam> Content
class BashCodeExecutionToolResultBlock:
required Content Content
class BashCodeExecutionToolResultError:
required BashCodeExecutionToolResultErrorCode ErrorCode
class BashCodeExecutionResultBlock:
required IReadOnlyList<BashCodeExecutionOutputBlock> Content
class BashCodeExecutionToolResultBlockParam:
required Content Content
class BashCodeExecutionToolResultErrorParam:
required BashCodeExecutionToolResultErrorCode ErrorCode
class BashCodeExecutionResultBlockParam:
required IReadOnlyList<BashCodeExecutionOutputBlockParam> Content
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
class BashCodeExecutionToolResultError:
required BashCodeExecutionToolResultErrorCode ErrorCode
enum BashCodeExecutionToolResultErrorCode:
class BashCodeExecutionToolResultErrorParam:
required BashCodeExecutionToolResultErrorCode ErrorCode
class CacheControlEphemeral:
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
class CacheCreation:
The number of input tokens used to create the 1 hour cache entry.
The number of input tokens used to create the 5 minute cache entry.
class CitationCharLocation:
class CitationCharLocationParam:
class CitationContentBlockLocation:
class CitationContentBlockLocationParam:
class CitationPageLocation:
class CitationPageLocationParam:
class CitationSearchResultLocationParam:
class CitationWebSearchResultLocationParam:
class CitationsConfig:
class CitationsConfigParam:
class CitationsDelta:
required Citation Citation
class CitationCharLocation:
class CitationPageLocation:
class CitationContentBlockLocation:
class CitationsWebSearchResultLocation:
class CitationsSearchResultLocation:
class CitationsSearchResultLocation:
class CitationsWebSearchResultLocation:
class CodeExecutionOutputBlock:
class CodeExecutionOutputBlockParam:
class CodeExecutionResultBlock:
required IReadOnlyList<CodeExecutionOutputBlock> Content
class CodeExecutionResultBlockParam:
required IReadOnlyList<CodeExecutionOutputBlockParam> Content
class CodeExecutionTool20250522:
JsonElement Name "code_execution"constantName of the tool.
Name of the tool.
This is how the tool will be called by the model and in tool_use blocks.
IReadOnlyList<AllowedCaller> AllowedCallers
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
When true, guarantees schema validation on tool names and inputs
class CodeExecutionTool20250825:
JsonElement Name "code_execution"constantName of the tool.
Name of the tool.
This is how the tool will be called by the model and in tool_use blocks.
IReadOnlyList<AllowedCaller> AllowedCallers
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
When true, guarantees schema validation on tool names and inputs
class CodeExecutionTool20260120:Code execution tool with REPL state persistence (daemon mode + gVisor checkpoint).
Code execution tool with REPL state persistence (daemon mode + gVisor checkpoint).
JsonElement Name "code_execution"constantName of the tool.
Name of the tool.
This is how the tool will be called by the model and in tool_use blocks.
IReadOnlyList<AllowedCaller> AllowedCallers
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
If true, tool will not be included in initial system prompt. Only loaded when returned via tool_reference from tool search.
When true, guarantees schema validation on tool names and inputs
class CodeExecutionToolResultBlock:
required CodeExecutionToolResultBlockContent ContentCode execution result with encrypted stdout for PFC + web_search results.
Code execution result with encrypted stdout for PFC + web_search results.
class CodeExecutionToolResultError:
required CodeExecutionToolResultErrorCode ErrorCode
class CodeExecutionResultBlock:
required IReadOnlyList<CodeExecutionOutputBlock> Content
class EncryptedCodeExecutionResultBlock:Code execution result with encrypted stdout for PFC + web_search results.
Code execution result with encrypted stdout for PFC + web_search results.
required IReadOnlyList<CodeExecutionOutputBlock> Content
class CodeExecutionToolResultBlockContent: A class that can be one of several variants.union Code execution result with encrypted stdout for PFC + web_search results.
Code execution result with encrypted stdout for PFC + web_search results.
class CodeExecutionToolResultError:
required CodeExecutionToolResultErrorCode ErrorCode
class CodeExecutionResultBlock:
required IReadOnlyList<CodeExecutionOutputBlock> Content
class EncryptedCodeExecutionResultBlock:Code execution result with encrypted stdout for PFC + web_search results.
Code execution result with encrypted stdout for PFC + web_search results.
required IReadOnlyList<CodeExecutionOutputBlock> Content
class CodeExecutionToolResultBlockParam:
required CodeExecutionToolResultBlockParamContent ContentCode execution result with encrypted stdout for PFC + web_search results.
Code execution result with encrypted stdout for PFC + web_search results.
class CodeExecutionToolResultErrorParam:
required CodeExecutionToolResultErrorCode ErrorCode
class CodeExecutionResultBlockParam:
required IReadOnlyList<CodeExecutionOutputBlockParam> Content
class EncryptedCodeExecutionResultBlockParam:Code execution result with encrypted stdout for PFC + web_search results.
Code execution result with encrypted stdout for PFC + web_search results.
required IReadOnlyList<CodeExecutionOutputBlockParam> Content
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
class CodeExecutionToolResultBlockParamContent: A class that can be one of several variants.union Code execution result with encrypted stdout for PFC + web_search results.
Code execution result with encrypted stdout for PFC + web_search results.
class CodeExecutionToolResultErrorParam:
required CodeExecutionToolResultErrorCode ErrorCode
class CodeExecutionResultBlockParam:
required IReadOnlyList<CodeExecutionOutputBlockParam> Content
class EncryptedCodeExecutionResultBlockParam:Code execution result with encrypted stdout for PFC + web_search results.
Code execution result with encrypted stdout for PFC + web_search results.
required IReadOnlyList<CodeExecutionOutputBlockParam> Content
class CodeExecutionToolResultError:
required CodeExecutionToolResultErrorCode ErrorCode
enum CodeExecutionToolResultErrorCode:
class CodeExecutionToolResultErrorParam:
required CodeExecutionToolResultErrorCode ErrorCode
class Container:Information about the container used in the request (for the code execution tool)
Information about the container used in the request (for the code execution tool)
Identifier for the container used in this request
The time at which the container will expire.
class ContainerUploadBlock:Response model for a file uploaded to the container.
Response model for a file uploaded to the container.
class ContainerUploadBlockParam:A content block that represents a file to be uploaded to the container
Files uploaded via this block will be available in the container's input directory.
A content block that represents a file to be uploaded to the container Files uploaded via this block will be available in the container's input directory.
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
class ContentBlock: A class that can be one of several variants.union Response model for a file uploaded to the container.
Response model for a file uploaded to the container.
class TextBlock:
required IReadOnlyList<TextCitation>? CitationsCitations supporting the text block.
Citations supporting the text block.
The type of citation returned will depend on the type of document being cited. Citing a PDF results in page_location, plain text results in char_location, and content document results in content_block_location.
class CitationCharLocation:
class CitationPageLocation:
class CitationContentBlockLocation:
class CitationsWebSearchResultLocation:
class CitationsSearchResultLocation:
class ThinkingBlock:
class RedactedThinkingBlock:
class ToolUseBlock:
required Caller CallerTool invocation directly from the model.
Tool invocation directly from the model.
class DirectCaller:Tool invocation directly from the model.
Tool invocation directly from the model.
class ServerToolCaller:Tool invocation generated by a server-side tool.
Tool invocation generated by a server-side tool.
class ServerToolCaller20260120:
class ServerToolUseBlock:
required Caller CallerTool invocation directly from the model.
Tool invocation directly from the model.
class DirectCaller:Tool invocation directly from the model.
Tool invocation directly from the model.
class ServerToolCaller:Tool invocation generated by a server-side tool.
Tool invocation generated by a server-side tool.
class ServerToolCaller20260120:
required Name Name
class WebSearchToolResultBlock:
required Caller CallerTool invocation directly from the model.
Tool invocation directly from the model.
class DirectCaller:Tool invocation directly from the model.
Tool invocation directly from the model.
class ServerToolCaller:Tool invocation generated by a server-side tool.
Tool invocation generated by a server-side tool.
class ServerToolCaller20260120:
required WebSearchToolResultBlockContent Content
class WebSearchToolResultError:
required WebSearchToolResultErrorCode ErrorCode
IReadOnlyList<WebSearchResultBlock>
class WebFetchToolResultBlock:
required Caller CallerTool invocation directly from the model.
Tool invocation directly from the model.
class DirectCaller:Tool invocation directly from the model.
Tool invocation directly from the model.
class ServerToolCaller:Tool invocation generated by a server-side tool.
Tool invocation generated by a server-side tool.
class ServerToolCaller20260120:
required Content Content
class WebFetchToolResultErrorBlock:
required WebFetchToolResultErrorCode ErrorCode
class WebFetchBlock:
required DocumentBlock Content
required CitationsConfig? CitationsCitation configuration for the document
Citation configuration for the document
required Source Source
class Base64PdfSource:
class PlainTextSource:
The title of the document
ISO 8601 timestamp when the content was retrieved
Fetched content URL
class CodeExecutionToolResultBlock:
required CodeExecutionToolResultBlockContent ContentCode execution result with encrypted stdout for PFC + web_search results.
Code execution result with encrypted stdout for PFC + web_search results.
class CodeExecutionToolResultError:
required CodeExecutionToolResultErrorCode ErrorCode
class CodeExecutionResultBlock:
required IReadOnlyList<CodeExecutionOutputBlock> Content
class EncryptedCodeExecutionResultBlock:Code execution result with encrypted stdout for PFC + web_search results.
Code execution result with encrypted stdout for PFC + web_search results.
required IReadOnlyList<CodeExecutionOutputBlock> Content
class BashCodeExecutionToolResultBlock:
required Content Content
class BashCodeExecutionToolResultError:
required BashCodeExecutionToolResultErrorCode ErrorCode
class BashCodeExecutionResultBlock:
required IReadOnlyList<BashCodeExecutionOutputBlock> Content
class TextEditorCodeExecutionToolResultBlock:
required Content Content
class TextEditorCodeExecutionToolResultError:
required TextEditorCodeExecutionToolResultErrorCode ErrorCode
class TextEditorCodeExecutionViewResultBlock:
required FileType FileType
class TextEditorCodeExecutionCreateResultBlock:
class TextEditorCodeExecutionStrReplaceResultBlock:
class ToolSearchToolResultBlock:
required Content Content
class ToolSearchToolResultError:
required ToolSearchToolResultErrorCode ErrorCode
class ToolSearchToolSearchResultBlock:
required IReadOnlyList<ToolReferenceBlock> ToolReferences
class ContainerUploadBlock:Response model for a file uploaded to the container.
Response model for a file uploaded to the container.
class ContentBlockParam: A class that can be one of several variants.union Regular text content.
Regular text content.
class TextBlockParam:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
IReadOnlyList<TextCitationParam>? Citations
class CitationCharLocationParam:
class CitationPageLocationParam:
class CitationContentBlockLocationParam:
class CitationWebSearchResultLocationParam:
class CitationSearchResultLocationParam:
class ImageBlockParam:
required Source Source
class Base64ImageSource:
required MediaType MediaType
class UrlImageSource:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
class DocumentBlockParam:
required Source Source
class Base64PdfSource:
class PlainTextSource:
class ContentBlockSource:
required Content Content
IReadOnlyList<ContentBlockSourceContent>
class TextBlockParam:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
IReadOnlyList<TextCitationParam>? Citations
class CitationCharLocationParam:
class CitationPageLocationParam:
class CitationContentBlockLocationParam:
class CitationWebSearchResultLocationParam:
class CitationSearchResultLocationParam:
class ImageBlockParam:
required Source Source
class Base64ImageSource:
required MediaType MediaType
class UrlImageSource:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
class UrlPdfSource:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
CitationsConfigParam? Citations
class SearchResultBlockParam:
required IReadOnlyList<TextBlockParam> Content
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
IReadOnlyList<TextCitationParam>? Citations
class CitationCharLocationParam:
class CitationPageLocationParam:
class CitationContentBlockLocationParam:
class CitationWebSearchResultLocationParam:
class CitationSearchResultLocationParam:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
CitationsConfigParam Citations
class ThinkingBlockParam:
class RedactedThinkingBlockParam:
class ToolUseBlockParam:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
Caller CallerTool invocation directly from the model.
Tool invocation directly from the model.
class DirectCaller:Tool invocation directly from the model.
Tool invocation directly from the model.
class ServerToolCaller:Tool invocation generated by a server-side tool.
Tool invocation generated by a server-side tool.
class ServerToolCaller20260120:
class ToolResultBlockParam:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
Content Content
IReadOnlyList<Block>
class TextBlockParam:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
IReadOnlyList<TextCitationParam>? Citations
class CitationCharLocationParam:
class CitationPageLocationParam:
class CitationContentBlockLocationParam:
class CitationWebSearchResultLocationParam:
class CitationSearchResultLocationParam:
class ImageBlockParam:
required Source Source
class Base64ImageSource:
required MediaType MediaType
class UrlImageSource:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
class SearchResultBlockParam:
required IReadOnlyList<TextBlockParam> Content
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
IReadOnlyList<TextCitationParam>? Citations
class CitationCharLocationParam:
class CitationPageLocationParam:
class CitationContentBlockLocationParam:
class CitationWebSearchResultLocationParam:
class CitationSearchResultLocationParam:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
CitationsConfigParam Citations
class DocumentBlockParam:
required Source Source
class Base64PdfSource:
class PlainTextSource:
class ContentBlockSource:
required Content Content
IReadOnlyList<ContentBlockSourceContent>
class TextBlockParam:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
IReadOnlyList<TextCitationParam>? Citations
class CitationCharLocationParam:
class CitationPageLocationParam:
class CitationContentBlockLocationParam:
class CitationWebSearchResultLocationParam:
class CitationSearchResultLocationParam:
class ImageBlockParam:
required Source Source
class Base64ImageSource:
required MediaType MediaType
class UrlImageSource:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
class UrlPdfSource:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
CitationsConfigParam? Citations
class ToolReferenceBlockParam:Tool reference block that can be included in tool_result content.
Tool reference block that can be included in tool_result content.
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
class ServerToolUseBlockParam:
required Name Name
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
Caller CallerTool invocation directly from the model.
Tool invocation directly from the model.
class DirectCaller:Tool invocation directly from the model.
Tool invocation directly from the model.
class ServerToolCaller:Tool invocation generated by a server-side tool.
Tool invocation generated by a server-side tool.
class ServerToolCaller20260120:
class WebSearchToolResultBlockParam:
required WebSearchToolResultBlockParamContent Content
IReadOnlyList<WebSearchResultBlockParam>
class WebSearchToolRequestError:
required WebSearchToolResultErrorCode ErrorCode
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
Caller CallerTool invocation directly from the model.
Tool invocation directly from the model.
class DirectCaller:Tool invocation directly from the model.
Tool invocation directly from the model.
class ServerToolCaller:Tool invocation generated by a server-side tool.
Tool invocation generated by a server-side tool.
class ServerToolCaller20260120:
class WebFetchToolResultBlockParam:
required Content Content
class WebFetchToolResultErrorBlockParam:
required WebFetchToolResultErrorCode ErrorCode
class WebFetchBlockParam:
required DocumentBlockParam Content
required Source Source
class Base64PdfSource:
class PlainTextSource:
class ContentBlockSource:
required Content Content
IReadOnlyList<ContentBlockSourceContent>
class TextBlockParam:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
IReadOnlyList<TextCitationParam>? Citations
class CitationCharLocationParam:
class CitationPageLocationParam:
class CitationContentBlockLocationParam:
class CitationWebSearchResultLocationParam:
class CitationSearchResultLocationParam:
class ImageBlockParam:
required Source Source
class Base64ImageSource:
required MediaType MediaType
class UrlImageSource:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
class UrlPdfSource:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
CitationsConfigParam? Citations
Fetched content URL
ISO 8601 timestamp when the content was retrieved
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
Caller CallerTool invocation directly from the model.
Tool invocation directly from the model.
class DirectCaller:Tool invocation directly from the model.
Tool invocation directly from the model.
class ServerToolCaller:Tool invocation generated by a server-side tool.
Tool invocation generated by a server-side tool.
class ServerToolCaller20260120:
class CodeExecutionToolResultBlockParam:
required CodeExecutionToolResultBlockParamContent ContentCode execution result with encrypted stdout for PFC + web_search results.
Code execution result with encrypted stdout for PFC + web_search results.
class CodeExecutionToolResultErrorParam:
required CodeExecutionToolResultErrorCode ErrorCode
class CodeExecutionResultBlockParam:
required IReadOnlyList<CodeExecutionOutputBlockParam> Content
class EncryptedCodeExecutionResultBlockParam:Code execution result with encrypted stdout for PFC + web_search results.
Code execution result with encrypted stdout for PFC + web_search results.
required IReadOnlyList<CodeExecutionOutputBlockParam> Content
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
class BashCodeExecutionToolResultBlockParam:
required Content Content
class BashCodeExecutionToolResultErrorParam:
required BashCodeExecutionToolResultErrorCode ErrorCode
class BashCodeExecutionResultBlockParam:
required IReadOnlyList<BashCodeExecutionOutputBlockParam> Content
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
class TextEditorCodeExecutionToolResultBlockParam:
required Content Content
class TextEditorCodeExecutionToolResultErrorParam:
required TextEditorCodeExecutionToolResultErrorCode ErrorCode
class TextEditorCodeExecutionViewResultBlockParam:
required FileType FileType
class TextEditorCodeExecutionCreateResultBlockParam:
class TextEditorCodeExecutionStrReplaceResultBlockParam:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
class ToolSearchToolResultBlockParam:
required Content Content
class ToolSearchToolResultErrorParam:
required ToolSearchToolResultErrorCode ErrorCode
class ToolSearchToolSearchResultBlockParam:
required IReadOnlyList<ToolReferenceBlockParam> ToolReferences
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
class ContainerUploadBlockParam:A content block that represents a file to be uploaded to the container
Files uploaded via this block will be available in the container's input directory.
A content block that represents a file to be uploaded to the container Files uploaded via this block will be available in the container's input directory.
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
class ContentBlockSource:
required Content Content
IReadOnlyList<ContentBlockSourceContent>
class TextBlockParam:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
IReadOnlyList<TextCitationParam>? Citations
class CitationCharLocationParam:
class CitationPageLocationParam:
class CitationContentBlockLocationParam:
class CitationWebSearchResultLocationParam:
class CitationSearchResultLocationParam:
class ImageBlockParam:
required Source Source
class Base64ImageSource:
required MediaType MediaType
class UrlImageSource:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
class ContentBlockSourceContent: A class that can be one of several variants.union
class TextBlockParam:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
IReadOnlyList<TextCitationParam>? Citations
class CitationCharLocationParam:
class CitationPageLocationParam:
class CitationContentBlockLocationParam:
class CitationWebSearchResultLocationParam:
class CitationSearchResultLocationParam:
class ImageBlockParam:
required Source Source
class Base64ImageSource:
required MediaType MediaType
class UrlImageSource:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
class DirectCaller:Tool invocation directly from the model.
Tool invocation directly from the model.
class DocumentBlock:
required CitationsConfig? CitationsCitation configuration for the document
Citation configuration for the document
required Source Source
class Base64PdfSource:
class PlainTextSource:
The title of the document
class DocumentBlockParam:
required Source Source
class Base64PdfSource:
class PlainTextSource:
class ContentBlockSource:
required Content Content
IReadOnlyList<ContentBlockSourceContent>
class TextBlockParam:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.
IReadOnlyList<TextCitationParam>? Citations
class CitationCharLocationParam:
class CitationPageLocationParam:
class CitationContentBlockLocationParam:
class CitationWebSearchResultLocationParam:
class CitationSearchResultLocationParam:
class ImageBlockParam:
required Source Source
class Base64ImageSource:
required MediaType MediaType
class UrlImageSource:
CacheControlEphemeral? CacheControlCreate a cache control breakpoint at this content block.
Create a cache control breakpoint at this content block.
Ttl TtlThe time-to-live for the cache control breakpoint.
The time-to-live for the cache control breakpoint.
This may be one the following values:
5m: 5 minutes1h: 1 hour
Defaults to 5m.