Skip to content

Quickstart ​

Make your first request in under five minutes.

1. Create an account and a key ​

Sign up at usefully.info and create an organization. Your first organization gets $1 of free credit. Open API keys → Create key and copy the key. It's shown once.

bash
export USEFULLY_API_KEY="uf_live_..."

2. Make a request ​

bash
curl https://api.usefully.info/v1/chat/completions \
  -H "Authorization: Bearer $USEFULLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "anthropic/claude-sonnet-5-5", "messages": [{"role": "user", "content": "Say hello"}]}'
ts
// npm install usefully
import Usefully from "usefully";

const client = new Usefully();
const reply = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-5-5",
  messages: [{ role: "user", content: "Say hello" }],
});
console.log(reply.choices[0]?.message.content);
python
# pip install usefully
from usefully import Usefully

client = Usefully()
reply = client.chat.completions.create(
    model="anthropic/claude-sonnet-5-5",
    messages=[{"role": "user", "content": "Say hello"}],
)
print(reply.choices[0].message.content)
ts
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.usefully.info/v1", apiKey: process.env.USEFULLY_API_KEY });
const reply = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-5-5", // any model in the catalog
  messages: [{ role: "user", content: "Say hello" }],
});

The response is an OpenAI chat completion. Three response headers tell you what happened:

HeaderMeaning
x-usefully-providerThe provider that served the request
x-usefully-attemptsHow many providers were tried (above 1 means a fallback served it)
x-request-idQuote this when contacting support

3. See it in the dashboard ​

Logs shows the request with its cost, tokens, latency and provider. Usage charts spend by day, model, capability and key.

Next ​