> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Dify to APIONE

> Add models to your workspace and use them in chatbots and workflows.

Dify configures providers at workspace level. After adding APIONE, select its model explicitly in the application or LLM node.

## Add a model

1. Open **Settings → Model Provider** in your workspace.
2. Find **OpenAI-API-compatible**. If necessary, install it through Dify's official plugin marketplace.
3. Click **Add Model** and choose LLM.
4. Enter an APIONE model ID supporting Chat Completions.
5. Enter the APIONE key and set API Endpoint / Base URL to [https://api.apione.ai/v1](https://api.apione.ai/v1).
6. Set context and output limits according to the model, then save.

If a field explicitly requires a complete endpoint, use [https://api.apione.ai/v1/chat/completions](https://api.apione.ai/v1/chat/completions) and avoid duplicated paths.

![Add an OpenAI-compatible APIONE model in Dify; use the actual model ID and limits.](https://mintcdn.com/apione/bPc0c0uWIOMLKxcC/images/integrations/screenshots/dify-apione-add-model-v2.png?fit=max\&auto=format\&n=bPc0c0uWIOMLKxcC\&q=85\&s=49da623bcf7877c0b03f5a62790b55db)

Add an OpenAI-compatible APIONE model in Dify; use the actual model ID and limits.

## Verify an application

Create a Chatbot or open an LLM workflow node and select the new model. Run a minimal text-only flow before adding knowledge bases, tools, or multimodal input.

## Common problems

* **Validation fails on save:** check outbound access from the Dify backend or plugin runtime, the key, and the model ID.
* **An app still uses the old model:** select the model again in the LLM node and save the app.
* **Knowledge retrieval fails:** embeddings, reranking, and chat are separate capabilities requiring separate configuration.
* **Plugin or self-hosted differences:** use the field definitions for your Dify and provider-plugin versions.

***

[Integration directory](https://apione.ai/docs/en/guides/clients.md) · [Choose a model](https://apione.ai/docs/en/models/catalog.md) · [Troubleshooting](https://apione.ai/docs/en/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.