Dokumentasi RifqyTranslatePro API

RifqyTranslatePro Developer API menyediakan antarmuka terjemahan teks cerdas berbasis model bahasa alami tingkat lanjut (LLM). Layanan ini dirancang untuk menghasilkan terjemahan natural berkualitas tinggi dengan mempertahankan makna kontekstual dan gaya bahasa penutur asli.

Multi-Provider Router

Dukungan terintegrasi untuk Google AI Studio, Alibaba Cloud DashScope, dan OpenRouter.

Human-Like Phrasing

Optimalisasi instruksi sistem khusus untuk menghasilkan terjemahan setara DeepL tanpa redaksi kaku.

Autentikasi

Setiap permintaan ke API harus menyertakan Kunci Akses (API Key) valid di dalam header HTTP Authorization menggunakan skema Bearer. Kunci dapat diperoleh langsung melalui Tab API pada antarmuka aplikasi utama.

Format Header: Authorization: Bearer rt_live_xxxxxxxxxxxxxxxxxxxxxxxx

Base URL & Protokol

Semua permintaan API dilayani melalui protokol HTTPS dengan format muatan (payload) JSON standar.

https://translate.rifqydev.my.id/api/v1

POST

/translate

Memproses teks input dan mengembalikan hasil terjemahan berdasarkan bahasa sumber, bahasa target, dan model AI yang ditentukan.

Parameter Request (JSON Body)

Field	Tipe	Status	Keterangan
text	string	Wajib	Teks mentah yang akan diterjemahkan.
source_lang	string	Opsional	Kode ISO bahasa sumber (contoh: `id`, `en`). Default: `auto`.
target_lang	string	Opsional	Kode ISO bahasa tujuan. Default: `id`.
tone	string	Opsional	Gaya penyampaian bahasa (`natural`, `formal`, `casual`). Default: `natural`.
model	string	Opsional	Pengenal spesifik model AI. Default: `gemini-3.5-flash-lite`.

Model AI yang Didukung

Value Parameter	Infrastruktur	Karakteristik
gemini-3.5-flash-lite	Google AI Studio	Latensi minimal, efisien untuk teks panjang.
gemini-3.8-flash	Google AI Studio	Kemampuan reasoning dan multi-modal tingkat tinggi.
qwen3.7-plus-2026-05-26	Alibaba Cloud (Singapore)	Akurasi tinggi pada konteks bahasa Asia dan terminologi teknis.
poolside/laguna-s-2.1:free	OpenRouter	Model terjemahan bahasa umum tanpa biaya tambahan.
poolside/laguna-xs-2.1:free	OpenRouter	Varian mikro hemat resource untuk kalimat pendek.
nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free	OpenRouter	Analisis konteks kalimat kompleks dan idiomatis.

Struktur Response (200 OK)

{
  "success": true,
  "data": {
    "translations": [
      {
        "translated_text": "Rapat dibatalkan karena hujan lebat.",
        "source_lang": "en",
        "target_lang": "id",
        "model_used": "gemini-3.5-flash-lite"
      }
    ],
    "usage": {
      "characters_billed": 43,
      "total_used": 15420,
      "quota_remaining": 84580
    }
  }
}

Contoh Implementasi

cURL

curl -X POST https://translate.rifqydev.my.id/api/v1/translate \
  -H "Authorization: Bearer rt_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "The quick brown fox jumps over the lazy dog.",
    "source_lang": "en",
    "target_lang": "id",
    "model": "gemini-3.5-flash-lite",
    "tone": "natural"
  }'

JavaScript (Fetch / Node.js)

const translateText = async () => {
  const response = await fetch("https://translate.rifqydev.my.id/api/v1/translate", {
    method: "POST",
    headers: {
      "Authorization": "Bearer rt_live_YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      text: "The quick brown fox jumps over the lazy dog.",
      source_lang: "en",
      target_lang: "id",
      model: "qwen3.7-plus-2026-05-26"
    })
  });

  const result = await response.json();
  if (result.success) {
    console.log("Hasil:", result.data.translations[0].translated_text);
    console.log("Sisa Kuota:", result.data.usage.quota_remaining);
  } else {
    console.error("Kesalahan:", result.error);
  }
};

translateText();

Python (Requests)

import requests

url = "https://translate.rifqydev.my.id/api/v1/translate"
headers = {
    "Authorization": "Bearer rt_live_YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "text": "The quick brown fox jumps over the lazy dog.",
    "source_lang": "en",
    "target_lang": "id",
    "model": "gemini-3.5-flash-lite"
}

response = requests.post(url, headers=headers, json=payload)
data = response.json()

if response.status_code == 200 and data.get("success"):
    translated = data["data"]["translations"][0]["translated_text"]
    print("Hasil Terjemahan:", translated)
else:
    print("Error:", data.get("error"))

Kuota & Batas Penggunaan

Setiap request akan memotong kuota karakter terdaftar sesuai panjang parameter text yang dikirim. Kuota diatur secara otomatis berdasarkan tingkat paket akun pengembang:

Free Developer Tier

100.000 Karakter

Disediakan secara gratis untuk seluruh pengguna terdaftar untuk pengujian dan integrasi awal.

Pro / Lifetime Tier

2.500.000 Karakter

Diberikan otomatis kepada pemegang voucher PRO atau LIFETIME dengan prioritas eksekusi server.

Kode Status HTTP

Layanan menggunakan kode respon HTTP standar untuk menandakan status keberhasilan atau kegagalan pemrosesan permintaan.

Kode	Arti	Penyebab
200 OK	Permintaan Berhasil	Teks berhasil diproses dan diterjemahkan.
400 Bad Request	Parameter Tidak Valid	Parameter `text` kosong atau muatan JSON tidak valid.
401 Unauthorized	Autentikasi Gagal	Header Authorization hilang, format tidak sesuai, atau API Key tidak aktif.
429 Too Many Requests	Kuota Habis	Jumlah karakter yang diminta melampaui batas kuota paket akun.
500 Server Error	Kesalahan Internal	Gagal terhubung ke upstream AI model atau kesalahan konfigurasi database.