Errors
ShareKiteRouter returns JSON errors for gateway-level failures. Upstream provider errors can also be forwarded with gateway headers attached.
Error Shape
1{ 2 "error": { 3 "message": "Model 'unknown-model' not found or no active providers available", 4 "type": "invalid_request_error", 5 "code": "model_not_found" 6 } 7}
Error Reference
| Status | Meaning | Typical fix |
|---|---|---|
400 | Invalid JSON or missing required field | Check request body and include model. |
401 | Missing or invalid API key | Use Authorization: Bearer kr-.... |
402 | Insufficient credits | Add credits in the dashboard. |
403 | Model is coming soon or not available | Choose an active model. |
404 | Model has no active provider routes | Check the model ID or admin provider mappings. |
429 | Rate limited | Retry with backoff. |
5xx | Gateway or upstream provider failure | Retry or contact support with X-Request-Id. |
Error Handling
1import OpenAI from 'openai'
2
3const client = new OpenAI({
4 baseURL: 'https://kiterouter.com/api/v1',
5 apiKey: process.env.KITEROUTER_API_KEY,
6})
7
8try {
9 const response = await client.chat.completions.create({
10 model: 'gpt-4o-mini',
11 messages: [{ role: 'user', content: 'Hello!' }],
12 })
13 console.log(response.choices[0].message.content)
14} catch (error) {
15 if (error.status === 402) {
16 console.error('Insufficient credits. Please top up.')
17 } else if (error.status === 429) {
18 console.error('Rate limited. Retry later.')
19 } else {
20 console.error('API error:', error.message)
21 }
22}