Struct HttpClient 

pub struct HttpClient { /* private fields */ }

HTTP client for making requests to the Replicate API with retry logic.

Implementations

impl HttpClient

pub fn new(api_token: impl Into<String>) -> Result<Self>

Create a new HTTP client with the given API token and default retry logic.

pub fn with_retry_config( api_token: impl Into<String>, retry_config: RetryConfig, ) -> Result<Self>

Create a new HTTP client with the given API token and custom retry configuration.

pub fn with_http_config( api_token: impl Into<String>, http_config: HttpConfig, ) -> Result<Self>

Create a new HTTP client with the given API token and custom HTTP configuration.

pub fn with_base_url( api_token: impl Into<String>, base_url: impl Into<String>, ) -> Result<Self>

Create a new HTTP client with custom base URL.

pub fn with_base_url_and_retry( api_token: impl Into<String>, base_url: impl Into<String>, retry_config: RetryConfig, ) -> Result<Self>

Create a new HTTP client with custom base URL and retry configuration.

pub fn with_base_url_and_http_config( api_token: impl Into<String>, base_url: impl Into<String>, http_config: HttpConfig, ) -> Result<Self>

Create a new HTTP client with custom base URL and HTTP configuration.

pub fn inner(&self) -> &ClientWithMiddleware

Get a reference to the underlying client with middleware.

pub async fn get(&self, path: &str) -> Result<Response>

Make a GET request.

pub async fn post<T: Serialize>(&self, path: &str, body: &T) -> Result<Response>

Make a POST request with JSON body.

pub async fn post_empty(&self, path: &str) -> Result<Response>

Make a POST request without a body.

pub async fn put<T: Serialize>(&self, path: &str, body: &T) -> Result<Response>

Make a PUT request with JSON body.

pub async fn delete(&self, path: &str) -> Result<Response>

Make a DELETE request.

pub async fn get_json<T: for<'de> Deserialize<'de>>( &self, path: &str, ) -> Result<T>

Make a GET request and deserialize the response as JSON.

pub async fn post_json<B: Serialize, T: for<'de> Deserialize<'de>>( &self, path: &str, body: &B, ) -> Result<T>

Make a POST request and deserialize the response as JSON.

pub async fn post_empty_json<T: for<'de> Deserialize<'de>>( &self, path: &str, ) -> Result<T>

Make a POST request without body and deserialize the response as JSON.

pub fn configure_retries( &mut self, max_retries: u32, min_delay: Duration, max_delay: Duration, ) -> Result<()>

Configure retry policy for this client.

This rebuilds the underlying HTTP client with new retry settings.

Examples

let mut client = Client::new("your-api-token")?;

// Configure more aggressive retry settings
client.http_client_mut().configure_retries(
    5,                               // max_retries
    Duration::from_millis(100),      // min_delay
    Duration::from_secs(60),         // max_delay
)?;

pub fn configure_retries_advanced( &mut self, max_retries: u32, min_delay: Duration, max_delay: Duration, base_multiplier: u32, ) -> Result<()>

Configure retry policy with advanced settings.

This rebuilds the underlying HTTP client with new retry settings.

Arguments

• max_retries - Maximum number of retry attempts
• min_delay - Minimum delay between retries
• max_delay - Maximum delay between retries
• base_multiplier - Base multiplier for exponential backoff (typically 2)

pub fn configure_timeouts( &mut self, connect_timeout: Option<Duration>, request_timeout: Option<Duration>, ) -> Result<()>

Configure timeout settings for this client.

This rebuilds the underlying HTTP client with new timeout settings.

Arguments

• connect_timeout - Maximum time to wait for connection establishment (None = no timeout)
• request_timeout - Maximum time to wait for complete request (None = no timeout)

pub fn retry_config(&self) -> &RetryConfig

Get the current retry configuration.

pub fn timeout_config(&self) -> &TimeoutConfig

Get the current timeout configuration.

pub fn http_config(&self) -> &HttpConfig

Get the current HTTP configuration.

pub async fn post_multipart(&self, path: &str, form: Form) -> Result<Response>

POST request with multipart form data.

pub async fn post_multipart_json<T: for<'de> Deserialize<'de>>( &self, path: &str, form: Form, ) -> Result<T>

POST multipart form data and parse JSON response.

pub async fn create_file_form( file_content: &[u8], filename: Option<&str>, content_type: Option<&str>, metadata: Option<&HashMap<String, Value>>, ) -> Result<Form>

Create a multipart form from file and optional metadata.

pub async fn create_file_form_from_path( file_path: &Path, metadata: Option<&HashMap<String, Value>>, ) -> Result<Form>

Create a multipart form from a file path.

Trait Implementations

impl Clone for HttpClient

fn clone(&self) -> HttpClient

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HttpClient

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

Formats the value using the given formatter.