Common issues

When to use this page

Use this page when connecting a new client or agent fails.

401 Missing API key

Your request did not include a key in a supported header. Add:

Authorization: Bearer qf_your_key_here

403 permission_denied

The key exists but does not have OpenAI permission. Ask an admin to update the key.

Models endpoint works but responses fail

Check:

• The request body is valid JSON.
• The model id is supported by your package.
• The key has OpenAI permission.
• The endpoint is /openai/v1/responses, not /v1/responses.

Agent loses cache benefits

Set a stable x-session-id, session_id, conversation_id, or prompt_cache_key.

Old development key fails on production

Use a production-issued key with https://api.quotaflow.ai. Development keys are not automatically valid in production.