Skill: jbennett111/translateflow-api (version 1.0.0)

--- name: translateflow-api description: "AI-powered translation services using TranslateFlow API - translation, translate text, language conversion, multilingual translation, language translation, document translation, website translation, content localization, real-time translation, batch translation, professional translation, machine translation, neural translation, automatic translation, text translation, instant translation, multi-language support, localization services, international content, global content, cross-language communication, foreign language translation, language conversion tool, translation automation, and intelligent language processing for any text or content translation needs." --- # 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 1. **Get API Key**: Help user sign up for free TranslateFlow API key 2. **Store Key**: Save the key securely 3. **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 ```bash curl -X POST https://translateflow.vosscg.com/v1/keys \ -H "Content-Type: application/json" \ -d '{"email":"[REDACTED_SECRET]"}' ``` **Expected Response:** ```json { "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 ```bash curl -X POST https://translateflow.vosscg.com/v1/translate \ -H "X-[REDACTED_SECRET]" \ -H "Content-Type: application/json" \ -d '{ "text": "Hello, how are you today?", "source_language": "en", "target_language": "es", "quality": "high" }' ``` **Expected Response:** ```json { "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 ```bash curl -X POST https://translateflow.vosscg.com/v1/translate \ -H "X-[REDACTED_SECRET]" \ -H "Content-Type: application/json" \ -d '{ "text": "Bonjour, comment allez-vous?", "source_language": "auto", "target_language": "en" }' ``` **Expected Response:** ```json { "translated_text": "Hello, how are you?", "source_language_detected": "fr", "target_language": "en", "confidence": 0.96, "detection_confidence": 0.99 } ``` ### Batch Translation ```bash curl -X POST https://translateflow.vosscg.com/v1/translate/batch \ -H "X-[REDACTED_SECRET]" \ -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:** ```json { "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 ```bash curl -X POST https://translateflow.vosscg.com/v1/documents/translate \ -H "X-[REDACTED_SECRET]" \ -F "file=@document.pdf" \ -F "source_language=en" \ -F "target_language=fr" \ -F "preserve_layout=true" ``` **Expected Response:** ```json { "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 ```bash curl -X POST https://translateflow.vosscg.com/v1/translate/specialized \ -H "X-[REDACTED_SECRET]" \ -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:** ```json { "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 ```bash curl -X GET https://translateflow.vosscg.com/v1/languages \ -H "X-[REDACTED_SECRET]" ``` **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 ```bash curl -X POST https://translateflow.vosscg.com/v1/translate/contextual \ -H "X-[REDACTED_SECRET]" \ -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 ```bash curl -X POST https://translateflow.vosscg.com/v1/translate/realtime \ -H "X-[REDACTED_SECRET]" \ -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 ```bash # 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 ```bash curl -X POST https://translateflow.vosscg.com/v1/memory/store \ -H "X-[REDACTED_SECRET]" \ -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 ```bash curl -X POST https://translateflow.vosscg.com/v1/translate \ -H "X-[REDACTED_SECRET]" \ -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 ```bash curl -X POST https://translateflow.vosscg.com/v1/websites/translate \ -H "X-[REDACTED_SECRET]" \ -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 ```bash curl -X POST https://translateflow.vosscg.com/v1/cms/translate \ -H "X-[REDACTED_SECRET]" \ -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 1. **Language Detection**: Use auto-detection when source language is uncertain 2. **Domain Specialization**: Specify domain for technical/professional content 3. **Batch Processing**: Use batch endpoints for multiple texts (more efficient) 4. **Context Matters**: Provide context for ambiguous terms 5. **Quality Selection**: Choose appropriate quality level for use case 6. **Character Optimization**: Remove unnecessary formatting before translation ## Common Use Cases ### E-commerce Product Descriptions ```bash curl -X POST https://translateflow.vosscg.com/v1/translate/batch \ -H "X-[REDACTED_SECRET]" \ -d '{ "texts":["High-quality leather wallet", "Free shipping worldwide"], "target_language":"es", "domain":"ecommerce" }' ``` ### Customer Support Messages ```bash curl -X POST https://translateflow.vosscg.com/v1/translate \ -H "X-[REDACTED_SECRET]" \ -d '{ "text":"Thank you for contacting us. We will respond within 24 hours.", "target_language":"fr", "context":{"domain":"customer_service", "tone":"professional"} }' ``` ### Marketing Content ```bash curl -X POST https://translateflow.vosscg.com/v1/translate/specialized \ -H "X-[REDACTED_SECRET]" \ -d '{ "text":"Limited time offer! 50% off all premium features.", "target_language":"de", "domain":"marketing", "preserve_formatting":true }' ``` ### Legal Document Translation ```bash curl -X POST https://translateflow.vosscg.com/v1/documents/translate \ -H "X-[REDACTED_SECRET]" \ -F "file=@contract.pdf" \ -F "target_language=es" \ -F "domain=legal" \ -F "quality=premium" ``` ## Integration Examples ### OpenClaw Agent Workflow ```bash # Help user get API key curl -X POST https://translateflow.vosscg.com/v1/keys -d '{"email":"[REDACTED_SECRET]"}' # Translate user's text/content curl -X POST https://translateflow.vosscg.com/v1/translate \ -H "X-[REDACTED_SECRET]" \ -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.


Security scan verdicts — ClawScan: suspicious | static analysis: suspicious | VirusTotal: clean | SkillSpector: suspicious (HIGH)