Using APIMart in Immersive Translate

​

Prerequisites

Before you begin, please ensure:

1. Immersive Translate Extension Installed
   Install Immersive Translate from:
   • Chrome Web Store
   • Edge Add-ons
   • Firefox Add-ons
   • Official Website
2. APIMart API Key Obtained
   Login to APIMart Console to get your API key (starts with sk-)

​

Step 1: Open Extension Settings

After installing the Immersive Translate extension:

1. Click the Immersive Translate icon in your browser toolbar
2. At the bottom of the popup panel, click the Settings button in the lower left corner
3. Enter the Immersive Translate settings page

​

Step 2: Configure Translation Service

​

2.1 Enter Translation Service Settings

On the settings page:

1. Find the “Translation Services” option in the left menu
2. Click to enter the translation service configuration page

​

2.2 Add Custom Translation Service

On the translation services list page:

1. Click the + Add Custom Translation Service button at the top
2. Fill in APIMart API information in the configuration form

​

2.3 Configure APIMart API Information

Fill in the following configuration information:

​

Step 3: Save and Select Translation Service

After completing the configuration:

1. Click the Save button at the bottom of the configuration page
2. Return to the extension panel, select APIMart from the Translation Service dropdown menu
3. You can select translation style (such as “General”) in AI Expert

​

Recommended Models

Different models are suitable for different translation scenarios: Available Models:

• gpt-5 - Latest model, highest translation quality ⭐ Recommended
• gpt-4o - High-quality translation, fast speed
• gpt-4o-mini - Cost-effective, suitable for large-scale translation 💰 Best Value
• claude-sonnet-4-5-20250929 - Good for literary translation
• claude-haiku-4-5-20251001 - Fast translation, cost-effective

​

Step 4: Start Using Translation

After configuration is complete, you can start using Immersive Translate:

​

4.1 Web Page Translation

1. Open any foreign language webpage
2. Click the Immersive Translate icon in the browser toolbar
3. Select Translate this page or use the shortcut (default: Alt+A)

​

4.2 Word Selection Translation

1. Select any text on the webpage
2. Translation panel will appear automatically
3. Or use shortcut (default: Alt+W)

​

4.3 PDF Translation

Immersive Translate supports online PDF file translation:

1. Open a PDF file in your browser (online PDF)
2. Click the Immersive Translate icon to open the extension panel
3. Click the Click to translate PDF (Alt+A) button
4. Wait for translation to complete, PDF will display bilingual comparison

​

4.4 Video Subtitle Translation

Supports real-time subtitle translation for mainstream video platforms:

1. Open YouTube, Netflix and other video platforms
2. Play video, Immersive Translate automatically recognizes subtitles
3. Automatically generates bilingual subtitle display

Supported Platforms:

• 🎬 YouTube
• 📺 Netflix
• 🎥 Coursera
• 📹 Udemy
• 🎓 edX

​

Advanced Features

​

Custom Translation Rules

Rich personalization options can be configured in settings: Basic Settings:

• Translation Service - Select default translation service (APIMart)
• AI Expert - Select translation style (General, Professional, Literary, etc.)
• AI Terminology - Manage professional terminology translation

Advanced Options:

• Website Rules - Set automatic translation rules for specific websites
• Translation Style - Customize translation color, font and other display styles
• Mouse Hover Settings - Configure Ctrl + mouse hover to show original text
• Word Selection Translation - Set translation behavior after selecting text
• Input Box Enhancement - Enable real-time translation in input boxes

​

Keyboard Shortcuts

Immersive Translate provides convenient keyboard shortcuts:

​

Translation Modes

Immersive Translate offers multiple flexible translation display modes:

​

FAQ

​

Q1: Translation not working after configuration?

Solutions:

1. Check Translation Service Selection:
   • Open extension panel, confirm APIMart is selected in “Translation Service” dropdown
   • If you can’t see APIMart, return to settings page to check if configuration is saved
2. Check API Key:
   • Confirm APIKEY is correct and starts with sk-
   • Check if key is valid and has balance at APIMart Console
3. Check API Endpoint:
   • Must fill in complete path: https://api.apimart.ai/v1/chat/completions
   • Note it’s not /v1 but /v1/chat/completions
4. Check Model Name:
   • Confirm model name is correct (like gpt-4o-mini, gpt-5)
   • Model names are case-sensitive

​

Q2: Translation slow or timing out?

Solutions:

1. Adjust Max Requests Per Second:
   • In configuration, reduce “Max Requests Per Second” to 3
   • Avoid too many concurrent requests causing timeout
2. Switch to Faster Model:
   • Use gpt-4o-mini (fast and economical)
   • Or use claude-haiku-4-5-20251001
3. Check Network Connection:
   • Ensure stable network, avoid frequent disconnections
   • For large pages, recommend translating in sections
4. Disable Unnecessary Features:
   • Temporarily disable “Enable AI Illustration” and other enhanced features
   • Reduce API call count

​

Q3: Translation quality not ideal?

Solutions:

1. Choose Higher Quality Model:
   • Use gpt-5 (latest and strongest) or gpt-4o (high quality)
   • For literary and professional content, recommend claude-sonnet-4-5-20250929
2. Adjust AI Expert Settings:
   • Select appropriate “AI Expert” in extension panel
   • Choose “Professional” for technical docs, “General” for daily content
3. Use Terminology Library:
   • Configure “AI Terminology” in settings
   • Add preferred translations for professional terms, ensure consistency
4. Enable AI Context Enhancement:
   • Enable “AI Smart Context” in custom service configuration
   • Provides more accurate contextual understanding

​

Q4: Some websites cannot be translated?

Solutions:

1. Check Website Compatibility:
   • Some dynamically loaded websites may need page refresh
   • SPAs may need manual translation triggering
2. Add Website Rules:
   • Add specific website configuration in “Website Rules” in settings
   • Specify translation areas and exclusion areas
3. Try Different Translation Modes:
   • Switch to “Mouse Hover” or “Word Selection” mode
   • Some websites work better in specific modes

​

Q5: How to view translation consumption?

Login to APIMart Console to view detailed statistics:

• 📊 API Call Statistics - Real-time view of call count and frequency
• 💰 Cost Details - Detailed cost record for each call
• 📈 Usage Trends - View usage by date/model
• 🔍 Request Logs - Detailed request and response records

​

Usage Tips

​

1. Smart Translation Service Selection

Choose appropriate models for different scenarios:

• 📚 Academic Papers, Technical Docs: Use gpt-5 for accuracy
• 📰 News Articles, Blogs: Use gpt-4o to balance quality and speed
• 💬 Social Media, Daily Browsing: Use gpt-4o-mini to save costs
• 🎨 Literary Works, Creative Content: Use claude-sonnet-4-5-20250929

​

2. Configure Website Auto-Translation

Set auto-translation rules for frequently visited websites:

1. Open Settings → Website Rules
2. Add website domain (like github.com)
3. Set to “Always Translate” or “Never Translate”
4. After saving, rules apply automatically when visiting the site

​

3. Use Word Selection for Precise Queries

For specific content within large text blocks:

1. Enable “Word Selection Translation” feature
2. Select text that needs translation
3. View precise translation results
4. Avoid translating entire page, save API calls

​

4. Optimize Translation Quality

Configure Terminology Library:

• Add professional terms in settings
• Ensure consistency in technical terminology translation
• Support multiple terminology library categories

Choose Appropriate AI Expert:

• Select “Professional” or “Technical” for technical docs
• Select “General” for daily content
• Select “Literary” or “Creative” for literary works

​

5. Save API Costs

Cost Control Strategy:

• ✅ Use gpt-4o-mini as default model for daily browsing
• ✅ Only switch to gpt-5 for important documents
• ✅ Configure “Max Requests Per Second” to 3-5, avoid limits
• ✅ Use “Only This Website” feature to control translation scope
• ✅ Select needed page ranges when translating PDFs
• ❌ Avoid frequently refreshing already translated pages

​

Features

Using Immersive Translate + APIMart, you can:

• 🌐 Webpage Translation - Bilingual comparison display, maintains original layout
• 📄 PDF Translation - Supports online PDF document translation
• 🎬 Video Subtitles - YouTube, Netflix and other platforms’ bilingual subtitles
• ✍️ Word Selection Translation - Select and translate, quick understanding
• 📧 Input Enhancement - Direct translation in input boxes
• 📱 Full Platform Support - Chrome, Edge, Firefox, Safari, etc.
• 🎨 Custom Styles - Adjust translation display effects
• ⚡ Quick Operations - Rich keyboard shortcut support

​

Support and Help

If you encounter any issues during use:

• 📚 APIMart Documentation Center
• 📚 Immersive Translate Documentation
• 💬 Discord Community
• 🐦 Twitter @APIMart_
• 📧 Technical Support: zhihong@apimart.ai

---

Start Using APIMart

Register for APIMart now, get your API key, and enjoy high-quality translation services!