Skip to main content

rig_core/completion/
mod.rs

1//! Provider-agnostic completion requests and responses. A provider's wire
2//! translates [`CompletionRequest`] into its own request and normalizes the
3//! reply as [`CompletionResponse`]; a [`Model`](crate::Model) sends it.
4//!
5//! ```no_run
6//! use rig_core::{Model, completion::CompletionRequest, providers::openai::OpenAI};
7//!
8//! # async fn run(http: rig_core::http_client::DynHttpClient) -> Result<(), Box<dyn std::error::Error>> {
9//! let model = OpenAI::from_env()?.with_http(http).completion("gpt-4o");
10//! let request = CompletionRequest::new("What is Rig?");
11//! let response = model.call(request).await?;
12//! println!("{:?}", response.choice);
13//! # Ok(())
14//! # }
15//! ```
16
17pub mod cache_cost;
18pub mod handle;
19pub mod history;
20pub mod message;
21pub mod options;
22pub mod provider_options;
23pub mod request;
24
25pub use cache_cost::{CacheCost, CacheRates};
26pub use handle::ModelRef;
27pub use history::{Accepts, LaterSystem, Media, Pairing, Place, Replay, ReplayTarget, adapt};
28pub use message::{AssistantContent, AssistantMessage, Message, MessageError};
29pub use options::{
30    CacheRetention, Effort, GenerationOptions, OnUnsupported, Reasoning, ServiceTier,
31    UnsupportedOption, Verbosity,
32};
33pub use provider_options::{
34    ExtensionOptions, OptionsError, ProviderExtension, ProviderOptions, ReplyExtras, SHARED,
35};
36pub use request::*;