Skip to content

docs(guide): document Opper as an openai_compatible provider example - #328

Open
Felix (Felixkw12) wants to merge 1 commit into
microsoft:mainfrom
Felixkw12:docs/opper-openai-compatible
Open

Felix (Felixkw12) wants to merge 1 commit into
microsoft:mainfrom
Felixkw12:docs/opper-openai-compatible

Conversation

@Felixkw12

Copy link
Copy Markdown

Summary

Adds Opper as an example provider for the existing openai_compatible backend, alongside the Novita AI example (#214). Opper is an EU-hosted AI gateway with an OpenAI-compatible endpoint (700+ models from 50+ providers behind one key), so no new backend module or registration is needed.

Changes

  • docs/guide/new-backend.md: an Opper row in the provider examples table
  • .env.example: a commented Opper block under the OPENAI_COMPATIBLE_* section

The backend calls <base_url>/chat/completions through the openai SDK, so https://api.opper.ai/v3/compat maps to Opper's chat completions endpoint. The example model claude-sonnet-4-6 is a pool name from Opper's public catalogue (GET https://api.opper.ai/v3/models); a provider/model id such as anthropic/claude-sonnet-4-6 pins one route. Keys: https://platform.opper.ai

Verification

Docs only. I did not run pytest or mkdocs build --strict locally.

Disclosure: Opper is my startup.

Opper (https://opper.ai) is an EU-hosted gateway with an
OpenAI-compatible endpoint, so it works with the existing
openai_compatible backend and needs no new backend module or
registration. Same shape as the Novita AI example (microsoft#214):

- docs/guide/new-backend.md: an Opper row in the provider examples table
- .env.example: a commented Opper block under the OPENAI_COMPATIBLE_*
  section

The example model claude-sonnet-4-6 is a pool name from Opper's public
catalogue (GET https://api.opper.ai/v3/models). Tests and mkdocs were
not run locally.

Disclosure: Opper is my startup.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@Felixkw12

Copy link
Copy Markdown
Author

@microsoft-github-policy-service agree company="Opper Technology AB"

@Yif-Yang

Copy link
Copy Markdown
Contributor

The five-line example is consistent with the existing openai_compatible configuration shape, and the strict documentation build passes. The startup disclosure and stated local-test limits are clear.

The remaining question is incremental project value. The guide already documents provider base URLs, API keys, model IDs and role overrides, including gateways serving multiple model families. This adds another provider entry without establishing a distinct SkillOpt setup problem or interoperability requirement. Applying the same current criterion used for #308, I would leave this outside the maintenance merge set. There is no request for a live paid-service test or a larger rewrite to expand the PR.

Review baseline: 1a44050fc53a. The PR remains open; no merge was performed.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants