CherryIN Docs

What is Dify?

Dify is a popular AI application orchestration platform for building chatbots, workflows, agents, and API-based apps.

You can connect CherryIN through Dify's OpenAI model provider.

Before you start

Please make sure:

You already have a CherryIN API key
You have admin or owner access in your Dify workspace
You know which model ID you want to use, such as anthropic/claude-sonnet-4.5

Permission requirement

According to Dify's official docs, only workspace admins and owners can configure model providers.

Setup Steps

Open Model Providers

In your Dify workspace, go to:

Settings -> Model Providers

Recent Dify versions manage model providers as plugins. If the OpenAI provider isn't enabled in your workspace yet, install or enable it first.

Configure the OpenAI provider

Find the OpenAI provider and add a credential set with these values:

Field	Value
`API Key`	Your CherryIN API key
`Custom Base URL`	`https://open.cherryin.net/v1`
`Organization ID`	Leave blank if not needed

After that, test and save the credential.

Why use OpenAI here?

Dify's official docs note that the OpenAI provider supports a custom Base URL, which makes it suitable for OpenAI-compatible services like CherryIN.

Select or add a model

Once the credential is saved, choose the model you want to use.

If the model doesn't appear in the default list, try adding it manually as a custom model using the full model ID, for example:

anthropic/claude-sonnet-4.5
anthropic/claude-opus-4
google/gemini-2.5-flash

Use it in an app or workflow

Create a Chatbot, Workflow, or Agent, then choose the model you just configured in the model selector.

For a quick test, try:

Introduce CherryIN in one sentence.

If the app responds normally, the integration is working.

Recommended usage

Chat assistants: start with anthropic/claude-sonnet-4.5
Complex analysis: try anthropic/claude-opus-4
Cost-sensitive, frequent runs: try google/gemini-2.5-flash

FAQ

Credential validation fails

Check these first:

The API Key is correct
The Custom Base URL is exactly https://open.cherryin.net/v1
Your account balance and key status are valid

My model doesn't appear in the list

This is common in Dify. Try the following:

Add the model manually as a custom model
Use the full model ID
Verify connectivity with a known-good model first

Why can't I see the model provider settings?

That is usually a Dify permission restriction. Ask your workspace admin or owner to configure the provider.

Next steps

Want the universal setup rules first? See OpenAI-Compatible Setup Guide
Want workflow automation examples next? See n8n Setup Guide

Dify Setup Guide