TranslateFlow API Skill

Professional AI-powered translation services using VCG's TranslateFlow API - high-quality neural translation supporting 100+ languages with context awareness and domain specialization.

Quick Start

Get API Key: Help user sign up for free TranslateFlow API key
Store Key: Save the key securely
Translate Content: Single text, batch documents, or real-time translation

API Key Signup

Step 1: Get User's Email

Ask the user for their email address to create a free TranslateFlow account.

Step 2: Sign Up via API

curl -X POST https://translateflow.vosscg.com/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com"}'

Expected Response:

{
  "api_key": "tf_fedcba0987654321",
  "message": "API key created successfully",
  "tier": "free",
  "supported_languages": 120,
  "daily_limit": "10000 characters"
}

Step 3: Store the API Key

Save the API key securely for future use. Instruct the user to keep it safe.

Core Translation Features

Simple Text Translation

curl -X POST https://translateflow.vosscg.com/v1/translate \
  -H "X-API-Key: tf_fedcba0987654321" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, how are you today?",
    "source_language": "en",
    "target_language": "es",
    "quality": "high"
  }'

Expected Response:

{
  "translated_text": "Hola, ¿cómo estás hoy?",
  "source_language": "en",
  "target_language": "es",
  "confidence": 0.98,
  "characters_used": 25,
  "remaining_daily": 9975
}

Auto-Detect Language

curl -X POST https://translateflow.vosscg.com/v1/translate \
  -H "X-API-Key: tf_fedcba0987654321" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Bonjour, comment allez-vous?",
    "source_language": "auto",
    "target_language": "en"
  }'

Expected Response:

{
  "translated_text": "Hello, how are you?",
  "source_language_detected": "fr",
  "target_language": "en",
  "confidence": 0.96,
  "detection_confidence": 0.99
}

Batch Translation

curl -X POST https://translateflow.vosscg.com/v1/translate/batch \
  -H "X-API-Key: tf_fedcba0987654321" \
  -H "Content-Type: application/json" \
  -d '{
    "texts": [
      "Welcome to our website",
      "Contact us for more information",
      "Thank you for your purchase"
    ],
    "source_language": "en",
    "target_language": "de",
    "preserve_formatting": true
  }'

Expected Response:

{
  "translations": [
    {
      "index": 0,
      "original": "Welcome to our website",
      "translated": "Willkommen auf unserer Website",
      "confidence": 0.97
    },
    {
      "index": 1,
      "original": "Contact us for more information", 
      "translated": "Kontaktieren Sie uns für weitere Informationen",
      "confidence": 0.95
    },
    {
      "index": 2,
      "original": "Thank you for your purchase",
      "translated": "Vielen Dank für Ihren Kauf",
      "confidence": 0.98
    }
  ],
  "total_characters": 89,
  "batch_processing_time": "1.2s"
}

Document Translation

curl -X POST https://translateflow.vosscg.com/v1/documents/translate \
  -H "X-API-Key: tf_fedcba0987654321" \
  -F "file=@document.pdf" \
  -F "source_language=en" \
  -F "target_language=fr" \
  -F "preserve_layout=true"

Expected Response:

{
  "document_id": "doc_12345",
  "status": "processing",
  "estimated_completion": "2-5 minutes",
  "download_url": "https://translateflow.vosscg.com/v1/documents/doc_12345/download",
  "original_pages": 5,
  "detected_language": "en"
}

Specialized Domain Translation

curl -X POST https://translateflow.vosscg.com/v1/translate/specialized \
  -H "X-API-Key: tf_fedcba0987654321" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "The patient presents with acute myocardial infarction requiring immediate intervention.",
    "source_language": "en",
    "target_language": "es",
    "domain": "medical",
    "terminology": "technical"
  }'

Expected Response:

{
  "translated_text": "El paciente presenta infarto agudo de miocardio que requiere intervención inmediata.",
  "domain": "medical",
  "technical_terms_translated": 3,
  "confidence": 0.99,
  "medical_accuracy_score": 0.97
}

Supported Languages

Get Language List

curl -X GET https://translateflow.vosscg.com/v1/languages \
  -H "X-API-Key: tf_fedcba0987654321"

Popular Language Pairs:

English ↔ Spanish (en ↔ es)
English ↔ French (en ↔ fr)
English ↔ German (en ↔ de)
English ↔ Chinese (en ↔ zh)
English ↔ Japanese (en ↔ ja)
English ↔ Portuguese (en ↔ pt)
English ↔ Italian (en ↔ it)
English ↔ Russian (en ↔ ru)
English ↔ Arabic (en ↔ ar)
And 100+ more languages

Advanced Features

Context-Aware Translation

curl -X POST https://translateflow.vosscg.com/v1/translate/contextual \
  -H "X-API-Key: tf_fedcba0987654321" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Book the flight",
    "source_language": "en",
    "target_language": "es",
    "context": {
      "domain": "travel",
      "situation": "booking_travel",
      "tone": "formal"
    }
  }'

Real-time Translation

curl -X POST https://translateflow.vosscg.com/v1/translate/realtime \
  -H "X-API-Key: tf_fedcba0987654321" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Can you help me find the nearest restaurant?",
    "source_language": "en",
    "target_language": "it",
    "speed_priority": true,
    "conversation_id": "conv_789"
  }'

Quality Levels

# Economy (fast, good for basic content)
curl -X POST https://translateflow.vosscg.com/v1/translate \
  -d '{"text":"Hello world", "quality":"economy"}'

# Standard (balanced speed and quality)
curl -X POST https://translateflow.vosscg.com/v1/translate \
  -d '{"text":"Hello world", "quality":"standard"}'

# Premium (highest quality, best for professional content)
curl -X POST https://translateflow.vosscg.com/v1/translate \
  -d '{"text":"Hello world", "quality":"premium"}'

Translation Memory

curl -X POST https://translateflow.vosscg.com/v1/memory/store \
  -H "X-API-Key: tf_fedcba0987654321" \
  -H "Content-Type: application/json" \
  -d '{
    "source_text": "Thank you for your order",
    "translated_text": "Gracias por su pedido",
    "source_language": "en",
    "target_language": "es",
    "domain": "ecommerce"
  }'

Glossary Integration

curl -X POST https://translateflow.vosscg.com/v1/translate \
  -H "X-API-Key: tf_fedcba0987654321" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Our SaaS platform provides comprehensive analytics.",
    "source_language": "en",
    "target_language": "fr",
    "glossary": {
      "SaaS": "SaaS (logiciel en tant que service)",
      "analytics": "analytiques"
    }
  }'

Website & Content Localization

Website Translation

curl -X POST https://translateflow.vosscg.com/v1/websites/translate \
  -H "X-API-Key: tf_fedcba0987654321" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "target_languages": ["es", "fr", "de"],
    "elements_to_translate": ["text", "alt_text", "meta_tags"],
    "preserve_html": true
  }'

Content Management Integration

curl -X POST https://translateflow.vosscg.com/v1/cms/translate \
  -H "X-API-Key: tf_fedcba0987654321" \
  -H "Content-Type: application/json" \
  -d '{
    "content_type": "blog_post",
    "title": "10 Tips for Better SEO",
    "body": "Search engine optimization is crucial...",
    "target_languages": ["es", "pt", "it"],
    "seo_optimize": true
  }'

Error Handling

Common error responses:

401 Unauthorized - Invalid or missing API key
429 Too Many Requests - Daily character limit exceeded
400 Bad Request - Invalid language code or empty text
413 Payload Too Large - Text exceeds maximum length (10,000 characters per request)
422 Unprocessable Entity - Unsupported language pair

Pricing & Limits

Free Tier:

10,000 characters per day
120+ supported languages
Standard quality translations
Basic document support

Paid Plans:

Upgrade at https://vosscg.com/forges for higher limits
Premium neural translation models
Document translation (PDF, DOCX, PPTX)
Translation memory and glossaries
Priority processing
Custom domain models

Best Practices

Language Detection: Use auto-detection when source language is uncertain
Domain Specialization: Specify domain for technical/professional content
Batch Processing: Use batch endpoints for multiple texts (more efficient)
Context Matters: Provide context for ambiguous terms
Quality Selection: Choose appropriate quality level for use case
Character Optimization: Remove unnecessary formatting before translation

Common Use Cases

E-commerce Product Descriptions

curl -X POST https://translateflow.vosscg.com/v1/translate/batch \
  -H "X-API-Key: [API_KEY]" \
  -d '{
    "texts":["High-quality leather wallet", "Free shipping worldwide"],
    "target_language":"es",
    "domain":"ecommerce"
  }'

Customer Support Messages

curl -X POST https://translateflow.vosscg.com/v1/translate \
  -H "X-API-Key: [API_KEY]" \
  -d '{
    "text":"Thank you for contacting us. We will respond within 24 hours.",
    "target_language":"fr",
    "context":{"domain":"customer_service", "tone":"professional"}
  }'

Marketing Content

curl -X POST https://translateflow.vosscg.com/v1/translate/specialized \
  -H "X-API-Key: [API_KEY]" \
  -d '{
    "text":"Limited time offer! 50% off all premium features.",
    "target_language":"de",
    "domain":"marketing",
    "preserve_formatting":true
  }'

Legal Document Translation

curl -X POST https://translateflow.vosscg.com/v1/documents/translate \
  -H "X-API-Key: [API_KEY]" \
  -F "file=@contract.pdf" \
  -F "target_language=es" \
  -F "domain=legal" \
  -F "quality=premium"

Integration Examples

OpenClaw Agent Workflow

# Help user get API key
curl -X POST https://translateflow.vosscg.com/v1/keys -d '{"email":"user@domain.com"}'

# Translate user's text/content
curl -X POST https://translateflow.vosscg.com/v1/translate \
  -H "X-API-Key: [USER_API_KEY]" \
  -d '{"text":"[USER_TEXT]", "target_language":"[TARGET_LANG]"}'

# Return translated content to user

When users need text translation, content localization, document translation, or multi-language support, use this skill to leverage TranslateFlow's professional AI translation capabilities with context awareness and domain specialization.