Struct ApiRequest 

pub struct ApiRequest { /* private fields */ }

A safe, chainable request builder that wraps ChatCompletionRequest.

Use with_model to set an arbitrary model string, or the convenience constructors deepseek_chat and deepseek_reasoner for the standard DeepSeek models.

Implementations

impl ApiRequest

pub fn builder() -> Self

Start a new builder with default values.

pub fn with_model(self, name: impl Into<String>) -> Self

Set the model by string (builder-style).

Accepts any model identifier — a named DeepSeek model or any OpenAI-compatible model string:

use ds_api::ApiRequest;

let req = ApiRequest::builder().with_model("deepseek-chat");
let req = ApiRequest::builder().with_model("gpt-4o");

pub fn deepseek_chat(messages: Vec<Message>) -> Self

Convenience constructor: deepseek-chat + messages

pub fn deepseek_reasoner(messages: Vec<Message>) -> Self

Convenience constructor: deepseek-reasoner + messages

pub fn add_message(self, msg: Message) -> Self

Add a message to the request.

pub fn messages(self, msgs: Vec<Message>) -> Self

Replace messages.

pub fn json(self) -> Self

Request response as JSON object.

pub fn text(self) -> Self

Request response as plain text.

pub fn temperature(self, t: f32) -> Self

Set temperature.

pub fn max_tokens(self, n: u32) -> Self

Set max tokens.

pub fn add_tool(self, tool: Tool) -> Self

Add a raw tool definition (from crate::raw::Tool).

pub fn tool_choice_auto(self) -> Self

Set tool choice to Auto.

pub fn stream(self, enabled: bool) -> Self

Enable/disable streaming (stream: true).

Trait Implementations

impl Debug for ApiRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.