Responses

Contrato de solicitud

Usa una cadena en input o elementos de entrada tipados con límites, instructions opcionales y max_output_tokens. Este subconjunto no mantiene estado: omite storage o define store:false. Incluye de forma explícita los elementos anteriores de texto/función en el siguiente input.

Correlación de herramientas

Los elementos function_call de assistant pueden enviarse de vuelta con function_call_output usando el call_id correspondiente. Conserva cada llamada y su resultado. Se rechazan los resultados ausentes, duplicados o sin llamada correspondiente.

Ciclo de vida del streaming

Los eventos incluyen números de secuencia ordenados y eventos nativos de respuesta/salida. Una salida correcta termina en response.completed. El agotamiento del límite de salida termina en response.incomplete con max_output_tokens; el stream no usa [DONE].

Límite de almacenamiento

store:true, previous_response_id, los ID de conversación, la ejecución en segundo plano y la semántica nativa de recuperación/eliminación/cancelación no son compatibles. store:false desactiva la recuperación pública nativa de la respuesta; no borra los registros persistentes necesarios de seguridad y contabilidad.

Ejemplo de solicitud

Usa tu clave de cliente y un modelo publicado. Copiar un ejemplo no envía una solicitud.

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 solicitud

Generado a partir del contrato versionado. Las reglas de refinamiento anteriores siguen aplicándose.

Esquema de respuesta