Skip to main content
The Python SDK and docs are currently in beta. Report issues on GitHub.
Complete non-streaming response from the Responses API

Fields

FieldTypeRequiredDescriptionExample
idstr:heavy_check_mark:N/A
objectcomponents.Object:heavy_check_mark:N/A
created_atfloat:heavy_check_mark:N/A
modelstr:heavy_check_mark:N/A
statuscomponents.OpenAIResponsesResponseStatus:heavy_check_mark:N/A
completed_atNullable[float]:heavy_check_mark:N/A
outputList[components.ResponsesOutputItem]:heavy_check_mark:N/A
userOptionalNullable[str]:heavy_minus_sign:N/A
output_textOptional[str]:heavy_minus_sign:N/A
prompt_cache_keyOptionalNullable[str]:heavy_minus_sign:N/A
safety_identifierOptionalNullable[str]:heavy_minus_sign:N/A
errorNullable[components.ResponsesErrorField]:heavy_check_mark:Error information returned from the API{"code": "rate_limit_exceeded","message": "Rate limit exceeded. Please try again later."}
incomplete_detailsNullable[components.OpenAIResponsesIncompleteDetails]:heavy_check_mark:N/A
usageOptionalNullable[components.OpenResponsesUsage]:heavy_minus_sign:Token usage information for the response{"input_tokens": 10,"output_tokens": 25,"total_tokens": 35,"input_tokens_details": {"cached_tokens": 0},
“output_tokens_details”: {"reasoning_tokens": 0},
“cost”: 0.0012,
“cost_details”: {"upstream_inference_cost": null,"upstream_inference_input_cost": 0.0008,"upstream_inference_output_cost": 0.0004}
}
max_tool_callsOptionalNullable[float]:heavy_minus_sign:N/A
top_logprobsOptional[float]:heavy_minus_sign:N/A
max_output_tokensOptionalNullable[float]:heavy_minus_sign:N/A
temperatureNullable[float]:heavy_check_mark:N/A
top_pNullable[float]:heavy_check_mark:N/A
presence_penaltyNullable[float]:heavy_check_mark:N/A
frequency_penaltyNullable[float]:heavy_check_mark:N/A
instructionsNullable[components.OpenAIResponsesInputUnion]:heavy_check_mark:N/A
metadataDict[str, str]:heavy_check_mark:Metadata key-value pairs for the request. Keys must be ≤64 characters and cannot contain brackets. Values must be ≤512 characters. Maximum 16 pairs allowed.{"user_id": "123","session_id": "abc-def-ghi"}
toolsList[components.OpenResponsesNonStreamingResponseToolUnion]:heavy_check_mark:N/A
tool_choicecomponents.OpenAIResponsesToolChoiceUnion:heavy_check_mark:N/A
parallel_tool_callsbool:heavy_check_mark:N/A
promptOptionalNullable[components.OpenAIResponsesPrompt]:heavy_minus_sign:N/A
backgroundOptionalNullable[bool]:heavy_minus_sign:N/A
previous_response_idOptionalNullable[str]:heavy_minus_sign:N/A
reasoningOptionalNullable[components.OpenAIResponsesReasoningConfig]:heavy_minus_sign:N/A
service_tierOptionalNullable[components.OpenAIResponsesServiceTier]:heavy_minus_sign:N/A
storeOptional[bool]:heavy_minus_sign:N/A
truncationOptionalNullable[components.OpenAIResponsesTruncation]:heavy_minus_sign:N/A
textOptional[components.ResponseTextConfig]:heavy_minus_sign:Text output configuration including format and verbosity{"format": {"type": "text"},
“verbosity”: “medium”
}