FAQ

Common questions about the public API.

Is the API free?

Yes — sign in, create a key, and you're on the free tier described in Rate Limits. There's no credit card and no separate paid tier right now.

Does it support streaming responses?

No, by design — see Architecture for why. You get one complete JSON response once generation finishes.

Can I run the Discord bot somewhere other than my own machine?

Yes — anywhere that can run a persistent Python process (a VPS, Railway, Fly.io, etc.) works. It just can't run on Vercel serverless, since a Discord bot needs a long-lived connection and serverless functions are short-lived. See Discord Bot.

My API key leaked. What do I do?

Revoke it immediately from the dashboard — revocation is effective on the very next request, and create a new one to replace it. See Authentication.

Why does the persona reply with a strong, biased tone?

IsraelGPT is a satirical, deliberately pro-Israel-biased chatbot by design — that's the product, not a misconfiguration on your end. See the Terms of Service for the full disclaimer.

Can multiple people/projects share one API key?

Not recommended, and against the Terms of Service's prohibition on reselling or sublicensing access. Create a separate key per project instead — it's free and takes seconds, and keeps usage/rate limits easy to reason about per integration.

I'm getting 429s constantly even with light traffic. What's wrong?

Check X-RateLimit-Remaining and X-RateLimit-Remaining-Day on a normal response — if either is unexpectedly low, something else using the same key (another instance of your app, a leaked key, a bug that retries in a tight loop) is likely consuming the budget. See Rate Limits.

Can I get higher rate limits?

There's no self-serve option yet. Reach out via the contact address in the Terms of Service if you have a legitimate production need.

Is the API stable? Will parameters or the response shape change?

The endpoint is versioned (/api/v1/) specifically so it can evolve without breaking existing integrations — a future breaking change would land under a new version path, not silently change /v1 underneath you.

What happens to my messages after a request?

Handled the same way as messages sent through the web chat — see the Privacy Policy, specifically the "Public API Usage Data" section, for exactly what's stored (request metadata, not a separate copy of your message content) and for how long.

Something's not covered here.

Check API Reference for the full technical contract, or reach out via the contact address in the Terms of Service.