Cencori Rust SDK
Official Rust SDK for Cencori - AI Infrastructure for Production.
One SDK for AI Gateway, Compute, Workflow, and Storage. Every operation is secured, logged, and tracked.
Installation
Add to your Cargo.toml:
[]
= "1.2"
Quick Start
use ;
let cencori = new.unwrap;
// Chat
let response = cencori.ai.chat.unwrap;
println!;
// Embeddings
use EmbeddingInput;
let embedding = cencori.ai.embeddings.unwrap;
println!;
Async Support
All methods have async counterparts:
use ;
async
Streaming
use ;
let cencori = new.unwrap;
for chunk in cencori.ai.chat_stream.unwrap
Structured Output (Object Generation)
use Cencori;
use json;
let cencori = new.unwrap;
let schema = json!;
let response = cencori.ai..unwrap;
println!;
Vision (Image Understanding)
Analyze, describe, OCR, and classify images. Routes across OpenAI, Anthropic, and Google vision-capable models.
use Cencori;
use VisionParams;
let cencori = new.unwrap;
// General analysis with a custom prompt
let params = from_url
.with_prompt;
let result = cencori.vision.analyze.unwrap;
println!;
// OCR from a local file
use fs;
use ;
let bytes = read.unwrap;
let b64 = STANDARD.encode;
let ocr = cencori
.vision
.ocr
.unwrap;
println!;
Async variants: cencori.vision.async_analyze(¶ms).await, async_describe, async_ocr, async_classify.
See docs for the full API.
Documents (PDF & Image Extraction)
Extract text from PDFs and images, summarize, and answer questions. Text-based PDFs use native parsing — no LLM tokens.
use DocumentParams;
use Cencori;
let cencori = new?;
// Extract text (native PDF parse — free)
let result = cencori
.documents
.extract?;
println!; // 'pdf_text' — no LLM cost
// Summarize
let summary = cencori
.documents
.summarize?;
println!;
// Q&A — strict "Not found" if answer isn't present
let answer = cencori.documents.query?;
println!;
Async variants: cencori.documents.async_extract(¶ms).await, async_summarize, async_query.
See docs for the full API.
Image Generation
use Cencori;
let cencori = new.unwrap;
let response = cencori.ai.generate_image.unwrap;
println!;
RAG (Retrieval-Augmented Generation)
use ;
let cencori = new.unwrap;
let response = cencori.ai.rag.unwrap;
println!;
Responses API
use Cencori;
use json;
let cencori = new.unwrap;
let response = cencori.ai.responses.unwrap;
println!;
Agent Management
use ;
let cencori = new.unwrap;
// Create an agent
let agent = cencori.agents.create.unwrap;
// List agents
let agents = cencori.agents.list.unwrap;
// Create an agent key
use CreateAgentKeyParams;
let key = cencori.agents.create_key.unwrap;
Memory (Vector Storage)
use ;
let cencori = new.unwrap;
// Create a namespace
let ns = cencori.memory.create_namespace.unwrap;
// Store a memory
use StoreMemoryOptions;
let memory = cencori.memory.store.unwrap;
// Search memories
use SearchMemoryOptions;
let results = cencori.memory.search.unwrap;
Sessions (Durable Execution)
Durable execution sessions for AI agents — pause/resume, event sourcing, and human-in-the-loop approvals.
use ;
let cencori = new.unwrap;
// Create a session
let session = cencori.sessions.create.unwrap;
println!;
// List sessions
use SessionListParams;
let sessions = cencori.sessions.list.unwrap;
println!;
// Get a session
let session = cencori.sessions.get.unwrap;
println!;
// Submit a turn (returns raw SSE stream)
use TurnParams;
use json;
let stream = cencori.sessions.submit_turn.unwrap;
// Read SSE events from stream.bytes() or stream.text()
// Get events
use PaginatedSessionEventsResponse;
let events: PaginatedSessionEventsResponse = cencori.sessions.get_events.unwrap;
println!;
// Approve a pending action (returns raw SSE stream)
use ApproveRejectParams;
let stream = cencori.sessions.approve.unwrap;
// Reject a pending action
let result = cencori.sessions.reject.unwrap;
println!;
// Delete a session
cencori.sessions.delete.unwrap;
Telemetry
use Cencori;
use WebTelemetryPayload;
let cencori = new.unwrap;
cencori.telemetry.report_web_request;
Client Configuration
use Cencori;
use HashMap;
// Full configuration with custom headers
let mut headers = new;
headers.insert;
let cencori = new_with_config.unwrap;
Project Management
use ;
let cencori = new.unwrap;
// List projects
let projects = cencori.projects.list.unwrap;
// Create project
let project = cencori.projects.create.unwrap;
API Key Management
use ;
let cencori = new.unwrap;
// Create API key
let key = cencori.api_keys.create.unwrap;
println!; // Only shown once!
// Get key stats
let stats = cencori.api_keys.get_stats.unwrap;
Metrics & Analytics
use Cencori;
let cencori = new.unwrap;
// Get usage metrics for last 24 hours
let metrics = cencori.metrics.get.unwrap;
println!;
println!;
Error Handling
use ;
let cencori = new.unwrap;
match cencori.ai.chat
Supported Models
| Provider | Models |
|---|---|
| OpenAI | gpt-4o, gpt-4-turbo, gpt-3.5-turbo |
| Anthropic | claude-3-opus, claude-3-sonnet, claude-3-haiku |
gemini-2.5-flash, gemini-2.0-flash |
Contributing
See CONTRIBUTING.md for development setup, workflow, and guidelines.
License
MIT © FohnAI