Class ChatCompletionChunk
-
- All Implemented Interfaces:
public final class ChatCompletionChunk
Represents a streamed chunk of a chat completion response returned by the model, based on the provided input. Learn more.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description public final class
ChatCompletionChunk.Builder
A builder for ChatCompletionChunk.
public final class
ChatCompletionChunk.Choice
public final class
ChatCompletionChunk.ServiceTier
The service tier used for processing the request.
-
Method Summary
Modifier and Type Method Description final String
id()
A unique identifier for the chat completion. final List<ChatCompletionChunk.Choice>
choices()
A list of chat completion choices. final Long
created()
The Unix timestamp (in seconds) of when the chat completion was created. final String
model()
The model to generate the completion. final JsonValue
_object_()
The object type, which is always chat.completion.chunk
.final Optional<ChatCompletionChunk.ServiceTier>
serviceTier()
The service tier used for processing the request. final Optional<String>
systemFingerprint()
This fingerprint represents the backend configuration that the model runs with. final Optional<CompletionUsage>
usage()
An optional field that will only be present when you set stream_options: {"include_usage": true}
in your request.final JsonField<String>
_id()
Returns the raw JSON value of id. final JsonField<List<ChatCompletionChunk.Choice>>
_choices()
Returns the raw JSON value of choices. final JsonField<Long>
_created()
Returns the raw JSON value of created. final JsonField<String>
_model()
Returns the raw JSON value of model. final JsonField<ChatCompletionChunk.ServiceTier>
_serviceTier()
Returns the raw JSON value of serviceTier. final JsonField<String>
_systemFingerprint()
Returns the raw JSON value of systemFingerprint. final JsonField<CompletionUsage>
_usage()
Returns the raw JSON value of usage. final Map<String, JsonValue>
_additionalProperties()
final ChatCompletionChunk.Builder
toBuilder()
final ChatCompletionChunk
validate()
final Boolean
isValid()
Boolean
equals(Object other)
Integer
hashCode()
String
toString()
final static ChatCompletionChunk.Builder
builder()
Returns a mutable builder for constructing an instance of ChatCompletionChunk. -
-
Method Detail
-
choices
final List<ChatCompletionChunk.Choice> choices()
A list of chat completion choices. Can contain more than one elements if
n
is greater than 1. Can also be empty for the last chunk if you setstream_options: {"include_usage": true}
.
-
created
final Long created()
The Unix timestamp (in seconds) of when the chat completion was created. Each chunk has the same timestamp.
-
_object_
final JsonValue _object_()
The object type, which is always
chat.completion.chunk
.Expected to always return the following:
JsonValue.from("chat.completion.chunk")
However, this method can be useful for debugging and logging (e.g. if the server responded with an unexpected value).
-
serviceTier
final Optional<ChatCompletionChunk.ServiceTier> serviceTier()
The service tier used for processing the request.
-
systemFingerprint
final Optional<String> systemFingerprint()
This fingerprint represents the backend configuration that the model runs with. Can be used in conjunction with the
seed
request parameter to understand when backend changes have been made that might impact determinism.
-
usage
final Optional<CompletionUsage> usage()
An optional field that will only be present when you set
stream_options: {"include_usage": true}
in your request. When present, it contains a null value except for the last chunk which contains the token usage statistics for the entire request.NOTE: If the stream is interrupted or cancelled, you may not receive the final usage chunk which contains the total token usage for the request.
-
_id
final JsonField<String> _id()
Returns the raw JSON value of id.
Unlike id, this method doesn't throw if the JSON field has an unexpected type.
-
_choices
final JsonField<List<ChatCompletionChunk.Choice>> _choices()
Returns the raw JSON value of choices.
Unlike choices, this method doesn't throw if the JSON field has an unexpected type.
-
_created
final JsonField<Long> _created()
Returns the raw JSON value of created.
Unlike created, this method doesn't throw if the JSON field has an unexpected type.
-
_model
final JsonField<String> _model()
Returns the raw JSON value of model.
Unlike model, this method doesn't throw if the JSON field has an unexpected type.
-
_serviceTier
final JsonField<ChatCompletionChunk.ServiceTier> _serviceTier()
Returns the raw JSON value of serviceTier.
Unlike serviceTier, this method doesn't throw if the JSON field has an unexpected type.
-
_systemFingerprint
final JsonField<String> _systemFingerprint()
Returns the raw JSON value of systemFingerprint.
Unlike systemFingerprint, this method doesn't throw if the JSON field has an unexpected type.
-
_usage
final JsonField<CompletionUsage> _usage()
Returns the raw JSON value of usage.
Unlike usage, this method doesn't throw if the JSON field has an unexpected type.
-
_additionalProperties
final Map<String, JsonValue> _additionalProperties()
-
toBuilder
final ChatCompletionChunk.Builder toBuilder()
-
validate
final ChatCompletionChunk validate()
-
builder
final static ChatCompletionChunk.Builder builder()
Returns a mutable builder for constructing an instance of ChatCompletionChunk.
The following fields are required:
.id() .choices() .created() .model()
-
-
-
-