openrouter-rust 0.1.0

A modular, type-safe Rust client for the OpenRouter API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

use crate::{
    client::OpenRouterClient,
    error::{OpenRouterError, Result},
};
use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct GenerationResponse {
    pub data: GenerationData,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct GenerationData {
    pub id: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub upstream_id: Option<String>,
    pub total_cost: f64,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub cache_discount: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub upstream_inference_cost: Option<f64>,
    pub created_at: String,
    pub model: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub app_id: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub streamed: Option<bool>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub cancelled: Option<bool>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub provider_name: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub latency: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub moderation_latency: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub generation_time: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub finish_reason: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub tokens_prompt: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub tokens_completion: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub native_tokens_prompt: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub native_tokens_completion: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub native_tokens_completion_images: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub native_tokens_reasoning: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub native_tokens_cached: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub num_media_prompt: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub num_input_audio_prompt: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub num_media_completion: Option<f64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub num_search_results: Option<f64>,
    pub origin: String,
    pub usage: f64,
    pub is_byok: bool,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub native_finish_reason: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub external_user: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub api_type: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub router: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub provider_responses: Option<Vec<ProviderResponse>>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ProviderResponse {
    pub id: String,
    pub endpoint_id: String,
    pub model_permaslug: String,
    pub provider_name: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub status: Option<f64>,
    pub latency: f64,
    pub is_byok: bool,
}

impl OpenRouterClient {
    pub async fn get_generation(&self, generation_id: impl Into<String>) -> Result<GenerationResponse> {
        let url = format!("{}/generation?id={}", self.base_url, generation_id.into());
        let headers = self.build_headers()?;

        let response = self
            .client
            .get(&url)
            .headers(headers)
            .send()
            .await
            .map_err(OpenRouterError::HttpError)?;

        let status = response.status();
        
        if !status.is_success() {
            let error_text = response.text().await.unwrap_or_default();
            return Err(OpenRouterError::ApiError {
                code: status.as_u16(),
                message: error_text,
            });
        }

        let result = response
            .json::<GenerationResponse>()
            .await
            .map_err(OpenRouterError::HttpError)?;

        Ok(result)
    }
}