--- title: "POST /v1/{+parent}:corroborateContent" method: POST path: "/v1/{+parent}:corroborateContent" tags: ["projects"] --- # POST /v1/{+parent}:corroborateContent `POST /v1/{+parent}:corroborateContent` Given an input text, it returns a score that evaluates the factuality of the text. It also extracts and returns claims from the text and provides supporting facts. ## Path parameters - `parent` string, required ## Request body - GoogleCloudAiplatformV1CorroborateContentRequest — Request message for CorroborateContent. - `content` GoogleCloudAiplatformV1Content — The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. - `parts` GoogleCloudAiplatformV1Part[] — Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - `fileData` GoogleCloudAiplatformV1FileData — URI-based data. A FileData message contains a URI pointing to data of a specific media type. It is used to represent images, audio, and video stored in Google Cloud Storage. - `mimeType` string — Required. The IANA standard MIME type of the source data. - `fileUri` string — Required. The URI of the file in Google Cloud Storage. - `displayName` string — Optional. The display name of the file. Used to provide a label or filename to distinguish files. This field is only returned in `PromptMessage` for prompt management. It is used in the Gemini calls only when server side tools (`code_execution`, `google_search`, and `url_context`) are enabled. - `executableCode` GoogleCloudAiplatformV1ExecutableCode — Code generated by the model that is meant to be executed, and the result returned to the model. Generated when using the `CodeExecution` tool, in which the code will be automatically executed, and a corresponding CodeExecutionResult will also be generated. - `language` 'LANGUAGE_UNSPECIFIED' | 'PYTHON' — Required. Programming language of the `code`. - `code` string — Required. The code to be executed. - `codeExecutionResult` GoogleCloudAiplatformV1CodeExecutionResult — Result of executing the ExecutableCode. Generated only when the `CodeExecution` tool is used. - `outcome` 'OUTCOME_UNSPECIFIED' | 'OUTCOME_OK' | 'OUTCOME_FAILED' | 'OUTCOME_DEADLINE_EXCEEDED' — Required. Outcome of the code execution. - `output` string — Optional. Contains stdout when code execution is successful, stderr or other description otherwise. - `functionResponse` GoogleCloudAiplatformV1FunctionResponse — The result output from a FunctionCall that contains a string representing the FunctionDeclaration.name and a structured JSON object containing any output from the function is used as context to the model. This should contain the result of a `FunctionCall` made based on model prediction. - `name` string — Required. The name of the function to call. Matches FunctionDeclaration.name and FunctionCall.name. - `response` object — Required. The function response in JSON object format. Use "output" key to specify function output and "error" key to specify error details (if any). If "output" and "error" keys are not specified, then whole "response" is treated as function output. - `parts` GoogleCloudAiplatformV1FunctionResponsePart[] — Optional. Ordered `Parts` that constitute a function response. Parts may have different IANA MIME types. - `inlineData` GoogleCloudAiplatformV1FunctionResponseBlob — Raw media bytes for function response. Text should not be sent as raw bytes, use the 'text' field. - `mimeType` string — Required. The IANA standard MIME type of the source data. - `displayName` string — Optional. Display name of the blob. Used to provide a label or filename to distinguish blobs. This field is only returned in PromptMessage for prompt management. It is currently used in the Gemini GenerateContent calls only when server side tools (code_execution, google_search, and url_context) are enabled. - `data` string, byte — Required. Raw bytes. - `fileData` GoogleCloudAiplatformV1FunctionResponseFileData — URI based data for function response. - `mimeType` string — Required. The IANA standard MIME type of the source data. - `fileUri` string — Required. URI. - `displayName` string — Optional. Display name of the file data. Used to provide a label or filename to distinguish file datas. This field is only returned in PromptMessage for prompt management. It is currently used in the Gemini GenerateContent calls only when server side tools (code_execution, google_search, and url_context) are enabled. - `scheduling` 'SCHEDULING_UNSPECIFIED' | 'SILENT' | 'WHEN_IDLE' | 'INTERRUPT' — Optional. Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE. - `mediaResolution` GoogleCloudAiplatformV1PartMediaResolution — per part media resolution. Media resolution for the input media. - `level` 'MEDIA_RESOLUTION_UNSPECIFIED' | 'MEDIA_RESOLUTION_LOW' | 'MEDIA_RESOLUTION_MEDIUM' | 'MEDIA_RESOLUTION_HIGH' | 'MEDIA_RESOLUTION_ULTRA_HIGH' — The tokenization quality used for given media. - `thought` boolean — Optional. Indicates whether the `part` represents the model's thought process or reasoning. - `text` string — Optional. The text content of the part. When sent from the VSCode Gemini Code Assist extension, references to @mentioned items will be converted to markdown boldface text. For example `@my-repo` will be converted to and sent as `**my-repo**` by the IDE agent. - `functionCall` GoogleCloudAiplatformV1FunctionCall — A predicted FunctionCall returned from the model that contains a string representing the FunctionDeclaration.name and a structured JSON object containing the parameters and their values. - `name` string — Optional. The name of the function to call. Matches FunctionDeclaration.name. - `willContinue` boolean — Optional. Whether this is the last part of the FunctionCall. If true, another partial message for the current FunctionCall is expected to follow. - `args` object — Optional. The function parameters and values in JSON object format. See FunctionDeclaration.parameters for parameter details. - `partialArgs` GoogleCloudAiplatformV1PartialArg[] — Optional. The partial argument value of the function call. If provided, represents the arguments/fields that are streamed incrementally. - `stringValue` string — Optional. Represents a string value. - `numberValue` number, double — Optional. Represents a double value. - `willContinue` boolean — Optional. Whether this is not the last part of the same json_path. If true, another PartialArg message for the current json_path is expected to follow. - `jsonPath` string — Required. A JSON Path (RFC 9535) to the argument being streamed. https://datatracker.ietf.org/doc/html/rfc9535. e.g. "$.foo.bar[0].data". - `boolValue` boolean — Optional. Represents a boolean value. - `nullValue` 'NULL_VALUE' — Optional. Represents a null value. - `thoughtSignature` string, byte — Optional. An opaque signature for the thought so it can be reused in subsequent requests. - `inlineData` GoogleCloudAiplatformV1Blob — A content blob. A Blob contains data of a specific media type. It is used to represent images, audio, and video. - `data` string, byte — Required. The raw bytes of the data. - `mimeType` string — Required. The IANA standard MIME type of the source data. - `displayName` string — Optional. The display name of the blob. Used to provide a label or filename to distinguish blobs. This field is only returned in `PromptMessage` for prompt management. It is used in the Gemini calls only when server-side tools (`code_execution`, `google_search`, and `url_context`) are enabled. - `videoMetadata` GoogleCloudAiplatformV1VideoMetadata — Provides metadata for a video, including the start and end offsets for clipping and the frame rate. - `fps` number, double — Optional. The frame rate of the video sent to the model. If not specified, the default value is 1.0. The valid range is (0.0, 24.0]. - `startOffset` string, google-duration — Optional. The start offset of the video. - `endOffset` string, google-duration — Optional. The end offset of the video. - `role` string — Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. - `facts` GoogleCloudAiplatformV1Fact[] — Optional. Facts used to generate the text can also be used to corroborate the text. - `query` string — Query that is used to retrieve this fact. - `uri` string — If present, this uri links to the source of the fact. - `score` number, double — If present, according to the underlying Vector DB and the selected metric type, the score can be either the distance or the similarity between the query and the fact and its range depends on the metric type. For example, if the metric type is COSINE_DISTANCE, it represents the distance between the query and the fact. The larger the distance, the less relevant the fact is to the query. The range is [0, 2], while 0 means the most relevant and 2 means the least relevant. - `title` string — If present, it refers to the title of this fact. - `summary` string — If present, the summary/snippet of the fact. - `chunk` GoogleCloudAiplatformV1RagChunk — A RagChunk includes the content of a chunk of a RagFile, and associated metadata. - `text` string — The content of the chunk. - `pageSpan` GoogleCloudAiplatformV1RagChunkPageSpan — Represents where the chunk starts and ends in the document. - `firstPage` integer — Page where chunk starts in the document. Inclusive. 1-indexed. - `lastPage` integer — Page where chunk ends in the document. Inclusive. 1-indexed. - `vectorDistance` number, double — If present, the distance between the query vector and this fact vector. - `parameters` GoogleCloudAiplatformV1CorroborateContentRequestParameters — Parameters that can be overrided per request. - `citationThreshold` number, double — Optional. Only return claims with citation score larger than the threshold. ## Response `200` Successful response --- [API](https://skmtc.net/google/apis/aiplatform.md) · [All operations](https://skmtc.net/google/apis/aiplatform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/aiplatform/versions/b608d71b91f0/schema)