docs: show OpenAI-compatible gateway setup - #1022
Open
cerebrixos wants to merge 1 commit into
Open
Conversation
Author
|
Hello team @pocketarc . Please do consider this PR for merge. So much appreciate in advance :) |
wishborn
added a commit
to Particle-Academy/prism
that referenced
this pull request
Aug 12, 2026
Inspired by prism-php#1022 by @cerebrixos, rewritten rather than absorbed. The gap that PR identified is real: `url` appears in the config block but nothing on the page says it can point somewhere other than OpenAI, so the single most common deployment question — "can I put this behind vLLM / a gateway / Azure" — is unanswered. The upstream PR answers it with one vendor's product as the worked example, including their hostname, their env var name, and a paragraph of their positioning. Merging that would put a supplier advertisement in our provider docs and date the page to that supplier. So this documents the capability instead: a neutral placeholder URL, self-hosted runtimes and gateways named as categories, and no vendor endorsed. Also adds what a user actually gets wrong here and the upstream text omits: "OpenAI-compatible" rarely covers the whole surface, so an unsupported feature fails at the endpoint rather than in Prism; and model names drive capability inference, so a llama model behind the OpenAI provider is not treated as structured-output capable. Closes with a pointer to the dedicated providers, which map their APIs' real quirks.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Why
We are a Rails and AI infrastructure team using Prism with Tuning Engines. Since Prism already supports configurable provider URLs, this gives Laravel/PHP teams a simple setup path for governed model access, policy checks, traces, audit logs, and usage/cost reporting without changing their Prism application logic. It would mean a lot to us if you are open to including it, and I am happy to revise the copy to fit the docs style.
Validation