Description
Bestony AI Provider for PPIO adds PPIO as an OpenAI-compatible provider.
- Models are discovered from
GET /openai/v1/models. - Text and chat history use
POST /openai/v1/chat/completions. - Catalogued models support vision input, function calling, JSON Schema, and JSON Object output.
reasoning_content, token usage, tool calls, and image content use the PHP AI Client parser.- Unknown models stay visible as text-only models. Embedding, reranking, ASR, TTS, audio, and video
models are visible without an unsupported chat capability.
Image generation, video or audio output, embeddings, and reranking are documented non-goals because
this provider implements only PPIO’s model-list and chat-completion endpoints.
Configuration
Optional values can be set as environment variables or PHP constants:
PPIO_DEFAULT_MODEL— preferred text and vision model. Default:deepseek/deepseek-v4-flash.PPIO_BASE_URL— API base URL. Default:https://api.ppio.com/openai/v1.PPIO_STRUCTURED_OUTPUT—json_schema(default),json_object, ornone.PPIO_MODEL_INPUT_MODALITIES— includeimagein a comma-separated list to declare vision for all
chat models, for exampletext,image.PPIO_REQUEST_TIMEOUT— request timeout in seconds. Default:120.PPIO_CONNECT_TIMEOUT— connection timeout in seconds. Default:10.PPIO_SEPARATE_REASONING— optional boolean override forseparate_reasoning.PPIO_ENABLE_THINKING— optional boolean override forenable_thinking.
The automatic reasoning flags are enabled only for the documented models
deepseek/deepseek-r1-turbo and deepseek/deepseek-v3.2-exp. The structured JSON Schema request is
wrapped as json_schema.name=ppio_response; none removes response_format entirely.
External services
This plugin connects to the PPIO API to provide PPIO models to the WordPress AI Client, so sites can
use PPIO for text and vision features.
Requests go to the configured PPIO base URL. Chat requests can contain prompts, history, tool
definitions, JSON schemas, and images supplied by the calling plugin. The AI Client sends the PPIO
API key as a Bearer credential. No request is sent until model discovery or generation is requested.
This service is provided by PPIO:
- Platform and API key documentation: https://ppio.com/docs/support/api-key
- Terms of service: https://ppio.com/legal/terms-of-service
- Privacy policy: https://ppio.com/legal/privacy-policy
Installation
- Upload the plugin to
/wp-content/plugins/bestony-ai-provider-for-ppio/. - Activate it in the Plugins screen.
- Open Settings Connectors, choose PPIO, and add an API key.
The API key is handled by the AI Client registry. This plugin does not read the Connectors option
directly.
FAQ
-
Does this plugin need a separate settings page?
-
No. The AI Client’s Settings Connectors screen owns the credential. Optional provider behavior uses
environment variables or PHP constants. -
Why is a newly listed model text-only?
-
PPIO’s model list does not publish capabilities. Unknown IDs remain usable for text while the static
catalog is updated for vision, tools, and structured output. -
Can this plugin generate images or embeddings?
-
No. Those PPIO APIs are outside this provider’s chat-completion scope.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Bestony AI Provider for PPIO” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Bestony AI Provider for PPIO” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.1
- Rename plugin name and slug to Bestony AI Provider for PPIO.
1.0.0
- Initial release for PPIO’s OpenAI-compatible model-list and chat-completion APIs.
- Added text, vision, function calling, structured output, reasoning flags, token usage, and request
timeouts. - Added a static capability catalog with safe text-only fallback for unknown models.