DocsAPI
Models
Use this page to choose a compaction model. condense's models rewrite the repeated context in a request before it reaches your provider. Two are generally available, helene-1.1 (the default) and adeline-1. Pick one with the model field, or let the proxy choose.
Overview
Both models are generally available and run behind the same proxy. They work with the Anthropic and OpenAI routes and with the direct /v1/compress endpoint. Compaction is metered and draws condense credits. The upstream model call is still billed to your own provider key.
The fast, accuracy-first pass for general use, the proxy's default compaction engine.
View modelThe heavy lifter for long agent traces, resolved in a handful of parallel passes rather than token by token.
View modelHelene 1.1
Helene 1.1 is the fast, accuracy-first pass and the default compaction engine on the proxy.
| Model id | helene-1.1 |
|---|---|
| Best for | General use |
| Providers | Anthropic and OpenAI |
| Tunable | compression_rate |
| Price | $0.40 per 1M tokens removed |
On a standard question-answering benchmark, a model answering from Helene 1.1's compacted context scored higher than the same model reading the full, untouched transcript, while sending far fewer tokens. The full numbers are in the Helene 1.1 announcement.
model set already uses it.Helene 1.1 accepts an optional compression_rate between 0 and 1 to trade savings against fidelity. Omit it for the auto ratio. Set a fixed value (for example 0.2) to pin the target.
import httpx
resp = httpx.post(
"https://api.condense.chat/v1/compress",
headers={"X-Condense-Auth-Token": "ck_api_..."},
json={
"model": "helene-1.1",
"compression_rate": 0.2,
"messages": [{"role": "user", "content": "<a transcript to compact>"}],
},
)
print(resp.json())const resp = await fetch("https://api.condense.chat/v1/compress", {
method: "POST",
headers: {
"X-Condense-Auth-Token": "ck_api_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "helene-1.1",
compression_rate: 0.2,
messages: [{ role: "user", content: "<a transcript to compact>" }],
}),
});
console.log(await resp.json());package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
body := []byte(`{"model":"helene-1.1","compression_rate":0.2,"messages":[{"role":"user","content":"<a transcript to compact>"}]}`)
req, _ := http.NewRequest("POST", "https://api.condense.chat/v1/compress", bytes.NewReader(body))
req.Header.Set("X-Condense-Auth-Token", "ck_api_...")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
out, _ := io.ReadAll(resp.Body)
fmt.Println(string(out))
}use reqwest::Client;
use serde_json::json;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let resp = Client::new()
.post("https://api.condense.chat/v1/compress")
.header("X-Condense-Auth-Token", "ck_api_...")
.json(&json!({
"model": "helene-1.1",
"compression_rate": 0.2,
"messages": [{"role": "user", "content": "<a transcript to compact>"}]
}))
.send().await?;
println!("{}", resp.text().await?);
Ok(())
}curl https://api.condense.chat/v1/compress \
-H "X-Condense-Auth-Token: ck_api_..." \
-H "Content-Type: application/json" \
-d '{
"model": "helene-1.1",
"compression_rate": 0.2,
"messages": [
{"role": "user", "content": "<a transcript to compact>"}
]
}'Adeline 1
Adeline 1 does the heavy lifting on long agent traces.
| Model id | adeline-1 |
|---|---|
| Best for | Agent traces |
| Providers | Anthropic and OpenAI |
| Tunable | Auto |
| Price | $0.90 per 1M tokens removed |
It resolves the compacted rewrite in a handful of parallel passes instead of token by token, which is where its latency advantage comes from. The first-week-in-beta aggregates, measured on live Claude Code and SDK traffic, are in the Adeline 1 release note.
"model": "adeline-1" on the request.import httpx
resp = httpx.post(
"https://api.condense.chat/v1/compress",
headers={"X-Condense-Auth-Token": "ck_api_..."},
json={
"model": "adeline-1",
"messages": [{"role": "user", "content": "<a long agent trace to compact>"}],
},
)
print(resp.json())const resp = await fetch("https://api.condense.chat/v1/compress", {
method: "POST",
headers: {
"X-Condense-Auth-Token": "ck_api_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "adeline-1",
messages: [{ role: "user", content: "<a long agent trace to compact>" }],
}),
});
console.log(await resp.json());package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
body := []byte(`{"model":"adeline-1","messages":[{"role":"user","content":"<a long agent trace to compact>"}]}`)
req, _ := http.NewRequest("POST", "https://api.condense.chat/v1/compress", bytes.NewReader(body))
req.Header.Set("X-Condense-Auth-Token", "ck_api_...")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
out, _ := io.ReadAll(resp.Body)
fmt.Println(string(out))
}use reqwest::Client;
use serde_json::json;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let resp = Client::new()
.post("https://api.condense.chat/v1/compress")
.header("X-Condense-Auth-Token", "ck_api_...")
.json(&json!({
"model": "adeline-1",
"messages": [{"role": "user", "content": "<a long agent trace to compact>"}]
}))
.send().await?;
println!("{}", resp.text().await?);
Ok(())
}curl https://api.condense.chat/v1/compress \
-H "X-Condense-Auth-Token: ck_api_..." \
-H "Content-Type: application/json" \
-d '{
"model": "adeline-1",
"messages": [
{"role": "user", "content": "<a long agent trace to compact>"}
]
}'Choose a model
Start with Helene 1.1 for general use. Switch to Adeline 1 when a session is a long agent trace.
Next steps
- API reference: see wiring and headers.
- Rate limits: see how compaction credits work.
- Deprecations: check notice periods for models.