DeepSeek Kotlin SDK/org.oremif.deepseek.client/DeepSeekClient

DeepSeekClient

class DeepSeekClient : DeepSeekClientBase

Client for interacting with the DeepSeek API.

This client provides methods for all DeepSeek API endpoints, including chat completions, embeddings, and other AI capabilities.

Types

Builder

class Builder(token: String? = null) : DeepSeekClientBase.Builder

Builder for configuring and creating DeepSeekClient instances.

Properties

client

val client: HttpClient

The underlying HTTP client used for API requests

config

val config: DeepSeekClientConfig

Configuration options for the DeepSeek client

Functions

chat

suspend fun DeepSeekClient.chat(blockMessage: ChatCompletionRequest.MessageBuilder.() -> Unit): ChatCompletion

Sends a chat request with default parameters and a DSL for building messages.

suspend fun DeepSeekClient.chat(message: String): ChatCompletion

Sends a single user message to the chat API.

suspend fun DeepSeekClient.chat(messages: List<ChatMessage>): ChatCompletion

Sends a chat request with default parameters.

suspend fun DeepSeekClient.chat(params: ChatCompletionParams, blockMessage: ChatCompletionRequest.MessageBuilder.() -> Unit): ChatCompletion

Sends a chat request with custom parameters and a DSL for building messages.

suspend fun DeepSeekClient.chat(params: ChatCompletionParams, messages: List<ChatMessage>): ChatCompletion

Sends a chat request with custom parameters and messages.

chatCompletion

suspend fun DeepSeekClient.chatCompletion(block: ChatCompletionRequest.Builder.() -> Unit): ChatCompletion

Sends a fully customizable chat completion request.

suspend fun DeepSeekClientBase.chatCompletion(request: ChatCompletionRequest): ChatCompletion

Sends a chat completion request to the DeepSeek API.

chatCompletionStream

suspend fun DeepSeekClientBase.chatCompletionStream(request: ChatCompletionRequest): Flow<ChatCompletionChunk>

Streams chat completion responses chunk by chunk from the DeepSeek API.

open override fun close()

Closes the underlying HTTP client and releases resources.

configure

fun DeepSeekClient.configure(block: DeepSeekParams.() -> DeepSeekParams): DeepSeekClient

Creates a new client instance with parameters modified via a builder block.

fun DeepSeekClient.configure(params: DeepSeekParams): DeepSeekClient

Creates a new client instance with updated parameters.

fim

suspend fun DeepSeekClient.fim(prompt: String): FIMCompletion

Generates a completion using the Fill-In-the-Middle capability with default parameters.

suspend fun DeepSeekClient.fim(params: FIMCompletionParams, prompt: String): FIMCompletion

Generates a completion using the Fill-In-the-Middle capability with custom parameters.

fimCompletion

suspend fun DeepSeekClient.fimCompletion(block: FIMCompletionRequest.Builder.() -> Unit): FIMCompletion

Creates a fully customizable FIM completion request using a builder pattern.

suspend fun DeepSeekClientBase.fimCompletion(request: FIMCompletionRequest): FIMCompletion

Sends a Fill-In-the-Middle (FIM) completion request to the DeepSeek API.

fimCompletionStream

suspend fun DeepSeekClientBase.fimCompletionStream(request: FIMCompletionRequest): Flow<FIMCompletion>

Streams Fill-In-the-Middle (FIM) completions chunk by chunk from the DeepSeek API.

models

suspend fun DeepSeekClientBase.models(): ListsModels

Retrieves the list of available DeepSeek AI models.

userBalance

suspend fun DeepSeekClientBase.userBalance(): UserBalance

Retrieves the current user's available API credits and usage information.