---
title: "BG | Pessoa - GPT"
method: POST
path: "/biogenerativa"
tags: ["Biografia Generativa (BG)"]
---

# BG | Pessoa - GPT

`POST /biogenerativa`

## Request

- Base URL: `https://app.bigdatacorp.com.br/bigia`
- URL: `https://app.bigdatacorp.com.br/bigia/biogenerativa`
- Auth: API key in header `AccessToken` and API key in header `TokenId`

### Descrição

A **BG | Pessoa (GPT)** é uma tecnologia do **BigIA** que utiliza um modelo de IA Generativa para transformar dados estruturados da BigDataCorp em uma **narrativa textual em linguagem natural** sobre a pessoa consultada. O resultado oferece contexto claro e auditável para apoiar análises de **crédito, risco, compliance e onboarding**.

Para mais informações sobre casos de uso, principais dúvidas e orientações de aplicação, acesse [Biografia Generativa](/docs/bigia-biografia-generativa).

**Nome técnico da tecnologia:** `genai_description_gpt_x1_5_person`.


### Tabela de preços

| Consultas realizadas no mês | Valor por consulta |
|:---------------------------:|:------------------:|
| 1 - 10000 | R$ 2,510 |
| 10001 - 50000 | R$ 2,385 |
| 50001 - 100000 | R$ 2,265 |
| 100001 - 500000 | R$ 2,152 |
| 500001 - 1000000 | R$ 2,044 |
| 1000001 - 5000000 | R$ 1,940 |
| 5000001 e acima | [Entre em contato](mailto:comercial@bigdatacorp.com.br) |

## Request body

- Request: Objeto de requisição para consulta de biografia generativa. Para mais informações sobre cada parâmetro e sua utilização, consulte a página "Primeiros Passos".
  - `q` string, required: String que define os parâmetros de entrada da consulta, utilizada para informar os identificadores e filtros aplicáveis a biografia generativa.
  - `Datasets` string, required: String contendo os nomes técnicos das biografias generativas s a serem consultadas.
  - `Limit` number: Número máximo de entidades retornadas na resposta, utilizado em consultas realizadas sem uma chave principal. Valor máximo permitido: 80

## Response `200`

Parâmetros de retorno da tecnologia.

- Result: Resultado para a tecnologia BG | Pessoa - GPT.
  - `Result` object[], required: Listas de resultados
    - `GenerativeAIData` object[], required: Objeto principal de retorno da biografia generativa, contendo a narrativa textual das informações relacionadas à entidade consultada.
      - `ServiceName` string, required: Indica o nome da tecnologia solicitada (Ex.: \"Life Biography\").
      - `ServiceVersion` string, required: Indica o versão da tecnologia solicitada (x1.5, ...).
      - `AIModelName` string, required: Nome da inteligência artificial generativa utilizada para gerar a descrição (GPT-4, Mistral, Nova).
      - `Description` string, required: Descrição gerada pela inteligência artificial generativa para os conjunto de dados de entrada especificados para a entidade consultada.
  - `QueryId` string, required: Id único identificador da chamada.
  - `ElapsedMilliseconds` number, required: A quantidade de milisegundos decorridos durante a chamada.
  - `QueryDate` string, required: A data de quando o request foi recebido e processado.
  - `Status` object, required: Lista de status para cada tecnologia.
  - `Evidences` object, required: Lista de evidências usadas para cada dataset.

---

[API](https://skmtc.dev/bigdatacorp/apis/bigia.md) - [All operations](https://skmtc.dev/bigdatacorp/apis/bigia/llms.txt) - [OpenAPI document](https://skmtc.dev/bigdatacorp/apis/bigia/revisions/537d922dfc87?raw)
