IsraelGPT API Docs Get an API key

FAQ

Common questions about the public API.

Is the API free?

Yes. Sign in, make a key on the dashboard, 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 call it from a web page or a mobile app?

Not directly. There's no CORS, so browsers refuse, and a key inside a page or an app people download can be copied by anyone. Call the API from your own server, and have the page or app talk to that. See Authentication.

How do I see what my key has been used for?

Open the key on the dashboard. Its request log shows each request for 30 days: when, the result, the model and persona, tokens, how long it took, the app (from its User-Agent) and the network it came from. Never what was said, and never the address. See Authentication.

Why does the answer say unverified_replies?

Some assistant messages came back without the sig their reply had, or changed. They still reach the model, but as quotes from your app rather than its own words. Keep each reply's sig and send it back with it. See API Reference.

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

Yes — anywhere that can run a persistent Python process (a VPS or any long-running host) works. It just can't run on serverless hosting, 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 on the dashboard: it stops on its very next request. Then make a new one. The key's request log shows which networks and apps used 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 answer, and the key's request log on the dashboard. If something else is using the key (another copy of your app, a leak, a loop that retries too fast), the log shows it. Your account's keys also share one allowance. 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?

The newest message and the reply are kept in the chat log, encrypted, like the web chat's, and read only if something needs looking into. The request log you see on the dashboard has no text in it, and goes after 30 days. See the Privacy Policy for the details.

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.