Responses

Contrato de requisição

Use uma string em input ou itens de entrada tipados com limites, instructions opcionais e max_output_tokens. Este subconjunto não mantém estado: omita storage ou defina store:false. Inclua explicitamente os itens anteriores de texto/função no próximo input.

Correlação de ferramentas

Itens function_call do assistant podem ser enviados de volta com function_call_output usando o call_id correspondente. Preserve cada chamada e seu resultado. Resultados ausentes, duplicados ou sem chamada correspondente são rejeitados.

Ciclo de vida do streaming

Os eventos incluem números de sequência ordenados e eventos nativos de resposta/saída. Uma saída bem-sucedida termina em response.completed. O esgotamento do limite de saída termina em response.incomplete com max_output_tokens; o stream não usa [DONE].

Limite de armazenamento

store:true, previous_response_id, IDs de conversa, execução em segundo plano e semântica nativa de recuperação/exclusão/cancelamento não são compatíveis. store:false desativa a recuperação pública nativa da resposta; isso não apaga os registros persistentes necessários de segurança e contabilidade.

Exemplo de requisição

Use sua chave de cliente e um modelo publicado. Copiar um exemplo não envia uma requisição.

curl https://api.notholy.com/v1/responses \
  -H "Authorization: Bearer $NOTHOLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "notholy-pulse",
  "input": "Explain least privilege.",
  "max_output_tokens": 256,
  "store": false
}'

Campos de requisição

Gerado a partir do contrato versionado. As regras de refinamento acima continuam valendo.

Schema da resposta