spring-projects / spring-projects/spring-ai

docs: PZERO OpenAI-compatible chat.base-url example

Open Beginner friendly
#6,873 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

status: waiting-for-triage
Dominant language
Java
Stars
9.5k
Forks
2.9k
Avg merge
1d 7h
Merged PRs (30d)
6

Description

Please do a quick search on GitHub issues first, the feature you are about to request might have already been requested.

Expected Behavior

A named PZERO row on the OpenAI Chat docs (https://docs.spring.io/spring-ai/reference/api/chat/openai-chat.html), same shape as the DeepSeek / vLLM custom base-url samples. No first-party PzeroChatModel required.

Chat-only properties so embeddings stay off this host:

spring.ai.openai.chat.base-url=https://api.pzero.studio/v1
spring.ai.openai.chat.api-key=${PZERO_API_KEY}
spring.ai.openai.chat.model=deepseek-v4-flash

spring.ai.openai.chat.base-url is the /v1 root. Do not paste /v1/chat/completions. Do not set spring.ai.openai.embedding.base-url to this host. Override the default gpt-5-mini model id.

Get a key: https://pzero.studio/agents (sign-in free; min top-up 1 USDC on Base; no starter credits). Live text ids: GET https://api.pzero.studio/v1/models (public, no key).

Smoke:

curl -sS -X POST "https://api.pzero.studio/v1/chat/completions" \
  -H "Authorization: Bearer $PZERO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"Hello from PZERO"}],"stream":false}'

Users who find this issue can convert today even if the docs PR is not merged.

Current Behavior

Spring AI already talks to OpenAI-compatible hosts via spring.ai.openai.chat.base-url. Search for pzero returned none. People looking for prepaid, privacy-first inference still have to guess the host, key format, and that catalog ids are not gpt-5-mini.

I am not asking for a bundled PZERO starter. The existing OpenAI chat auto-config is the seam.

Context

Every AI Credit is at least 20% off $1 list. Usage is paid. Do not start implementation on my behalf until the board says Ready; the snippet is for users today. Keep embeddings, image, audio, and moderation off this host.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start at the OpenAI Chat documentation page and compare the existing DeepSeek and vLLM custom base-url samples. Add a named PZERO example using the supplied chat-only properties and verify that the /v1 root, model override, API-key placeholder, and embedding exclusion are represented accurately.

Written by the indexing model from the issue text.

Assessment

Tech stack
java, spring
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
82/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.