Dify Integration

When to Use

Dify is a platform for building apps and orchestrating workflows and agents. Once you integrate Tokener CA into Dify, you can use platform models in chat apps, Workflows, Agents, and knowledge base pipelines.

If your Dify environment can access the plugin marketplace, install the Tokener CA plugin and use it directly; if you can't install plugins, integrate manually as an OpenAI-compatible provider instead.

Option 1: Install the Tokener CA Plugin (Recommended)

The Tokener CA plugin is already available in the Dify Marketplace:

• Open the Tokener CA plugin marketplace page

The Tokener CA plugin integrates into Dify as a model provider. After installing it, you can directly select a preset Tokener CA chat model and continue to use Dify's streaming output, tool calling, and Workflow / Agent orchestration capabilities.

Install the Plugin

1. Open your Dify workspace.
2. Go to Plugins or Marketplace and search for Skypool; you can also open the marketplace link above directly.
3. Click Install and choose the workspace to install to.
4. After installation, find Skypool on Dify's model provider or plugin configuration page.

Configure Credentials

Only change the Endpoint URL to the corresponding Tokener CA-compatible address if you're using a private deployment or test environment. Do not enter the full /chat/completions path.

Use It in a Dify App

1. Create or open a Chat App, Workflow, or Agent.
2. In the model picker, select a model under the Skypool provider.
3. After saving the app configuration, send a simple message to verify the model responds normally.

For your first test, we recommend creating the simplest possible Chat App and sending:

In one sentence, confirm that this app has been successfully integrated via the Tokener CA plugin.

Option 2: Manual Integration as an OpenAI-Compatible Provider

This path is for cases where you can't install the plugin for now, need to configure it manually on Dify's model provider page, or need compatibility with older versions of Dify.

We recommend configuring Tokener CA as an OpenAI-compatible provider in Dify:

Add the Model Provider in Dify

Open your Dify workspace and configure it as follows:

1. Open Settings.
2. Go to Model Providers.
3. Select OpenAI, or OpenAI-API-compatible if your version offers it.
4. Add a new set of credentials.
5. Enter your Consumer API Key for the API Key.
6. Enter https://a.skypool.xyz/v1 for Custom Base URL or API Base.
7. Save and test the connection.

Dify validates the credentials when you save. If validation fails, first run the curl at the end of this article with the same key and model to confirm that the platform-side call already works.

Add or Select a Model

If the Tokener CA model ID isn't in Dify's model list, you'll need to add a custom model manually.

Suggested fields:

After adding it, select the model in your app's model picker.

Use It in an App

Create or open a Dify App and select the Tokener CA model you just integrated in the model configuration. We recommend testing with the simplest Chat App first:

In one sentence, confirm that this app has been integrated with Tokener CA.

Once the test passes, use it in Workflows, Agents, tool calling, or knowledge base Q&A.

Verify the API

If Dify configuration fails, first verify the same key and model from a terminal:

curl -X POST "https://a.skypool.xyz/v1/chat/completions" \  -H "Authorization: Bearer <consumer_api_key>" \  -H "Content-Type: application/json" \  --data-raw '{    "model": "gemma4:26b",    "messages": [      {        "role": "user",        "content": "Return a short message confirming the integration works."      }    ],    "max_tokens": 64,    "stream": false  }'

Troubleshooting Checklist

References

• Dify website
• Dify Model Providers docs