Paste one AI API error, get the next fix
causely ranks likely OpenAI and Anthropic causes, cites the vendor docs, and returns a safe Python or TypeScript patch to try.
Error log
sample inputOpenAI RateLimitError: 429 rate_limit_exceeded endpoint=responses.create request_id=req_oa_rate retry_after_ms=900 burst=41 requests in 9s
Next step: Reduce burst concurrency, then retry with capped exponential backoff and jitter.
Doc: OpenAI rate limitsasync function withOpenAIBackoff<T>(call: () => Promise<T>): Promise<T> {
let delayMs = 500;
for (let attempt = 0; attempt < 5; attempt += 1) {
try {
return await call();
} catch (error: any) {
if (error?.status !== 429 && error?.name !== "RateLimitError") throw error;
await new Promise((resolve) => setTimeout(resolve, delayMs + Math.random() * delayMs));
delayMs = Math.min(delayMs * 2, 8000);
}
}
throw new Error("OpenAI rate limit persisted after capped retries");
}Incidents need a next action.
Logs show symptoms; causely ranks the safer move.
Ranked hypotheses, not oracles
One ranked fix, with the clue attached.
Probability, evidence, and patch stay in one view.
#1 likely cause
Acceleration window exceeded
Confirm account health, then cap concurrency and add jitter.
Trace clues
- Model switch preceded the burst
- 38 requests landed in 7 seconds
- Retry loop has no jitter
Hypothesis only. Engineer approves the patch.
const delay = backoff({
attempt,
min: 500,
factor: 2,
jitter: true,
});
await sleep(delay);Narrow on purpose
Narrow scope earns trust.
Only trace-backed failures enter the ranking.
Supported first
429s, 529s, quota, request shape, model/version, timeouts, 500s
Not promised
guaranteed root cause, observability, one-click repair
Corpus validation
The prototype records every top suggestion.
Each labeled log is replayed through the same ranker used by the paste flow.
9/9
top-1 useful
ranked first on the labeled corpus
9
failure classes
rate, quota, shape, model, timeout, 500, 529
2
providers
OpenAI and Anthropic covered
100%
usefulness rate
case-by-case expected cause match
oa-429-burst
openai
OpenAI rate limit window exceeded
Expected: OpenAI rate limit window exceeded
oa-quota-billing
openai
OpenAI quota or billing cap reached
Expected: OpenAI quota or billing cap reached
oa-invalid-param
openai
OpenAI request shape is invalid
Expected: OpenAI request shape is invalid
oa-model-missing
openai
OpenAI model name or endpoint mismatch
Expected: OpenAI model name or endpoint mismatch
oa-timeout
openai
OpenAI request timed out before completion
Expected: OpenAI request timed out before completion
oa-500-provider
openai
OpenAI 500-class provider error
Expected: OpenAI 500-class provider error
anthropic-529-overload
anthropic
Anthropic API overloaded
Expected: Anthropic API overloaded
anthropic-accel-429
anthropic
Anthropic rate or acceleration limit hit
Expected: Anthropic rate or acceleration limit hit
anthropic-prefill-400
anthropic
Anthropic request body is invalid
Expected: Anthropic request body is invalid
Founding pilot
Bring incidents, label usefulness.
Access stays invite-only until real teams prove the ranking helps.
- 01real OpenAI/Anthropic traces
- 02weekly incident review
- 03pilot terms with first teams
Specific about what it does not do.
The beta stays narrow enough to trust.
No. It returns ranked hypotheses; engineers own incidents.
Bring one failing AI API trace.
Join if your team can label whether the top suggestion helped.