Class DeepSeekCompletionResponse

java.lang.Object

de.entwicklertraining.api.base.ApiResponse<DeepSeekCompletionRequest>

de.entwicklertraining.deepseek4j.DeepSeekResponse<DeepSeekCompletionRequest>

de.entwicklertraining.deepseek4j.chat.completion.DeepSeekCompletionResponse

public final class DeepSeekCompletionResponse
extends DeepSeekResponse<DeepSeekCompletionRequest>

Represents a response from the DeepSeek Chat Completion API. Provides methods to access various parts of the response data.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DeepSeekCompletionResponse.Choice	Represents a single choice in the chat completion response.
static class	DeepSeekCompletionResponse.CompletionTokensDetails	Represents detailed token counts within the completion usage.
static class	DeepSeekCompletionResponse.FunctionCall	Represents the function details within a tool call.
static class	DeepSeekCompletionResponse.Logprobs	Represents log probability information for the completion.
static class	DeepSeekCompletionResponse.Message	Represents a message within a choice, including content and potential tool calls.
static class	DeepSeekCompletionResponse.TokenLogprob	Represents log probability information for a single token.
static class	DeepSeekCompletionResponse.ToolCall	Represents a tool call requested by the model.
static class	DeepSeekCompletionResponse.TopTokenLogprob	Represents log probability information for one of the top alternative tokens.
static class	DeepSeekCompletionResponse.Usage	Represents usage statistics for the API call.

Field Summary

Fields inherited from class de.entwicklertraining.deepseek4j.DeepSeekResponse

json

Constructor Summary

Constructors

Constructor	Description
DeepSeekCompletionResponse(org.json.JSONObject json, DeepSeekCompletionRequest request)	Constructs a DeepSeekCompletionResponse.

Method Summary

Modifier and Type	Method	Description
String	assistantMessage()	Convenience method to get the message content from the first choice.
String	finishReason()	Convenience method to get the finish reason from the first choice.
List<DeepSeekCompletionResponse.Choice>	getChoices()	Gets the list of chat completion choices.
long	getCreated()	Gets the Unix timestamp (in seconds) of when the chat completion was created.
String	getId()	Gets the unique identifier for the chat completion.
String	getModel()	Gets the model used for the chat completion.
String	getObject()	Gets the object type, which is always "chat.completion".
String	getSystemFingerprint()	Gets the system fingerprint representing the backend configuration used for the request.
DeepSeekCompletionResponse.Usage	getUsage()	Gets the usage statistics for the completion request.

Methods inherited from class de.entwicklertraining.deepseek4j.DeepSeekResponse

getJson, getRequest

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DeepSeekCompletionResponse

public DeepSeekCompletionResponse(org.json.JSONObject json,
 DeepSeekCompletionRequest request)

Constructs a DeepSeekCompletionResponse.

Parameters:

json - The raw JSON response object.

request - The original request that led to this response.

Method Details

getId

public String getId()

Gets the unique identifier for the chat completion.

Returns:

The ID string, or null if not present. [cite: 30]

getObject

public String getObject()

Gets the object type, which is always "chat.completion".

Returns:

The object type string, or null if not present.

getCreated

public long getCreated()

Gets the Unix timestamp (in seconds) of when the chat completion was created.

Returns:

The creation timestamp, or 0 if not present.

getModel

public String getModel()

Gets the model used for the chat completion.

Returns:

The model ID string, or null if not present.

getSystemFingerprint

public String getSystemFingerprint()

Gets the system fingerprint representing the backend configuration used for the request.

Returns:

The system fingerprint string, or null if not present.

getChoices

public List<DeepSeekCompletionResponse.Choice> getChoices()

Gets the list of chat completion choices.

Returns:

A list of Choice objects, or an empty list if not present or invalid. [cite: 31, 32]

getUsage

public DeepSeekCompletionResponse.Usage getUsage()

Gets the usage statistics for the completion request.

Returns:

A Usage object, or null if the "usage" field is not present or invalid. [cite: 27]

assistantMessage

public String assistantMessage()

Convenience method to get the message content from the first choice.

Returns:

The content string, or null if no choices or message content exists.

finishReason

public String finishReason()

Convenience method to get the finish reason from the first choice.

Returns:

The finish reason string (e.g., "stop", "tool_calls"), or null if no choices exist.