API દસ્તાવેજ

આપણા સરળ REST API સાથે તમારા કાર્યક્રમોમાં મજબૂત અનુવાદને એકીકૃત કરો.

Get Free API Key Endpoints Pricing

શરૂ કરી રહ્યા છીએ

TranslateAPI 180+ ભાષાઓ વચ્ચે લખાણનું ભાષાંતર કરવા માટે સરળ REST ઇન્ટરફેસ પૂરુ પાડે છે. બધા API અંતબિંદુઓ JSON જવાબો પાછા આપે છે.

1. Get Your API Key

Create a free account and generate your API key from the dashboard:

  1. Sign up at translateapi.ai/signup
  2. Go to ડેશબોર્ડ → API કીઓ
  3. Click "Create API Key" and copy your key

API keys start with ta_ followed by 56 hex characters.

આધાર URL: https://api.translateapi.ai/api/v1/
2. Make Your First Request

Replace YOUR_API_KEY with the key from your dashboard:

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!"
$ch = curl_init("https://api.translateapi.ai/api/v1/translate/");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_API_KEY",
        "Content-Type: application/json"
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "text" => "Hello, world!",
        "target_language" => "es"
    ])
]);

$result = json_decode(curl_exec($ch), true);
echo $result["translated_text"];  // "Hola, mundo!"
payload := strings.NewReader(`{
    "text": "Hello, world!",
    "target_language": "es"
}`)

req, _ := http.NewRequest("POST", "https://api.translateapi.ai/api/v1/translate/", payload)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")

resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Println(result["translated_text"])  // "Hola, mundo!"
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");

var content = new StringContent(
    JsonSerializer.Serialize(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 = JsonSerializer.Deserialize<JsonElement>(
    await response.Content.ReadAsStringAsync()
);
Console.WriteLine(result.GetProperty("translated_text"));  // "Hola, mundo!"
જવાબ
{
    "translated_text": "Hola, mundo!",
    "source_language": "en",
    "target_language": "es",
    "translations": {
        "es": "Hola, mundo!"
    },
    "character_count": 13,
    "translation_time": 0.45
}

સત્તાધિકરણ

API કી ની મદદથી તમારી વિનંતીઓને સત્તાધિકરણ કરો. તમે તમારી પાસેથી API કીઓ બનાવી શકો છો ડેશબોર્ડ.

હેડર સત્તાધિકરણ (સૂચવાયેલ)
Authorization: Bearer ta_your_api_key_here
ApiKey Header
Authorization: ApiKey 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)
engine string નહી Translation engine: "auto" (default), "huggingface", or "madlad". See Translation Models. ભાષાંતર મોડેલો.

* વપરાશ 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
}
Auto-Detection: Omit source_language or set it to "auto" to automatically detect the source language. The detected language is returned in the source_language response field.

મલ્ટી-લક્ષ્ય ભાષાંતર

એક સૂચનામાં ઘણાબધા ભાષાઓમાં લખાણનું ભાષાંતર કરો. એક જ અંતબિંદુને એક જ ભાષાંતર તરીકે વાપરે છે.

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
}
પ્રકાર: તમે એક જ અરજીમાં ૫૦ ભાષાઓનું ભાષાંતર કરી શકો છો.

બેચ ભાષાંતર

અસુમેળ પ્રક્રિયા સાથે એક જ સમયે ઘણાબધા લખાણોનું ભાષાંતર કરો. પરિણામો માટે બેચ અને પોલ રજૂ કરો.

Limits: Max 100 texts per batch, max 300 total items (texts × target languages). Jobs time out 45 minutes after processing starts.
Speed: Common languages (ES, FR, DE) use fast models (~0.1s/text). Less common languages use our multilingual model (~1-3s/text).
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 ૨૦૨ સ્વીકારાયેલ)
{
    "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}/
પોલિંગ ઉદાહરણ (Python)
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"Done: {processed}/{total} in {result.get('processing_time', 0):.1f}s")
        translations = result["result_data"]["translations"]
        break
    elif status == "failed":
        raise Exception(result.get("error_message", "Translation failed"))
    elif status == "pending":
        print(f"Queued (position {result.get('queue_position', '?')})")
    else:
        print(f"[{status}] {processed}/{total} ({progress:.0f}%)")

    time.sleep(3)
જવાબ (પૂર્ણ થયેલ)
{
    "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
    }
}
Real-Time Progress Tracking
Field વર્ણન
status pending (queued, waiting for a GPU worker), processing (actively translating), completed, failed
processed_texts Number of individual translations completed so far. Updates in real time as each text is translated.
progress_percentage Completion percentage (0-100). Calculated from processed_texts / total_texts.
queue_position Your position in the queue when status is "pending" (1 = next up). Null when processing or completed. Use this to estimate wait time and show queue status to your users.
processing_time Total processing time in seconds (available when completed).
બહુભાષી બેચ

એક જ સમયે ઘણાબધા ભાષાઓમાં ઘણાબધા લખાણનું ભાષાંતર કરો:

{
    "texts": ["Hello", "Goodbye"],
    "target_languages": ["es", "fr"],
    "source_language": "en"
}
સમાપ્ત થયેલ પરિણામ માહિતી (_d)
{
    "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, બંને નહિં.

Best Practices for Large Workloads
  • Send 1 target language per batch request. This keeps each batch fast and makes progress easy to track.
  • Keep batches at 50-100 texts. Smaller batches complete faster and give you more frequent progress updates.
  • Submit as many batch jobs as you need — our GPU cluster auto-scales to handle demand. Jobs are processed in parallel across multiple instances.
  • On timeout, re-poll the same job_id instead of submitting a new batch. The original job may still be processing on the GPU.
  • Poll every 3-5 seconds. More frequent polling does not speed up processing.

દસ્તાવેજ ભાષાંતર

સંપૂર્ણ દસ્તાવેજોનું ભાષાંતર કરો જ્યારે બંધારણને સંગ્રહો. ઘણાબધા ફાઇલ બંધારણોને આધાર આપે છે.

POST https://api.translateapi.ai/api/v1/translate/document/
વિનંતી (બહુભાગી/ફોર્મ-માહિતી)
પરિમાણો પ્રકાર જરૂરી વર્ણન
file file હા ભાષાંતર કરવા માટેનું દસ્તાવેજ (મહત્તમ ૧૦MB)
target_language string હા Target language code (e.g., "es", "fr", "de")
source_language string નહી Source language code. Default: "auto" (auto-detect)
આધારભૂત ફાઇલ પ્રકારો
Documents
  • .txt - સાદા લખાણ ફાઇલો
  • .docx - વર્ડ દસ્તાવેજો
  • .pdf - PDF દસ્તાવેજો (સ્કેન થયેલને સમાવતા)
Data & Localization
  • .json - JSON ફાઇલો (શબ્દમાળા કિંમતોનું અનુવાદ કરે છે)
  • .xml - XML ફાઇલો
  • .srt - ઉપશીર્ષક ફાઇલો
  • .po / .pot - Gettext ભાષાંતર ફાઇલો
Images (OCR)
  • .jpg / .jpeg - JPEG ચિત્રો (OCR)
  • .png - PNG ચિત્રો (OCR)
  • .tiff / .tif - TIFF ચિત્રો (OCR)
  • .bmp - BMP ચિત્રો (OCR)
  • .webp - WebP ચિત્રો (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"
જવાબ
{
    "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"
}
OCR આધાર: ચિત્ર ફાઇલો અને સ્કેન થયેલ PDFs ઓપ્ટીકલ અક્ષર ઓળખ (OCR) સાથે પ્રક્રિયા કરેલ છે લખાણને ભાષાંતર કરતા પહેલા બહાર કાઢવા માટે. શ્રેષ્ઠ પરિણામો માટે, સ્પષ્ટ, ઉચ્ચ-રીઝોલ્યુશન ચિત્રો વાપરો.
GET https://api.translateapi.ai/api/v1/translate/document/{id}/

દસ્તાવેજ ભાષાંતરની સ્થિતિ ચકાસો અથવા ડાઉનલોડ URL મેળવો.

સ્થિતિ કિંમતો
pending ફાઇલ અપલોડ થયેલ છે, પ્રક્રિયા કરવા માટે રાહ જુએ છે
processing અનુવાદ પ્રગતિમાં છે
completed અનુવાદ સમાપ્ત, ડાઉનલોડ ઉપલબ્ધ છે
failed ભાષાંતર નિષ્ફળ (error_message ચકાસો)

આધારભૂત ભાષાઓ

બધી આધારભૂત ભાષાઓની યાદી મેળવો.

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"},
        ...
    ]
}

View All 186 Languages

Submit Corrections

Suggest a better translation for a given source text. Corrections enter a moderation queue; once approved by our team they surface as "Community Verified" translations for that text.

Note: this endpoint is served from the main domain https://translateapi.ai/api/v1/ (not the api. translation host), and requires an API key.
POST https://translateapi.ai/api/v1/suggestions/
વિનંતી બોડી
Parameter પ્રકાર વર્ણન
source_text string The original text that was translated.
source_language string Source language code (e.g. "en").
target_language string Target language code (e.g. "es").
machine_translation string The machine translation you are correcting.
suggested_translation string Your improved translation (must differ from machine_translation).
Example Request
curl -X POST https://translateapi.ai/api/v1/suggestions/ \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
    "source_text": "Hello, world!",
    "source_language": "en",
    "target_language": "es",
    "machine_translation": "Hola, mundo!",
    "suggested_translation": "¡Hola, mundo!"
}'
જવાબ
{
    "id": 4213,
    "status": "pending",
    "created": true,
    "message": "Correction submitted for review."
}

Re-submitting the same source/language pair updates your existing suggestion instead of creating a duplicate (returns 200 with "created": false).

ભાષાંતર મોડેલો

અમે આપણા પોતાના GPU ઇન્ફ્રાસ્ટ્રક્ચર પર ચાલતા state-of-the-art ઓપન સ્ત્રોત અનુવાદ મોડેલો વાપરીએ છીએ. બધા મોડેલો વાણિજ્યિક લાઇસન્સ ધરાવે છે (Apache 2.0).

મોડેલ ભાષાઓ માટે શ્રેષ્ઠ
Helsinki-NLP/opus-mt 50+ ભાષા જોડાણો સામાન્ય ભાષાઓ (EN, ES, FR, DE, IT, PT, RU, ZH, JA, વગેરે)
Google MADLAD-400 400+ ભાષાઓ અસામાન્ય ભાષાઓ, વિસ્તૃત કવરેજ

API આપોઆપ તમારી ભાષા જોડી માટે શ્રેષ્ઠ મોડેલ પસંદ કરે છે. તમે વૈકલ્પિક રીતે સ્પષ્ટ કરી શકો છો engine પરિમાણ:

એન્જિન વર્ણન
"auto" મૂળભૂત. HuggingFace પહેલેથી પ્રયત્ન કરે છે, MADLAD-400 પર પાછા ફરે છે
"huggingface" HuggingFace/MarianMT દબાણ કરો (ઝડપી, ૫૦+ ભાષાઓ)
"madlad" MADLAD-400 દબાણ કરો (400+ ભાષાઓ)

ભૂલ સંભાળનાર

API સફળતા અથવા નિષ્ફળતા દર્શાવવા માટે પ્રમાણભૂત HTTP સ્થિતિ કોડો વાપરે છે.

કોડ વર્ણન
200 સફળતા
202 Accepted — Batch job queued successfully
400 Bad Request — Invalid parameters (missing text, unsupported language, etc.)
401 અયોગ્ય - અયોગ્ય અથવા ગુમ થયેલ API કી
402 Payment Required — Character credits exhausted. Upgrade your plan or purchase a top-up.
403 Forbidden — API key lacks required scope or IP not in whitelist
503 સેવા ઉપલબ્ધ નથી - ભાષાંતર એન્જિન કામચલાઉ રીતે નીચે છે
ભૂલ જવાબ બંધારણ
{
    "error": "insufficient_credits",
    "credits_remaining": 0
}

Usage Limits

TranslateAPI has no request rate limits. All requests are queued and processed by our auto-scaling GPU cluster. Your plan determines your monthly character allowance:

પ્લાન અક્ષરો/મહિનો Batch API Documents કિંમત
મુક્ત 250,000 — — $0 મફત નોંધણી કરો
શરુ કરનાર 2,500,000 $9/મહિનો ઉમેદવારી નોંધાવો
પ્રોફેશનલ 10,000,000 $29/મહિનો ઉમેદવારી નોંધાવો
વ્યવસાય 40,000,000 $79/મહિનો ઉમેદવારી નોંધાવો
માપન 125,000,000 $199/મહિનો ઉમેદવારી નોંધાવો
Enterprise Unlimited $499/મહિનો Contact Sales

જ્યારે તમે તમારી મર્યાદાને વટાવો છો, ત્યારે તમને એક પ્રાપ્ત થશે 402 Payment Required આગળના મહિના સુધી અથવા તમે સુધારો કરો ત્યાં સુધી પ્રત્યુત્તર.

Auto-Scaling Cloud Infrastructure

TranslateAPI runs on dedicated NVIDIA A100 GPU instances with automatic horizontal scaling. When demand increases, additional GPU instances are launched within minutes to maintain fast response times. All requests are queued and processed — send hundreds of concurrent requests and they'll all be handled. Real-time translations get priority, batch jobs process in the background.

Need More Credits?

Run out of characters mid-month? Purchase a one-time credit top-up without changing your plan. View top-up packs

આ પાનાંને દર આપો
તમારી રેટિંગ માટે આભાર!
/5 આ પર આધારિત રેટિંગ્સ