Struct openai_rust::Client

source ·
pub struct Client { /* private fields */ }
Expand description

This is the main interface to interact with the api.

Implementations§

source§

impl Client

source

pub fn new(api_key: &str) -> Client

Create a new client. This will automatically build a reqwest::Client used internally.

Examples found in repository?
examples/chat_example.rs (line 6)
5
6
7
8
9
10
11
12
13
14
15
async fn main() {
    let client = openai_rust::Client::new(&std::env::var("OPENAI_API_KEY").unwrap());
    let args = openai_rust::chat::ChatArguments::new("gpt-3.5-turbo", vec![
        openai_rust::chat::Message {
            role: "user".to_owned(),
            content: "Hello GPT!".to_owned(),
        }
    ]);
    let res = client.create_chat(args).await.unwrap();
    println!("{}", res);
}
More examples
Hide additional examples
examples/chat_stream_example.rs (line 8)
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
async fn main() {
    let client = openai_rust::Client::new(&std::env::var("OPENAI_API_KEY").unwrap());
    let args = openai_rust::chat::ChatArguments::new("gpt-3.5-turbo", vec![
        openai_rust::chat::Message {
            role: "user".to_owned(),
            content: "Hello GPT!".to_owned(),
        }
    ]);
    let mut res = client.create_chat_stream(args).await.unwrap();
    while let Some(events) = res.next().await {
        for event in events.unwrap() {
            print!("{}", event);
            std::io::stdout().flush().unwrap();
        }
    }
}
source

pub async fn list_models(&self) -> Result<Vec<Model>, Error>

Lists the currently available models, and provides basic information about each one such as the owner and availability.

let client = openai_rust::Client::new(api_key);
let models = client.list_models().await.unwrap();

See https://platform.openai.com/docs/api-reference/models/list.

source

pub async fn create_chat( &self, args: ChatArguments ) -> Result<ChatResponse, Error>

Given a chat conversation, the model will return a chat completion response.

See https://platform.openai.com/docs/api-reference/chat.

let client = openai_rust::Client::new(api_key);
let args = openai_rust::chat::ChatArguments::new("gpt-3.5-turbo", vec![
   openai_rust::chat::Message {
       role: "user".to_owned(),
       content: "Hello GPT!".to_owned(),
   }
]);
let res = client.create_chat(args).await.unwrap();
println!("{}", res.choices[0].message.content);
Examples found in repository?
examples/chat_example.rs (line 13)
5
6
7
8
9
10
11
12
13
14
15
async fn main() {
    let client = openai_rust::Client::new(&std::env::var("OPENAI_API_KEY").unwrap());
    let args = openai_rust::chat::ChatArguments::new("gpt-3.5-turbo", vec![
        openai_rust::chat::Message {
            role: "user".to_owned(),
            content: "Hello GPT!".to_owned(),
        }
    ]);
    let res = client.create_chat(args).await.unwrap();
    println!("{}", res);
}
source

pub async fn create_chat_stream( &self, args: ChatArguments ) -> Result<impl Stream<Item = Result<Vec<ChatResponseEvent>>>>

Like Client::create_chat but with streaming.

See https://platform.openai.com/docs/api-reference/chat.

This method will return a stream. Calling next on it will return a vector of chat::stream::ChatResponseEvents.

use openai_rust::futures_util::StreamExt;
let mut res = client.create_chat_stream(args).await.unwrap();
while let Some(events) = res.next().await {
    for event in events.unwrap() {
        print!("{}", event.choices[0].delta.content.as_ref().unwrap_or(&"".to_owned()));
        std::io::stdout().flush().unwrap();
    }
}
Examples found in repository?
examples/chat_stream_example.rs (line 15)
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
async fn main() {
    let client = openai_rust::Client::new(&std::env::var("OPENAI_API_KEY").unwrap());
    let args = openai_rust::chat::ChatArguments::new("gpt-3.5-turbo", vec![
        openai_rust::chat::Message {
            role: "user".to_owned(),
            content: "Hello GPT!".to_owned(),
        }
    ]);
    let mut res = client.create_chat_stream(args).await.unwrap();
    while let Some(events) = res.next().await {
        for event in events.unwrap() {
            print!("{}", event);
            std::io::stdout().flush().unwrap();
        }
    }
}
source

pub async fn create_completion( &self, args: CompletionArguments ) -> Result<CompletionResponse>

Creates a completion for the provided prompt and parameters

let c = openai_rust::Client::new(api_key);
let args = openai_rust::completions::CompletionArguments::new("text-davinci-003", "The quick brown fox".to_owned());
println!("{}", c.create_completion(args).await.unwrap().choices[0].text);

Auto Trait Implementations§

§

impl !RefUnwindSafe for Client

§

impl Send for Client

§

impl Sync for Client

§

impl Unpin for Client

§

impl !UnwindSafe for Client

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

const: unstable · source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

const: unstable · source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

const: unstable · source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for Twhere U: From<T>,

const: unstable · source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
const: unstable · source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
const: unstable · source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more