Troubleshooting

curl "https://api.llm.kiwi/v1/models" \
  -H "Authorization: Bearer $LLM_KIWI_API_KEY"

​

Quick diagnosis

​

401: unauthorized

Authorization: Bearer sk_kiwi_...

• There is one space after Bearer.
• The key was copied completely with no quotes or trailing whitespace.
• The key has not been revoked.
• Your environment variable is available to the running process.

test -n "$LLM_KIWI_API_KEY" && echo "Key is set" || echo "Key is missing"

if ($env:LLM_KIWI_API_KEY) { "Key is set" } else { "Key is missing" }

​

400: bad request

{
  "model": "auto",
  "messages": [
    {"role": "user", "content": "Hello!"}
  ]
}

• Single quotes or missing commas in JSON
• messages sent as an object instead of an array
• Missing role or content
• Unsupported model value
• Sending a JSON string inside another JSON object
• Forgetting Content-Type: application/json

​

404: not found

https://api.llm.kiwi/v1

client = OpenAI(base_url="https://api.llm.kiwi/v1", api_key=key)

https://api.llm.kiwi/v1/chat/completions

​

429: rate limited

• Respect Retry-After when present.
• Use exponential backoff and a small random delay.
• Limit concurrency in loops and background jobs.
• Stop after a small number of failed attempts.

​

Timeout or connection failure

1. Confirm the URL begins with https://.
2. Run the model-list cURL check from the same machine.
3. Check whether a proxy, VPN, firewall, or hosting provider blocks outbound HTTPS.
4. Set a reasonable client timeout such as 30 seconds.
5. Retry temporary failures a limited number of times.

​

SDK uses the wrong service

client = OpenAI(
    base_url="https://api.llm.kiwi/v1",
    api_key=os.environ["LLM_KIWI_API_KEY"],
)

const client = new OpenAI({
  baseURL: "https://api.llm.kiwi/v1",
  apiKey: process.env.LLM_KIWI_API_KEY,
});

​

Streaming shows nothing

1. The request includes stream: true.
2. Your code iterates over chunks instead of waiting for a normal completion object.
3. Your terminal or web server flushes output instead of buffering it.

​

Before contacting support

• Approximate time of the failed request and your timezone
• HTTP status code
• Error type, code, and message
• Endpoint and SDK name/version
• A minimal request with private data removed