Quick Start Guide

Create Your Account


                                Visit toanother.one/register

You'll get 10,000 free tokens per month (~5,000 words) with access to all 100+ languages.

Get Your API Key

Navigate to your dashboard and generate an API key.


                                Dashboard → API Keys → Generate New Key

Keep your API key secure. You can generate multiple keys for different environments.

Make Your First Translation

Use your API key to translate your first text.

curl -X POST https://api.toanother.one/api/v1/translate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello world",
    "source_language": "en",
    "target_language": "es"
  }'

Response:


{
  "translated_text": "Hola mundo",
  "request_id": "uuid-here",
  "quality_tier": "standard"
}

Integration Examples

                        import requests

API_KEY = "your_api_key_here"
API_URL = "https://api.toanother.one/api/v1/translate"

def translate(text, source_lang, target_lang):
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    
    data = {
        "text": text,
        "source_language": source_lang,
        "target_language": target_lang
    }
    
    response = requests.post(API_URL, json=data, headers=headers)
    return response.json()

# Example usage
result = translate("Hello world", "en", "es")
print(result["translated_text"])  # "Hola mundo"
                    

                        const API_KEY = 'your_api_key_here';
const API_URL = 'https://api.toanother.one/api/v1/translate';

async function translate(text, sourceLang, targetLang) {
    const response = await fetch(API_URL, {
        method: 'POST',
        headers: {
            'Authorization': `Bearer ${API_KEY}`,
            'Content-Type': 'application/json'
        },
        body: JSON.stringify({
            text: text,
            source_language: sourceLang,
            target_language: targetLang
        })
    });
    
    return response.json();
}

// Example usage
translate('Hello world', 'en', 'es')
    .then(result => console.log(result.translated_text));  // "Hola mundo"
                    

                        #!/bin/bash

API_KEY="your_api_key_here"
API_URL="https://api.toanother.one/api/v1/translate"

curl -X POST "$API_URL" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello world",
    "source_language": "en",
    "target_language": "es"
  }'

# Response:
# {
#   "translated_text": "Hola mundo",
#   "request_id": "550e8400-e29b-41d4-a716-446655440000",
#   "quality_tier": "standard"
# }
                    

                        <?php
$api_key = 'your_api_key_here';
$api_url = 'https://api.toanother.one/api/v1/translate';

function translate($text, $source_lang, $target_lang) {
    global $api_key, $api_url;
    
    $data = [
        'text' => $text,
        'source_language' => $source_lang,
        'target_language' => $target_lang
    ];
    
    $options = [
        'http' => [
            'header' => [
                "Authorization: Bearer $api_key",
                "Content-Type: application/json"
            ],
            'method' => 'POST',
            'content' => json_encode($data)
        ]
    ];
    
    $context = stream_context_create($options);
    $result = file_get_contents($api_url, false, $context);
    
    return json_decode($result, true);
}

// Example usage
$result = translate('Hello world', 'en', 'es');
echo $result['translated_text'];  // "Hola mundo"
?>
                    

Advanced Features

Setting Up Your Glossary

Protect your brand names and technical terms from being translated.

# Create a glossary set
POST /api/v1/glcv/sets
{
  "name": "Brand Terms",
  "priority": 1000
}

# Add terms to protect
POST /api/v1/glcv/sets/{set_id}/concepts
{
  "name": "Azure DevOps",
  "source_language": "en",
  "aliases": ["AzureDevOps", "Azure-DevOps"],
  "targets": {
    "es": "Azure DevOps",  // Keep unchanged
    "fr": "Azure DevOps",
    "de": "Azure DevOps"
  }
}

Batch Translation

Translate multiple segments efficiently while maintaining context.

POST /api/v1/translate/batch
{
  "segments": [
    {"text": "Welcome to our platform."},
    {"text": "Start your free trial today."},
    {"text": "No credit card required."}
  ],
  "source_language": "en",
  "target_language": "es",
  "maintain_context": true
}

Language Auto-Detection

Let TAO automatically detect the source language.

POST /api/v1/translate
{
  "text": "Bonjour le monde",
  "source_language": "auto",  // Auto-detect
  "target_language": "en"
}

// Response includes detected language
{
  "translated_text": "Hello world",
  "detected_language": "fr",
  "confidence": 0.99
}

Best Practices

Use Glossaries for Consistency

Define your key terms once and maintain consistency across all translations. This is especially important for brand names, product features, and technical terminology.

Batch Related Content

When translating related segments (like paragraphs from the same document), use batch translation to maintain context and consistency.

Monitor Your Usage

Keep track of your character usage through the dashboard. Set up alerts before hitting limits to ensure uninterrupted service.

Use API Keys Securely

Never expose API keys in client-side code. Use environment variables and rotate keys regularly for security.

Getting Started with TAO