llmkit 0.1.3

Production-grade LLM client - 100+ providers, 11,000+ models. Pure Rust.
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
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134

//! Ideogram provider for AI image generation with text.
//!
//! Ideogram specializes in AI image generation with accurate text rendering.

use crate::error::{Error, Result};
use serde::{Deserialize, Serialize};

/// Ideogram provider
pub struct IdeogramProvider {
    #[allow(dead_code)]
    api_key: String,
    #[allow(dead_code)]
    base_url: String,
}

impl IdeogramProvider {
    /// Create a new Ideogram provider
    pub fn new(api_key: &str) -> Self {
        Self {
            api_key: api_key.to_string(),
            base_url: "https://api.ideogram.ai".to_string(),
        }
    }

    /// Create with custom base URL
    pub fn with_base_url(api_key: &str, base_url: &str) -> Self {
        Self {
            api_key: api_key.to_string(),
            base_url: base_url.to_string(),
        }
    }

    /// Create from environment variable
    pub fn from_env() -> Result<Self> {
        let api_key = std::env::var("IDEOGRAM_API_KEY")
            .map_err(|_| Error::Configuration("IDEOGRAM_API_KEY not set".to_string()))?;
        Ok(Self::new(&api_key))
    }

    /// Get list of available models
    pub async fn list_models(&self) -> Result<Vec<String>> {
        Ok(vec![
            "V_2".to_string(),
            "V_2_TURBO".to_string(),
            "V_1".to_string(),
            "V_1_TURBO".to_string(),
        ])
    }

    /// Get model details
    pub fn get_model_info(model: &str) -> Option<IdeogramModelInfo> {
        match model {
            "V_2" => Some(IdeogramModelInfo {
                name: model.to_string(),
                description: "Latest model with best text rendering".to_string(),
                resolutions: vec![
                    "RESOLUTION_1024_1024".to_string(),
                    "RESOLUTION_1280_720".to_string(),
                    "RESOLUTION_720_1280".to_string(),
                ],
                features: vec![
                    "text-in-image".to_string(),
                    "style-reference".to_string(),
                    "color-palette".to_string(),
                    "magic-prompt".to_string(),
                ],
                styles: vec![
                    "AUTO".to_string(),
                    "GENERAL".to_string(),
                    "REALISTIC".to_string(),
                    "DESIGN".to_string(),
                    "RENDER_3D".to_string(),
                    "ANIME".to_string(),
                ],
            }),
            "V_2_TURBO" => Some(IdeogramModelInfo {
                name: model.to_string(),
                description: "Fast generation with good quality".to_string(),
                resolutions: vec![
                    "RESOLUTION_1024_1024".to_string(),
                    "RESOLUTION_1280_720".to_string(),
                ],
                features: vec!["text-in-image".to_string(), "fast-generation".to_string()],
                styles: vec![
                    "AUTO".to_string(),
                    "GENERAL".to_string(),
                    "REALISTIC".to_string(),
                ],
            }),
            "V_1" => Some(IdeogramModelInfo {
                name: model.to_string(),
                description: "Original model".to_string(),
                resolutions: vec!["RESOLUTION_1024_1024".to_string()],
                features: vec!["text-in-image".to_string()],
                styles: vec!["AUTO".to_string(), "GENERAL".to_string()],
            }),
            _ => None,
        }
    }
}

/// Ideogram model information
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct IdeogramModelInfo {
    pub name: String,
    pub description: String,
    pub resolutions: Vec<String>,
    pub features: Vec<String>,
    pub styles: Vec<String>,
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_provider_creation() {
        let provider = IdeogramProvider::new("test-key");
        assert!(provider.base_url.contains("ideogram.ai"));
    }

    #[tokio::test]
    async fn test_list_models() {
        let provider = IdeogramProvider::new("test-key");
        let models = provider.list_models().await.unwrap();
        assert!(models.len() >= 2);
    }

    #[test]
    fn test_model_info() {
        let info = IdeogramProvider::get_model_info("V_2").unwrap();
        assert!(info.features.contains(&"text-in-image".to_string()));
    }
}