AI Services

Doco Translate supports a wide range of AI and large language model (LLM) services for high-quality, context-aware translations. These services require an API key and typically produce better results than basic translation engines.

Supported AI Services

Click the service name to visit the provider's website and get an API key. You can also find these links in Settings → Services within the app via the Apply for API Key button.

Configuring an AI Service

Step 1: Get an API Key

Visit the provider's website using the links above to create an account and generate an API key.

Step 2: Enter the API Key in Doco Translate

1. Go to Settings → Services.
2. Select the AI service from the list on the left.
3. Paste your API key in the API Key field.
4. The key icon next to the service name changes from empty to filled, indicating the key is configured.

Step 3: Select a Model

Each AI service offers multiple models with different capabilities:

1. In the service settings, find the Model dropdown.
2. Select the model you want to use.
3. Models marked as (Free) can be used without charges from the provider.

Tip: Smaller/faster models (e.g., flash, mini, haiku) are cheaper and faster but may produce slightly lower quality. Larger models (e.g., pro, opus) produce the best results but cost more.

Step 4: Verify

Click Verify service to test the connection with a sample translation.

Managing Models

Fetching the Model List

Some services support fetching the latest available models directly from the provider:

1. Click Fetch model list in the service settings.
2. The app connects to the provider and retrieves available models.
3. New models not already in your list are presented for selection.
4. Select the models you want to add and click Add.

Adding Custom Models

You can manually add models that aren't in the preset list:

1. Click Add Model in the service settings.
2. Enter the exact model identifier (e.g., gpt-4o-2024-08-06).
3. Optionally mark it as a free model.
4. Click Add.

Deleting Custom Models

To remove a manually added model:

1. Select the model in the model dropdown.
2. Click Delete next to the model selector.
3. Confirm the deletion.

Note: You can only delete custom (manually added) models. Preset models that ship with Doco Translate cannot be deleted.

Custom API Host

For advanced users, you can customize the API host for any service:

1. In the service settings, find the API Host field.
2. Enter the custom endpoint URL.
3. The preview below shows the full request URL (host + path).

This is useful for:

• Using API proxies or mirrors
• Enterprise deployments with custom endpoints
• Self-hosted API-compatible services

Click the gear icon next to the API Host field to access advanced settings:

• API Path — The request path (e.g., /v1/chat/completions)
• Request Body — Additional JSON fields merged into each request
• Request Headers — Additional HTTP headers

Restore Defaults

If you've customized a service's host, path, or other settings and want to revert:

1. Click Restore Default at the bottom of the service settings.
2. The host, path, request body, and headers are reset to the built-in defaults.

Your API key and model selection are preserved.

Previous: Built-in Services · Next: Local LLM Services