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
//! The Cohere client: a [`CohereConfig`] on a transport, and the models it
//! builds.
use crate::client::macros::http_client;
use crate::driver::Model;
use crate::providers::cohere::{CohereConfig, Embeddings, ImageEmbeddings, NativeChat};
use crate::providers::openai::wire::Chat;
http_client!(
/// Cohere: its [`CohereConfig`] on a transport. Every model it builds
/// sends through that transport.
Cohere,
CohereConfig
);
impl Cohere {
/// Cohere with `api_key` and default settings, on the shared reqwest
/// client.
#[cfg(feature = "reqwest")]
#[cfg_attr(docsrs, doc(cfg(feature = "reqwest")))]
pub fn new(api_key: impl Into<crate::wire::Secret>) -> Self {
CohereConfig::new(api_key).client()
}
/// Cohere from `COHERE_API_KEY`, on the shared reqwest client.
#[cfg(feature = "reqwest")]
#[cfg_attr(docsrs, doc(cfg(feature = "reqwest")))]
pub fn from_env() -> Result<Self, crate::client::env::EnvError> {
Ok(CohereConfig::from_env()?.client())
}
/// The chat model for `model`, on Cohere's OpenAI Compatibility API. It
/// sends a request's documents as text in the history.
pub fn completion(&self, model: impl Into<String>) -> Model<Chat> {
self.model(self.config.completion(model))
}
/// The chat model for `model`, on Cohere's native chat API, which
/// grounds the answer in a request's documents and cites them.
pub fn native_completion(&self, model: impl Into<String>) -> Model<NativeChat> {
self.model(self.config.native_completion(model))
}
/// The text-embedding model for `model`. `ndims` is the width it
/// reports, defaulting to the model's known width.
pub fn embedding(&self, model: impl Into<String>, ndims: Option<usize>) -> Model<Embeddings> {
self.model(self.config.embedding(model, ndims))
}
/// The image-embedding model. Cohere embeds images with one fixed model,
/// so it names none.
pub fn image_embedding(&self) -> Model<ImageEmbeddings> {
self.model(self.config.image_embedding())
}
}