Skip to main content

Connect an AI API

Before AI can translate products, articles, and page content, or use the built-in AI chat window, connect your own AI API in AllinCMS admin. This guide uses DeepSeek. Other providers work in the same way when they offer a compatible API.

Get an API key -> add it in AllinCMS admin -> select a Flash model -> save after the green check appears. Then you can use translations and the built-in AI chat window.

Overview​

1Sign in to DeepSeekOpen the developer platform
2Verify and top upYour account needs a balance
3Create and save a keyThe full key is shown once
4Configure and saveChoose Flash and wait for the green check

1. Get an API key from DeepSeek​

Open the DeepSeek developer platform sign-in page. You can sign in with a phone verification code or WeChat QR code.

DeepSeek developer platform sign-in page - enter a phone verification code or scan the WeChat QR code on the right

Verify your account and top up​

After signing in, select Top up in the left menu. If you see a verification reminder, complete it first, then return to top up. A small amount is enough for an initial test.

DeepSeek top-up page - use the left menu for Top up and API keys, complete verification, choose an amount and payment method

Create an API key​

Select API keys in the left menu, then select Create API key in the upper-right corner.

DeepSeek API keys page - select Create API key in the upper-right corner

The name is only for your own reference. Use any useful label, such as allincms-translation, then select Create.

Create DeepSeek API key dialog - enter any recognizable name and select Create

When the key is created, select Copy immediately. Save the full key in a password manager or another secure private location.

The full key is shown only once

After closing this dialog, DeepSeek will not show the full key again. If you lose it, delete the old key and create another one. Never send an API key to support staff, colleagues, or a chat window.

DeepSeek API key created dialog - select Copy to save the full key because it cannot be viewed again after closing

Your account now has a balance and an API key. Next, return to AllinCMS admin.

2. Configure AllinCMS admin​

Sign in to AllinCMS admin, then open Settings -> AI Configuration in the left menu. This AI configuration is used by the editor, content translation, and the built-in AI chat window, so finish it before using those features.

Updated AllinCMS admin AI configuration page - the API URL appears after selecting a provider; enter the key, load a model and save after the green check appears

Complete the fields in this order:

  1. Choose DeepSeek from the Provider menu. Choose the matching provider when using another AI service.
  2. The API URL appears automatically after selecting a provider. For DeepSeek it is https://api.deepseek.com/v1; normally, keep the prefilled address.
  3. Paste the complete key into API Key and wait for models to load automatically. If they do not appear, select Get models.
  4. Choose a Flash model from the available model list.
  5. When the green check appears next to the model, select Save configuration. The updated interface does not require a separate Test configuration button.
Not sure which API URL to enter?

Each AI provider has its own endpoint. Check the provider's official API documentation first. If it is still unclear, ask your current AI assistant or the provider's support: "What is this provider's OpenAI-compatible API endpoint?" Do not guess the address.

Do not choose Pro for routine translations

Use Flash first for multilingual translation, product copy, and article drafts. Pro is a higher-cost model and is normally unnecessary for this job.

3. Confirm translation is ready​

When the green check appears next to the model and you have saved the configuration, this setup step is complete. You can now use AI translation in products, articles, and pages. You can also send a message in the built-in AI chat window to confirm that it replies normally.

If models do not load automatically after entering your key, or the list stays empty after selecting Get models, check these items in order:

CheckWhat to do
API URLFor DeepSeek, use https://api.deepseek.com/v1 and include /v1.
API keyPaste the complete key again and make sure there are no extra spaces.
Balance and verificationReturn to DeepSeek and confirm account verification and an available balance.
Model statusRead any page messages. If models have not loaded or the green check is missing, correct the configuration, load models again, then save.

Common mistakes​

Common mistakeWhat to do instead
Sharing an API key in a screenshot or chatAn API key can incur charges. Enter it only in your own AllinCMS admin.
Closing the dialog before saving the keyCreate a new key and delete the old one when it is no longer used.
Choosing Pro by defaultStart with Flash for everyday translation to reduce cost and response time.
Saving before a model loads successfullyCheck the URL, key, or account balance, load models again and wait for the green check before saving.
Next

With AI connected, translate products, articles, and page content, or use the built-in AI chat window. When you are ready to translate the whole site, read Enable site languages. Check that source information and product specifications are accurate before translating them into additional languages.