---
title: Getting Started with Jodit Cloud
description: How to get an API key and set up Jodit Cloud editor on your website.
keywords: jodit cloud, getting started, api key, setup, cdn
---

# Getting Started

## Getting an API Key

1. Purchase a Jodit Cloud license in the [account dashboard](/jodit/pro/cab/). If you don't have a Cloud plan yet, you can [buy Jodit Cloud here](/jodit/pro/cab/buy/jodit-cloud/). It includes a **7-day free trial**.
2. After successful payment, open your order in the [account dashboard](/jodit/pro/cab/)
3. Click the **Add Cloud Key** button. A new API key will be created automatically
4. The key page will open on the **General** tab with your API key. In the **Security** tab, **Allowed Referrers** is already set to `localhost`, so you can start using the key in local development right away
5. To use the key on other domains, add them to **Security → Allowed Referrers**

> **Important:** API keys become active approximately **15 minutes** after purchase or generation. Allow this time before testing.

## 1. Include the script

```html
<script src="https://cloud.xdsoft.net/v4/jodit-pro/?key=YOUR_API_KEY"></script>
```

## 2. Initialize the editor

```html
<textarea id="editor">Hello world!</textarea>

<script>
	JoditLoader.ready().then(() => {
		const editor = Jodit.make('#editor', {
			// Options https://xdsoft.net/jodit/docs/options.html
		});
	});
</script>
```

The editor loads from the CDN with styles included.

## Full HTML Example

```html
<!DOCTYPE html>
<html lang="en">
	<head>
		<meta charset="UTF-8" />
		<title>Jodit Cloud Example</title>
		<!-- Loading Jodit Cloud with your API key -->
		<script src="https://cloud.xdsoft.net/v4/jodit-pro/?key=YOUR_API_KEY"></script>
	</head>
	<body>
		<textarea id="editor">Hello world!</textarea>

		<script>
			JoditLoader.ready().then(() => {
				const editor = Jodit.make('#editor', {
					// Your editor settings https://xdsoft.net/jodit/docs/options.html
				});
			});
		</script>
	</body>
</html>
```

## Using Cloud Services Without the Cloud Script

You don't need to load the editor from CDN to use Cloud-powered features. If you have a self-hosted Jodit PRO or OEM installation, you can still use your Cloud API key to enable the [AI Assistant](./ai-assistant.md) and [Translation](./translate.md) plugins.

Both plugins have built-in Cloud providers; pass your API key:

### AI Assistant

The `jodit-ai-adapter` provider handles all the streaming and authentication automatically:

```javascript
import { JoditPro } from 'jodit-pro';

const providerOptions =
	JoditPro.defaultOptions.aiAssistantPro.getAIProviderOptions(
		'jodit-ai-adapter',
		{
			url: 'https://cloud.xdsoft.net',
			apiKey: 'YOUR_CLOUD_API_KEY'
		}
	);

JoditPro.make('#editor', {
	aiAssistantPro: {
		...providerOptions,
		instructions: 'You are a helpful writing assistant.'
	}
});
```

### Translation

The `'cloud'` provider connects to the Cloud translation service:

```javascript
import { JoditPro } from 'jodit-pro';

JoditPro.make('#editor', {
	extraPlugins: ['translate'],
	translate: {
		provider: 'cloud',
		cloudProviderOptions: {
			key: 'YOUR_CLOUD_API_KEY'
		},
		defaultTargetLang: 'en'
	}
});
```

### Both Together

```javascript
import { JoditPro } from 'jodit-pro';

const aiProviderOptions =
	JoditPro.defaultOptions.aiAssistantPro.getAIProviderOptions(
		'jodit-ai-adapter',
		{
			url: 'https://cloud.xdsoft.net',
			apiKey: 'YOUR_CLOUD_API_KEY'
		}
	);

JoditPro.make('#editor', {
	aiAssistantPro: {
		...aiProviderOptions
	},
	extraPlugins: ['translate'],
	translate: {
		provider: 'cloud',
		cloudProviderOptions: {
			key: 'YOUR_CLOUD_API_KEY'
		},
		defaultTargetLang: 'en'
	}
});
```

For full configuration details, see:

- [AI Assistant](./ai-assistant.md): streaming, non-streaming, and custom provider setup
- [Translation](./translate.md): provider options and supported languages
