بەڵگەنامەکان

وەرگێڕانی بەهێز لە پرۆگرامەکانتدا بە بەکارهێنانی REST API سادەکەمان تێکەڵ بکە.

دەست پێکردن

پڕۆگرامی وەرگێڕان ڕێگایەکی ئاسانی REST دەڕەخسێنێت بۆ وەرگێڕانی نوسراوەکان لە نێوان 180 زماندا. هەموو خاڵەکانی کۆتایی پڕۆگرامی وەرگێڕان وەڵامی JSON دەدەنەوە.

ماڵپەڕی بنەڕەتی: https://api.translateapi.ai/api/v1/
دەستپێکردنی خێرا

یەکەم داواکاری وەرگێڕانەکەت بکە:

curl -X POST https://api.translateapi.ai/api/v1/translate/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "text": "Hello, world!",
    "target_language": "es"
  }'
import requests

response = requests.post(
    "https://api.translateapi.ai/api/v1/translate/",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "text": "Hello, world!",
        "target_language": "es"
    }
)

result = response.json()
print(result["translated_text"])  # "Hola, mundo!"
const response = await fetch("https://api.translateapi.ai/api/v1/translate/", {
    method: "POST",
    headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        text: "Hello, world!",
        target_language: "es"
    })
});

const result = await response.json();
console.log(result.translated_text);  // "Hola, mundo!"
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json;

class Program
{
    static async Task Main()
    {
        var client = new HttpClient();
        client.DefaultRequestHeaders.Add(
            "Authorization", "Bearer YOUR_API_KEY"
        );

        var content = new StringContent(
            JsonConvert.SerializeObject(new {
                text = "Hello, world!",
                target_language = "es"
            }),
            Encoding.UTF8,
            "application/json"
        );

        var response = await client.PostAsync(
            "https://api.translateapi.ai/api/v1/translate/",
            content
        );

        var result = await response.Content.ReadAsStringAsync();
        var data = JsonConvert.DeserializeObject<dynamic>(result);
        Console.WriteLine(data.translated_text);  // "Hola, mundo!"
    }
}

دڵنیابوونەوە

داواکارییەکانی خۆت بە بەکارهێنانی کلیلی API پشتڕاست بکەەوە. دەتوانیت کلیلی API دروست بکەیت لە کۆمپیوتەرەکەتەوە داشبۆرد.

ڕاستکردنەوەی سەرنووس (پەسەندکراوە)
Authorization: Bearer ta_your_api_key_here
پارامەتری پرسیار
https://api.translateapi.ai/api/v1/translate/?api_key=ta_your_api_key_here
کلیلی API ی خۆت بپارێزە! نەیانخەرە ڕوو لە کۆدەکانی لای کڕیار یان لە شوێنە گشتیەکان.

وەرگێڕانی نوسراو

وەرگێڕانی نوسراوەکان بۆ زمانێکی دیاریکراو.

POST https://api.translateapi.ai/api/v1/translate/
بەشە داواکراوەکان
پێوانە جۆر پێویسته باسکردن
text string بەڵێ نوسراوە بۆ وەرگێڕان (بەگشتی ٥٠,٠٠٠ هێما)
target_language string بەڵێ Target language code (e.g., "es", "fr", "de")
source_language string نەخێر Source language code. Default: "auto" (auto-detect)

بەکارھێنان target_language (شێوەزار) بۆ زمانێکی تاک یان target_languages .بڕوانە وەرگێڕانی زۆر ئامانج.

وەڵامدانەوە
{
    "translated_text": "Hola, mundo!",
    "source_language": "en",
    "target_language": "es",
    "translations": {
        "es": "Hola, mundo!"
    },
    "character_count": 13,
    "translation_time": 0.45
}

وەرگێڕانی زۆر ئامانج

وەرگێڕانی نوسراوەکان بۆ زمانە جۆراوجۆرەکان لە یەک داواکاریدا. هەمان خاڵی کۆتایی بەکاردەهێنێت وەک وەرگێڕانی تاک.

جۆر: دەتوانیت وەرگێڕان بکەیت بۆ ٥٠ زمان لە یەک داواکاریدا.
POST https://api.translateapi.ai/api/v1/translate/
بەشە داواکراوەکان
{
    "text": "Hello, world!",
    "target_languages": ["es", "fr", "de", "ja"],
    "source_language": "en"
}

بەکارھێنان target_languages (ڕێگە) لە جیاتی target_language بۆ ئامانجە زۆرەکان.

وەڵامدانەوە
{
    "source_language": "en",
    "translations": {
        "es": "Hola, mundo!",
        "fr": "Bonjour, monde!",
        "de": "Hallo, Welt!",
        "ja": "こんにちは、世界！"
    },
    "character_count": 52,
    "translation_time": 2.31
}

وەرگێڕان

وەرگێڕانی چەند نوسراوێک لە یەک کاتدا بە پەرەپێدانی بێ هاوتا. پێشکەشکردنی کۆمەڵە و دەنگدان بۆ ئەنجامەکان.

سنوورەکان: زیاتر لە ٥٠٠ نوسراو بۆ هەر بەشە، زیاتر لە ٧٥٠ نوسراو بۆ هەموو شتەکان (نوسراوەکان × زمانە ئامانجەکان). کارەکان ٣٠ خولەک دوای دەستپێکردنی پڕۆسێسەکە کۆتایی دێت (کاتی چاوەڕێکردنی ڕیزەکە ناژمێررێت).
کاتی پەرەپێدان بە زمانەکان دەگۆڕێت: زمانە گشتیەکان (ئیسپانی، فەڕەنسی، ئەڵمانی، هتد) مۆدێلی خێرا بەکاردەهێنن (~0.1س بۆ هەر نوسراوێک)، لەکاتێکدا زمانە کەم بەکارهاتووەکان مۆدێلی زۆر زمانی ئێمە بەکاردەهێنن (~1-3س بۆ هەر نوسراوێک). کۆمەڵێک لە ١٠٠ نوسراو بە شێوەیەکی ئاسایی لە ١٠-٣٠ چرکەدا تەواو دەبێت بۆ زمانە گشتیەکان، یان ٢-٥ خولەک بۆ ئەوانەی کە کەم بەکاردەهێنرێن. بۆ باشترین ئەنجام، ١ زمانی ئامانج بۆ هەر داوایەکی کۆمەڵە بنێرێت و ژمارەی کۆمەڵەکان لە ژێر ٥٠ نوسراودا بمێنێتەوە.
POST https://api.translateapi.ai/api/v1/translate/batch/
هەنگاوی ١: پێشکەشکردنی کۆمەڵە
curl -X POST https://api.translateapi.ai/api/v1/translate/batch/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "texts": ["Hello", "Goodbye", "Thank you"],
    "target_language": "es",
    "source_language": "en"
}'
وەڵامدانەوە (HTTP 202 پەسەندکراوە)
{
    "job_id": "67535b2b-c9e3-4f82-9499-e237edbc1dd8",
    "status": "pending",
    "total_texts": 3,
    "queue_position": 1,
    "source_language": "en",
    "target_languages": ["es"],
    "character_count": 22,
    "credits_remaining": -1,
    "poll_url": "https://api.translateapi.ai/api/v1/jobs/67535b2b-c9e3-4f82-9499-e237edbc1dd8/"
}
هەنگاوی ٢: بۆ ئەنجامەکان دەنگ بدە
GET https://api.translateapi.ai/api/v1/jobs/{job_id}/
نمونەی دەنگدان (پایتۆن)
import time, requests

job_id = response.json()["job_id"]
total = response.json()["total_texts"]
headers = {"Authorization": "Bearer YOUR_API_KEY"}

print(f"Batch submitted: {total} texts (job {job_id})")

while True:
    result = requests.get(f"https://api.translateapi.ai/api/v1/jobs/{job_id}/", headers=headers).json()
    status = result["status"]
    processed = result.get("processed_texts", 0)
    progress = result.get("progress_percentage", 0)

    if status == "completed":
        print(f"Completed: {processed}/{total} texts in {result.get('processing_time', 0):.1f}s")
        translations = result["result_data"]["translations"]
        break
    elif status == "failed":
        print(f"Failed at {processed}/{total}: {result.get('error_message', 'unknown')}")
        raise Exception(result.get("error_message", "Translation failed"))
    elif status == "pending":
        queue_pos = result.get("queue_position", "?")
        print(f"Queued (position {queue_pos}) — waiting for GPU worker...")
    else:
        print(f"[{status}] {processed}/{total} ({progress:.0f}%)")

    time.sleep(3)
وەڵامدانەوە (لەژێر چاوەدێریدایە، چاوەڕێیە بۆ GPU)
{
    "job_id": "67535b2b-...",
    "status": "pending",
    "processed_texts": 0,
    "total_texts": 3,
    "progress_percentage": 0.0,
    "queue_position": 3
}
وەڵامدانەوە (لەکاتی پەرەپێداندا)
{
    "job_id": "67535b2b-...",
    "status": "processing",
    "processed_texts": 1,
    "total_texts": 3,
    "progress_percentage": 33.33,
    "queue_position": null
}
وەڵامدانەوە (تەواو کرا)
{
    "job_id": "67535b2b-...",
    "status": "completed",
    "processed_texts": 3,
    "total_texts": 3,
    "progress_percentage": 100.0,
    "processing_time": 10.65,
    "result_data": {
        "translations": ["Hola", "Adiós", "Gracias"],
        "source_language": "en",
        "target_language": "es",
        "character_count": 22,
        "processing_time": 10.65
    }
}
چاودێریکردنی پێشکەوتنی کاتی ڕاستەوخۆ

هەر وەڵامێکی سەرژمێریەکە بەشی پێشکەوتنی کاتی ڕاستەوخۆی تێدایە کەواتە دەتوانیت چاودێری ئەوە بکەیت بەڕاستی چی ڕوودەدات لەگەڵ کۆمەڵەکەتدا:

بوار باسکردن
status دۆخی ئەرکی ئێستا: pending (لە ڕیزدا، چاوەڕێی کارمەندێکی GPU دەکات)، processing ئینجا سوێند به‌و فریشتانه‌ی که ده‌یگێڕنه‌وه بۆ زمانه‌کانیان. completed, failed
processed_texts ژمارەی وەرگێڕانەکانی تاک کە تا ئێستا تەواو کراون. لە کاتی ڕاستەوخۆدا نوێ دەکرێتەوە کاتێک هەر نوسراوێک وەرگێڕدراوە.
total_texts ژمارەی کۆی وەرگێڕانەکان لەم بەشە (نوسراوەکان × زمانەکانی ئامانج).
progress_percentage ڕێژەی تەواوبوون (٠-١٠٠). حساب کراوە لە processed_texts / total_texts.
queue_position شوێنی خۆت لە ڕیزدا کاتێک بارودۆخەکە "هەیە" (١ = داهاتوو). پووچ کاتێک پڕۆسێس دەکرێتەوە یان تەواو کراوە. بەکاری بهێنە بۆ پێوانەکردنی کاتی چاوەڕێکردن و نیشاندانی بارودۆخی ڕیز بە بەکارهێنەرەکانت.
processing_time کاتی پڕۆسێسکردنی کۆی بە چرکە (دەستکاری دەکرێت کاتێک تەواو دەبێت)
جۆر: کاتێک status یە "pending", کارمەندانی GPU سەرقاڵن بە تاقیکردنەوەکانی تر. queue_position بۆ ئەوەی بزانیت چەند کارێک پێش تۆیە (١ = تۆی داهاتوویت). کارەکەت بە ئۆتۆماتیکی دەست پێدەکات - هیچ کردارێک پێویست ناکات، تەنها بەردەوامبە لە هەڵسەنگاندن.
باشترین کردار بۆ کارەکانی گەورە
  • 1 زمانی ئامانج بۆ هەر داواکارییەک بنێرێت. ئەمە هەموو داواکارییەک خێراتر دەکات و پێشکەوتنی ئاسان دەکات بۆ شوێنکەوتن.
  • بەشەکان لە ٥٠-١٠٠ وشە بپارێزە. بەشەکانی بچوک خێراتر تەواو دەبن و پێشکەوتنی زیاترت پێدەبەخشن.
  • جێبەجێکردنی زیاتر لە ٢ کار لە یەک کاتدا. پڕۆسێسەری وێنەی گرافیکی ٢ کار لە یەک کاتدا جێبەجێ دەکات - کارەکانی تر لە ڕیزدان و خێراتر دەست پێناکات.
  • لە کاتی تێپەڕبوونی کاتدا، دووبارە پرسیار لە هەمان کار_ID بکە لە جیاتی پێشکەشکردنی کارێکی نوێ. لەوانەیە کارەکە هێشتا پڕۆسێس بکرێت لەسەر GPU.
  • هەر ٣-٥ چرکە پرسیارێک بکە. زۆرتر پرسیارکردن خێراکردنی پڕۆسێسەکە کەم دەکاتەوە.
زمانە زۆرەکان

وەرگێڕانی چەند وتارێک بۆ چەند زمانێک لە یەک کاتدا:

{
    "texts": ["Hello", "Goodbye"],
    "target_languages": ["es", "fr"],
    "source_language": "en"
}
ئەنجامی داتا تەواو بوو
{
    "translations": [
        {"es": "Hola", "fr": "Bonjour"},
        {"es": "Adiós", "fr": "Au revoir"}
    ],
    "source_language": "en",
    "target_languages": ["es", "fr"],
    "character_count": 24,
    "processing_time": 2.45
}
پێوانە داواکراوەکان
پێوانە جۆر پێویسته باسکردن
texts array بەڵێ ئاڕشیڤی ڕستە بۆ وەرگێڕان
target_language string بەڵێ کۆدی زمانی ئامانج بۆ زمانێکی تاک
target_languages array بەڵێ کۆدەکانی زمانە ئامانجەکان بۆ زمانە زۆرەکان
source_language string نەخێر Source language code. Default: "auto"

یاخود target_language یان target_languagesهەردوکیان

پەرەپێدانی بێ هاوتا: داواکاریەکانی بەکۆمەڵ بە خێرایی دەگەڕێنەوە بە job_id. کون GET /api/v1/jobs/{job_id}/ هەتا status یە "completed", پاشان بخوێنەوە result_data بۆ وەرگێڕان. progress_percentage بۆ دەستنیشانکردنی پێشکەوتن.

وەرگێڕانی سند

وەرگێڕانی هەمو سندووقەکان لەگەڵ پاراستنی شێواز. پشتگیری چەندین شێوازی فایل دەکات.

POST https://api.translateapi.ai/api/v1/translate/document/
داواکاری (هەندێک بەش/هەندێک زانیاری)
پێوانە جۆر پێویسته باسکردن
file file بەڵێ سندەکە بۆ وەرگێڕان (بەگشتی ١٠ مێگابایت)
target_language string بەڵێ Target language code (e.g., "es", "fr", "de")
source_language string نەخێر Source language code. Default: "auto" (auto-detect)
جۆری پڕۆگرامەکان
  • .txt - فۆڕمی نووسراو
  • .docx - سندووقەکانی وورد
  • .pdf - سندووقەکانی پی دی ئێف (لەوانەی کە وێنەیان کێشراوە)
  • .json - فۆڕمەکانی JSON (بە مانای زنجیرەکان دەگۆڕێت)
  • .xml - فۆڕمی XML
  • .srt - فایلی ژێرناوەکان
  • .po / .pot - فۆڕمەکانی وەرگێڕان
  • .jpg / .jpeg - وێنەی JPEG
  • .png - وێنەی PNG
  • .tiff / .tif - وێنەی TIFF
  • .bmp - وێنەی BMP
  • .webp - وێنەی WebP
پشتگیری OCR: فۆڕمەکانی وێنە و فۆرمەکانی پی دی ئێف بە بەکارھێنانی ناسینەوەی هێمای ئۆپتیکی (OCR) بۆ وەرگێڕان بەکاردەهێنرێت. بۆ باشترین ئەنجام، وێنەی ڕوون و بە ڕوونی بەرز بەکاربهێنە.
نموونە (cURL)
# Translate a Word document
curl -X POST https://api.translateapi.ai/api/v1/translate/document/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@document.docx" \
  -F "target_language=es" \
  -F "source_language=en"

# Translate text from an image (OCR)
curl -X POST https://api.translateapi.ai/api/v1/translate/document/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@scanned_page.jpg" \
  -F "target_language=es" \
  -F "source_language=en"
فۆڕمەکانی وێنە بە OCR پڕۆسێس دەکرێن بۆ وەرگێڕانی نوسراوەکان پێش وەرگێڕان. وەرگێڕدراوەکە دەگەڕێتەوە وەک .txt پەڕگە.
وەڵامدانەوە
{
    "id": 123,
    "original_filename": "document.docx",
    "file_type": "docx",
    "source_language": "en",
    "target_language": "es",
    "status": "completed",
    "character_count": 5420,
    "translated_file_url": "/media/translated/document_es.docx",
    "created_at": "2024-01-15T10:30:00Z",
    "completed_at": "2024-01-15T10:30:05Z"
}
بایەخی حاڵەت
pending فۆڕمەکە دابەزێنرا، چاوەڕێیە بۆ پەرەپێدان
processing وەرگێڕان
completed وەرگێڕان تەواو بوو، دابەزاندن ئامادەیە
failed وەرگێڕان شکستی هێناوە (بڕوانە پەیامی هەڵە)
GET https://api.translateapi.ai/api/v1/translate/document/{id}/

پشکنینی بارودۆخی وەرگێڕانی سندێک یان وەرگرتنی ناوەکەی داگرتن.

وەڵامدانەوە
{
    "id": 123,
    "original_filename": "document.docx",
    "status": "completed",
    "translated_file_url": "/media/translated/document_es.docx",
    "character_count": 5420
}

دەستنیشانکردنی زمان

دەستنیشانکردنی زمان لە هەموو داواکارییە وەرگێڕدراوەکاندا دروست دەکرێت. Set source_language to "auto" (یاخود واز لێبهێنن) وە زمانی دۆزرایەوە دەگەڕێتەوە لە وەڵامدا.

POST https://api.translateapi.ai/api/v1/translate/
بەشە داواکراوەکان
{
    "text": "Bonjour, comment allez-vous?",
    "target_language": "en"
}
وەڵامدانەوە
{
    "translated_text": "Hello, how are you?",
    "source_language": "fr",
    "target_language": "en",
    "translations": {
        "en": "Hello, how are you?"
    },
    "character_count": 28,
    "translation_time": 0.52
}

ئەو source_language ئەم بوارە لە وەڵامدا زمانی دەستنیشانکراو نیشان دەدات کاتێک دەستنیشانکردنی خۆکار بەکاردەهێنرێت.

زمانی پاڵپشتیکراو

لیستی هەموو زمانەکانی پاڵپشتیکراو وەربگرە.

GET https://api.translateapi.ai/api/v1/translate/languages/
وەڵامدانەوە
{
    "count": 186,
    "results": [
        {"iso": "en", "name": "English", "en_label": "English"},
        {"iso": "es", "name": "Español", "en_label": "Spanish"},
        {"iso": "fr", "name": "Français", "en_label": "French"},
        ...
    ]
}

وەرگێڕان

ئێمە مۆدێلی وەرگێڕانی سەرچاوە کراوە بەکاردەهێنین کە لەسەر بنەڕەتی GPU ی خۆمان کاردەکات. هەموو مۆدێلەکان مۆڵەتی بازرگانییان هەیە (ئاپاچی 2.0).

مۆدێل زمانەکان باشترین بۆ
Helsinki-NLP/opus-mt دوو زمان زمانە گشتیەکان (EN, ES, FR, DE, IT, PT, RU, ZH, JA, و هتد)
Google MADLAD-400 400 زمان زمانە نەزانراوەکان، بڵاوکردنەوەیەکی فراوان

ئەپی پی بە ئۆتۆماتیکی باشترین مۆدێلی بۆ جووت زمانی خۆت هەڵدەبژێرێت. دەتوانیت هەڵبژێردراوێک دیاری بکەیت engine پێوانە:

ماشێن باسکردن
"auto" پێشنیار کراوە. یەکەمجار هەوڵ دەدات بە گرتنی ڕووخسار، پاشان دەگەڕێتەوە بۆ MADLAD-400
"huggingface" ناچارکردنی HuggingFace/MarianMT (بە خێرایی، زیاتر لە ٥٠ زمان)
"madlad" هێزی MADLAD-400 (400+ زمان)

هەڵسەنگاندنی هەڵە

ئەم ئەپی یە ستانداردی کۆدی دۆخی HTTP بەکاردەهێنێت بۆ نیشاندانی سەرکەوتن یان شکست.

کۆد باسکردن
200 سەرکەوتن
400 داواکاری خراپ - پارامەترە نادروستەکان
401 مۆڵەت نەدراوە - کلیلی نایاسایی یان نەماوە
402 پارە پێدان پێویسته - ڕێژەی نوسراوەکانی ڕۆژانە تێپەڕی
429 زۆر داواکاری - سنووری خێرایی تێپەڕی
503 خزمەتگوزاری نەماوە - بزوێنەری وەرگێڕان بۆ ماوەیەک داخراوە
شێوازی وەڵامدانەوەی هەڵە
{
    "error": "daily_limit_exceeded",
    "credits_remaining": 0,
    "daily_limit": 100000
}

سنووری خێرایی

سنوورەکان بەپێی پڕۆژەکە جیاوازن. بڕوانە نرخ بۆ زانیاری زیاتر:

پلان رەگەز/مانگ نرخ
ئازادە 250,000 $0 تۆماربکە
دەست پێکردن 2,500,000 $9/میگابایت بەشداربە
پڕۆ 10,000,000 $29/میگابایت بەشداربە
بازرگانی 40,000,000 $79/میگابایت بەشداربە
پێوانە 125,000,000 $199/میگابایت بەشداربە

کاتێک لە سنوورەکەت تێدەپەڕیت، پەیامێک وەردەگریت 429 Too Many Requests تا مانگی داهاتوو وەڵام ناداتەوە یان بەرزت دەکاتەوە.

بنەڕەتی هەورە خۆکارییەکان

TranslateAPI لەسەر NVIDIA A100 GPU تایبەت بە نمونە کاردەکات لەگەڵ هەڵسەنگاندنی ئۆتۆماتیکی ئاسۆیی. کاتێک داواکاری زیاد دەکات، نمونەی GPU زیادکراو لەماوەی چەند خولەکێکدا دەست پێدەکات بۆ پاراستنی کاتی وەڵامدانەوەی خێرا. ئەمە مانای ئەوەیە کە API ی ئێمە دەتوانێت داواکارییە هاوبەشەکانی بێ سنووری بێ سنووری بێ کەمکردنەوە - لە داواکارییەکی تاکەکەسییەوە بۆ هەزاران لە چرکەیەکدا.

ڕێژەی ئەم لاپەڕەیە
سوپاس بۆ ڕێزگرتنت!
/5 لەسەر بنەمای ڕێزدان