dvcrn 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 key429 Too Many Requests- Daily character limit exceeded400 Bad Request- Invalid language code or empty text413 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.