Appearance
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:
| Header | Meaning |
|---|---|
x-usefully-provider | The provider that served the request |
x-usefully-attempts | How many providers were tried (above 1 means a fallback served it) |
x-request-id | Quote 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.