Class ChatCompletionCreateParams.ResponseFormat
-
- All Implemented Interfaces:
public final class ChatCompletionCreateParams.ResponseFormatAn object specifying the format that the model must output.
Setting to
{ "type": "json_schema", "json_schema": {...} }enables Structured Outputs which ensures the model will match your supplied JSON schema. Learn more in the Structured Outputs guide.Setting to
{ "type": "json_object" }enables the older JSON mode, which ensures the message the model generates is valid JSON. Usingjson_schemais preferred for models that support it.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description public interfaceChatCompletionCreateParams.ResponseFormat.VisitorAn interface that defines how to map each variant of ResponseFormat to a value of type T.
-
Method Summary
Modifier and Type Method Description final Optional<ResponseFormatText>text()Default response format. final Optional<ResponseFormatJsonSchema>jsonSchema()JSON Schema response format. final Optional<ResponseFormatJsonObject>jsonObject()JSON object response format. final BooleanisText()final BooleanisJsonSchema()final BooleanisJsonObject()final ResponseFormatTextasText()Default response format. final ResponseFormatJsonSchemaasJsonSchema()JSON Schema response format. final ResponseFormatJsonObjectasJsonObject()JSON object response format. final Optional<JsonValue>_json()final <T extends Any> Taccept(ChatCompletionCreateParams.ResponseFormat.Visitor<T> visitor)Maps this instance's current variant to a value of type T using the given visitor. final ChatCompletionCreateParams.ResponseFormatvalidate()Validates that the types of all values in this object match their expected types recursively. final BooleanisValid()Booleanequals(Object other)IntegerhashCode()StringtoString()final static ChatCompletionCreateParams.ResponseFormatofText(ResponseFormatText text)Default response format. final static ChatCompletionCreateParams.ResponseFormatofJsonSchema(ResponseFormatJsonSchema jsonSchema)JSON Schema response format. final static ChatCompletionCreateParams.ResponseFormatofJsonObject(ResponseFormatJsonObject jsonObject)JSON object response format. -
-
Method Detail
-
text
final Optional<ResponseFormatText> text()
Default response format. Used to generate text responses.
-
jsonSchema
final Optional<ResponseFormatJsonSchema> jsonSchema()
JSON Schema response format. Used to generate structured JSON responses. Learn more about Structured Outputs.
-
jsonObject
final Optional<ResponseFormatJsonObject> jsonObject()
JSON object response format. An older method of generating JSON responses. Using
json_schemais recommended for models that support it. Note that the model will not generate JSON without a system or user message instructing it to do so.
-
isJsonSchema
final Boolean isJsonSchema()
-
isJsonObject
final Boolean isJsonObject()
-
asText
final ResponseFormatText asText()
Default response format. Used to generate text responses.
-
asJsonSchema
final ResponseFormatJsonSchema asJsonSchema()
JSON Schema response format. Used to generate structured JSON responses. Learn more about Structured Outputs.
-
asJsonObject
final ResponseFormatJsonObject asJsonObject()
JSON object response format. An older method of generating JSON responses. Using
json_schemais recommended for models that support it. Note that the model will not generate JSON without a system or user message instructing it to do so.
-
accept
final <T extends Any> T accept(ChatCompletionCreateParams.ResponseFormat.Visitor<T> visitor)
Maps this instance's current variant to a value of type T using the given visitor.
Note that this method is not forwards compatible with new variants from the API, unless visitor overrides Visitor.unknown. To handle variants not known to this version of the SDK gracefully, consider overriding Visitor.unknown:
import com.openai.core.JsonValue; import java.util.Optional; Optional<String> result = responseFormat.accept(new ResponseFormat.Visitor<Optional<String>>() { @Override public Optional<String> visitText(ResponseFormatText text) { return Optional.of(text.toString()); } // ... @Override public Optional<String> unknown(JsonValue json) { // Or inspect the `json`. return Optional.empty(); } });
-
validate
final ChatCompletionCreateParams.ResponseFormat validate()
Validates that the types of all values in this object match their expected types recursively.
This method is not forwards compatible with new types from the API for existing fields.
-
ofText
final static ChatCompletionCreateParams.ResponseFormat ofText(ResponseFormatText text)
Default response format. Used to generate text responses.
-
ofJsonSchema
final static ChatCompletionCreateParams.ResponseFormat ofJsonSchema(ResponseFormatJsonSchema jsonSchema)
JSON Schema response format. Used to generate structured JSON responses. Learn more about Structured Outputs.
-
ofJsonObject
final static ChatCompletionCreateParams.ResponseFormat ofJsonObject(ResponseFormatJsonObject jsonObject)
JSON object response format. An older method of generating JSON responses. Using
json_schemais recommended for models that support it. Note that the model will not generate JSON without a system or user message instructing it to do so.
-
-
-
-