# Zactonz AI Connector for DeepSeek: Installation & setup

> DeepSeek connector for the WordPress AI Client. A very long context window, vision on the Flash model, and thinking mode you can turn up, down or off.

Page: https://developers.zactonz.com/wordpress/plugins/zactonz-ai-connector-for-deepseek/installation/

Complete documentation for this product: https://developers.zactonz.com/wordpress/plugins/zactonz-ai-connector-for-deepseek.md

## Install the plugin

From the dashboard, go to **Plugins › Add New**, search for **Zactonz AI Connector for DeepSeek** and click **Install Now**, then **Activate**. WordPress also links here directly from **Settings › Connectors** when it needs a connector that is not installed yet.

With WP-CLI:

```bash
wp plugin install zactonz-ai-connector-for-deepseek --activate
```

To install manually, download the zip from the Download button above, upload the folder to `/wp-content/plugins/zactonz-ai-connector-for-deepseek/` and activate it from the **Plugins** menu.

## Connect to DeepSeek

1. Create an API key on the [DeepSeek open platform](https://platform.deepseek.com/api_keys).
2. Go to **Settings › Connectors** and paste the key into the DeepSeek connector.
3. Go to **Settings › DeepSeek** to review the discovered models and choose a default model per capability, a thinking level for the default text model, and the request timeout.

The key is stored in the option WordPress registers for the connector, so the Connectors screen and the connector's own settings screen always show the same credential.

![The DeepSeek connector on the WordPress Connectors screen](https://developers.zactonz.com/assets/images/wordpress/zactonz-ai-connector-for-deepseek-connector.webp)

*Settings › Connectors: the DeepSeek connector with its key saved, as WordPress shows it beside its own connectors.*

## Keep the key out of the database

Define `DEEPSEEK_API_KEY` in `wp-config.php`, or set an environment variable of the same name. When either is present the connector uses it, the settings field is disabled, and nothing is written to the database.

```php
define( 'DEEPSEEK_API_KEY', 'sk-…' );
```

## Thinking mode and timeouts

DeepSeek's models think by default. The thinking level applies to the default text model and maps onto DeepSeek's own effort levels, with **No reasoning** turning thinking off. A thinking reply takes longer to arrive, so the connector's default request timeout is generous; raise it further under **Settings › DeepSeek** if you ask for long answers at the highest level.

## Use a proxy or gateway

**Settings › DeepSeek** has an API base URL field. Leave it empty to use `https://api.deepseek.com/v1`, or point it at a gateway that speaks the same API.

AI features reach the gateway through the WordPress AI Client, which sends every request with `wp_safe_remote_request()`. WordPress refuses such requests to loopback and private network addresses and to any port other than 80, 443 and 8080, so a gateway on a LAN address or a non-standard port will not work unless the site allows that host with the `http_request_host_is_external` filter. The connector's own connection check and Site Health test do not apply that restriction, so with such a gateway they can report a healthy connection while AI features still cannot reach it. Use a public hostname on a standard port, or add the filter.

## Check the connection

**Tools › Site Health** includes a connectivity test for DeepSeek, which runs in the background so it never holds the screen open. **Settings › DeepSeek** has a diagnostics button that reports the endpoint, HTTP status, latency, the number of discovered models, any configured defaults missing from the current catalogue, and the AI Client version. The key never appears in the report.
