{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "shadowsafin-synapass--one-endpoint-for-many-ai-providers",
 "repo": "ShadowSafin/Synapass",
 "repo_url": "https://github.com/ShadowSafin/Synapass",
 "repo_slug": "shadowsafin-synapass",
 "title": "Send all app AI calls through one OpenAI-style endpoint",
 "page_title": "How to send all app AI calls through one OpenAI-style endpoint with Synapass",
 "summary": "Point existing OpenAI SDK code at one gateway that routes to several providers with failover.",
 "who": "A developer whose services each call a different AI provider with separate error handling and routing code.",
 "problem": "Each service carries its own provider integration, so failures and model choices are handled inconsistently and one upstream outage can stop the app.",
 "outcome": "Applications call one OpenAI-compatible URL, and the gateway picks the provider, fails over when needed, and reports which provider answered.",
 "steps": [
  "Run `./scripts/deploy.sh` from the cloned repo root, or the one-line installer for your OS from the README.",
  "Add a provider key such as OPENAI_API_KEY to `.env`, then run `./scripts/deploy.sh` again.",
  "Create a tenant key with a POST to /admin/v1/keys using the admin key, as shown in the README example request.",
  "Send a chat request to `curl -s $GATEWAY/v1/chat/completions` with the tenant key as the Bearer token.",
  "Read the `synapass` block in the response to confirm the answering provider and whether fallback_used is true."
 ],
 "agent_prompt": "Using the ShadowSafin/Synapass repo, deploy the stack with ./scripts/deploy.sh, mint a tenant key, and send one chat completion to /v1/chat/completions for the model <model_name>. Report the synapass.provider and synapass.fallback_used values. Verify that the HTTP status is 200 and the response contains a choices array.",
 "agents": [
  "any"
 ],
 "difficulty": "Intermediate",
 "time": "30 minutes",
 "basis": "readme",
 "caveat": "The README says the stack boots without a provider key and reports providers as unconfigured until one is added, so inference calls will fail until you add a key.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "go",
 "requirements": [
  "Docker with Docker Compose, curl, and jq, or Go and Make for the native build",
  "At least one provider API key such as OPENAI_API_KEY or ANTHROPIC_API_KEY in .env",
  "A host with ports 8080 and 3000 free, or a changed GATEWAY_PORT"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "credentials",
   "notice": "The admin key and tenant keys grant access to every provider you configure, so store them in `.env` or a secret manager and never commit them."
  }
 ],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/shadowsafin-synapass/one-endpoint-for-many-ai-providers/",
 "md": "https://dedupedai.com/use-cases/shadowsafin-synapass/one-endpoint-for-many-ai-providers/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/shadowsafin-synapass--one-endpoint-for-many-ai-providers.json",
 "api_version": "v1"
}