#openai-api #api-key #api-bindings #chat-completion

openai_api_rust

A very simple Rust library for OpenAI API, free from complex async operations and redundant dependencies

9 releases

0.1.9 May 29, 2024
0.1.8 Apr 4, 2023
0.1.5 Mar 31, 2023

#40 in Machine learning

Download history 98/week @ 2024-08-11 86/week @ 2024-08-18 97/week @ 2024-08-25 88/week @ 2024-09-01 98/week @ 2024-09-08 117/week @ 2024-09-15 187/week @ 2024-09-22 188/week @ 2024-09-29 56/week @ 2024-10-06 79/week @ 2024-10-13 107/week @ 2024-10-20 104/week @ 2024-10-27 98/week @ 2024-11-03 52/week @ 2024-11-10 155/week @ 2024-11-17 187/week @ 2024-11-24

507 downloads per month
Used in 6 crates

MIT license

535KB
979 lines

OpenAI API for Rust

GitHub Workflow Status Crates.io Crates.io GitHub

A community-maintained library provides a simple and convenient way to interact with the OpenAI API. No complex async and redundant dependencies.

API

check official API reference

API Support
Models ✔️
Completions ✔️
Chat ✔️
Images ✔️
Embeddings ✔️
Audio ✔️
Files
Fine-tunes
Moderations
Engines

Usage

Add the following to your Cargo.toml file:

openai_api_rust = "0.1.9"

Export your API key into the environment variables

export OPENAI_API_KEY=<your_api_key>

Then use the crate in your Rust code:

use openai_api_rust::*;
use openai_api_rust::chat::*;
use openai_api_rust::completions::*;

fn main() {
    // Load API key from environment OPENAI_API_KEY.
    // You can also hadcode through `Auth::new(<your_api_key>)`, but it is not recommended.
    let auth = Auth::from_env().unwrap();
    let openai = OpenAI::new(auth, "https://api.openai.com/v1/");
    let body = ChatBody {
        model: "gpt-3.5-turbo".to_string(),
        max_tokens: Some(7),
        temperature: Some(0_f32),
        top_p: Some(0_f32),
        n: Some(2),
        stream: Some(false),
        stop: None,
        presence_penalty: None,
        frequency_penalty: None,
        logit_bias: None,
        user: None,
        messages: vec![Message { role: Role::User, content: "Hello!".to_string() }],
    };
    let rs = openai.chat_completion_create(&body);
    let choice = rs.unwrap().choices;
    let message = &choice[0].message.as_ref().unwrap();
    assert!(message.content.contains("Hello"));
}

Use proxy

Load proxy from env

let openai = OpenAI::new(auth, "https://api.openai.com/v1/")
        .use_env_proxy();

Set the proxy manually

let openai = OpenAI::new(auth, "https://api.openai.com/v1/")
        .set_proxy("http://127.0.0.1:1080");

License

This library is distributed under the terms of the MIT license. See LICENSE for details.

Dependencies

~3.5–5MB
~88K SLoC