Pular para o conteúdo principal
GET
Obter uma geração
Chame GET /v1/generations?id=<request_id> para buscar o registro de auditoria armazenado de uma solicitação do seu espaço de trabalho. É preciso o escopo generations:read; sem id, a chamada retorna 400 missing_id. Novas solicitações recebem um ID de geração G- criado pelo servidor, retornado no cabeçalho de resposta x-request-id e na resposta da geração. Use esse ID para registros de solicitações, consulta de gerações e suporte. Um x-request-id enviado pelo cliente não substitui o ID de geração. IDs UUID de registros antigos continuam funcionando para consultas.

Repetir uma solicitação

Toda resposta inclui replay_supported. Quando o registro de E/S armazenou o corpo da solicitação e você pode ler conteúdos armazenados, replay_supported é true e replay_request contém o corpo a ser reenviado para uma nova execução controlada:
1

Leia a geração

Chame GET /v1/generations?id=<request_id>.
2

Confirme que ela pode ser repetida

Continue somente se replay_supported for true.
3

Envie de novo

Envie replay_request ao endpoint indicado em endpoint, como /v1/chat/completions ou /v1/responses.
Um espaço de trabalho pode restringir os conteúdos armazenados a proprietários e administradores. Os demais chamadores, incluindo chaves de API criadas por membros, recebem então replay_request: null e os detalhes da solicitação sem os conteúdos.

Autorizações

Authorization
string
header
obrigatório

Autenticação com token Bearer

Parâmetros de consulta

id
string
obrigatório

ID da geração

Resposta

Dados da geração

created_at
string<date-time>
request_id
string

Identificador público de geração. Novas gerações usam o formato G-; registros históricos podem conter identificadores anteriores, incluindo UUIDs.

team_id
string
app_id
string | null
endpoint
string
model_id
string
provider
string
native_response_id
string | null
stream
boolean
byok
boolean
status_code
number
success
boolean
error_code
string | null
error_message
string | null
latency_ms
number
generation_ms
number
usage
object | null
cost_nanos
number
currency
string
pricing_lines
object[]
key_id
string
throughput
number | null
replay_supported
boolean

Indica se há um payload de solicitação pronto para replay disponível para esta geração.

replay_request
object | null

Payload de solicitação pronto para replay, capturado para esta geração quando disponível.

Última modificação em 16 de novembro de 2026