APIリファレンス

RAVIRA APIを使うと、用語を一貫させながら、プロ品質の翻訳をプログラムから利用できます。Bearerトークンで認証し、数分で翻訳を始められます。

ベースURLhttps://ravira.dev/api/v1

クイックスタート

最初の翻訳までの3ステップ：

1. 次のページでアカウントを作成します ravira.dev/register
2. 文字数パックを購入し、次のページでAPIキーを生成します設定 → API
3. 最初のリクエストを送信します：

curl -X POST https://ravira.dev/api/v1/translate \
  -H "Authorization: Bearer rk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello, world!", "source_lang": "en", "target_lang": "ro"}'

レスポンス：

{
  "translated_text": "Bună ziua, lume!",
  "characters_charged": 13,
  "source_lang": "en",
  "target_lang": "ro"
}

認証

すべてのAPIリクエストには、次のヘッダーにBearerトークンが必要です Authorization APIキーは、次の文字列で始まります rk_live_ APIキーはアカウント設定で生成できます。

重要： APIキーが表示されるのは作成時の一度だけです。安全に保管してください。再発行はできません。

Authorization: Bearer rk_live_YOUR_API_KEY

エンドポイント

POST/api/v1/translate

テキストを翻訳します。認証が必要です。翻訳に成功すると文字数が課金されます。

パラメーター	型	必須	説明
テキスト	文字列	はい	翻訳するテキスト（最大100,000文字）
source_lang	文字列	いいえ	原始言語コード。デフォルト： `auto`
target_lang	文字列	いいえ	目標言語コード。デフォルト： `en`

GET/api/v1/usage

現在の文字数残高と使用状況を返します。認証が必要です。

curl https://ravira.dev/api/v1/usage \
  -H "Authorization: Bearer rk_live_YOUR_API_KEY"

{
  "characters_balance": 500000,
  "characters_used": 12500,
  "characters_expires_at": "2027-01-01T00:00:00"
}

GET/api/v1/languages

対応言語の一覧を返します。認証は不要です。

curl https://ravira.dev/api/v1/languages

コード例

Python

import requests

API_KEY = "rk_live_YOUR_API_KEY"
BASE_URL = "https://ravira.dev/api/v1"

def translate(text, target_lang="ro", source_lang="auto"):
    response = requests.post(
        f"{BASE_URL}/translate",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={"text": text, "source_lang": source_lang, "target_lang": target_lang}
    )
    response.raise_for_status()
    return response.json()["translated_text"]

result = translate("Hello, world!", target_lang="ro")
print(result)  # Bună ziua, lume!

JavaScript

const API_KEY = "rk_live_YOUR_API_KEY";
const BASE_URL = "https://ravira.dev/api/v1";

async function translate(text, targetLang = "ro", sourceLang = "auto") {
  const response = await fetch(`${BASE_URL}/translate`, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ text, source_lang: sourceLang, target_lang: targetLang }),
  });
  if (!response.ok) throw new Error(`HTTP ${response.status}`);
  const data = await response.json();
  return data.translated_text;
}

const result = await translate("Hello, world!", "ro");
console.log(result); // Bună ziua, lume!

エラーコード

HTTP	エラーコード	説明
401	invalid_api_key	APIキーがないか、無効または取り消されています。
402	insufficient_balance	アカウントに残り文字数がありません。ravira.dev/topup で追加購入してください。
429	rate_limit_exceeded	リクエストが多すぎます。速度を落とし、retry_after の値（秒）を待ってから再試行してください。
400	validation_error	リクエストパラメーターが無効です。
500	server_error	内部サーバーエラーです。少し時間をおいてから再試行してください。

レート制限

レート制限は アカウント単位で適用されます。ではなく、

毎分60リクエスト すべてのAPIキーを通じたアカウントあたり
上限を超えると、APIは HTTP 429 （秒）フィールドを含む retry_after フィールド（秒）
最大 5個のAPIキー プロジェクトを整理するため、アカウントあたり

使用例

Eコマース

多言語の商品掲載

AmazonやeBayの販売者は、商品情報を5言語で自動的に掲載したいと考えています。言語ごとにAPIを1回呼び出すだけで、すべての市場で用語を統一できます。

import requests

API_KEY = "rk_live_YOUR_API_KEY"
BASE_URL = "https://ravira.dev/api/v1"

def translate_product(product):
    languages = {"ro": "Romanian", "de": "German", "fr": "French", "es": "Spanish"}
    translations = {}
    for lang_code, lang_name in languages.items():
        response = requests.post(
            BASE_URL + "/translate",
            headers={"Authorization": "Bearer " + API_KEY},
            json={"text": product["title"] + "

" + product["description"],
                  "source_lang": "en", "target_lang": lang_code}
        )
        translations[lang_code] = response.json()["translated_text"]
    return translations

product = {
    "title": "Wireless Noise-Cancelling Headphones",
    "description": "Premium over-ear headphones with 30-hour battery."
}
result = translate_product(product)

SaaS

ローカライズされたユーザー通知

SaaSプラットフォームでは、新規ユーザーが優先する言語を設定すると、すべての通知テンプレートが翻訳されます。固定の翻訳ファイルは不要。常に最新の状態に保たれる動的な翻訳です。

const API_KEY = "rk_live_YOUR_API_KEY";
const BASE_URL = "https://ravira.dev/api/v1";

async function localizeNotifications(userId, targetLang) {
  const templates = {
    welcome: "Welcome to our platform! Your account is ready.",
    trial_ending: "Your free trial ends in 3 days.",
    payment_success: "Payment confirmed. Thank you!",
    usage_alert: "You have used 80% of your monthly quota."
  };
  const localized = {};
  for (const [key, text] of Object.entries(templates)) {
    const res = await fetch(BASE_URL + "/translate", {
      method: "POST",
      headers: {
        "Authorization": "Bearer " + API_KEY,
        "Content-Type": "application/json"
      },
      body: JSON.stringify({ text, source_lang: "en", target_lang: targetLang })
    });
    localized[key] = (await res.json()).translated_text;
  }
  return localized;
}

// New user from Romania
localizeNotifications("user_123", "ro").then(t => {
  console.log(t.welcome);
});

法務

契約書の事前翻訳

法律事務所は外国語の契約書を受け取り、認定翻訳者に送る前に迅速な事前翻訳を必要としています。法律用語を統一することで、レビュー時間を短縮できます。

import requests

API_KEY = "rk_live_YOUR_API_KEY"
BASE_URL = "https://ravira.dev/api/v1"

def pretranslate_contract(contract_text, source_lang):
    """Pre-translate a contract for internal review."""
    response = requests.post(
        BASE_URL + "/translate",
        headers={"Authorization": "Bearer " + API_KEY},
        json={
            "text": contract_text,
            "source_lang": source_lang,
            "target_lang": "en"
        }
    )
    return response.json()["translated_text"]

# Translate a German contract for English-speaking lawyers
with open("vertrag_2026.txt", "r") as f:
    german_contract = f.read()

english_draft = pretranslate_contract(german_contract, "de")
print("Pre-translation ready for legal review.")
print(english_draft[:200])

ジャーナリズム

国際ニュースのモニタリング

報道機関は海外の情報源を監視し、関連する記事を自動で翻訳して編集者に提供します。毎時、定期ジョブとして実行されます。

import requests
import schedule
import time

API_KEY = "rk_live_YOUR_API_KEY"
BASE_URL = "https://ravira.dev/api/v1"

def translate_article(article, source_lang):
    response = requests.post(
        BASE_URL + "/translate",
        headers={"Authorization": "Bearer " + API_KEY},
        json={"text": article, "source_lang": source_lang, "target_lang": "en"}
    )
    return response.json()["translated_text"]

def monitor_and_translate():
    # Fetch articles from your news source here
    articles = [
        {"text": "Neue Wirtschaftsdaten zeigen starkes Wachstum...", "lang": "de"},
        {"text": "Les negociations commerciales reprennent...", "lang": "fr"},
    ]
    for article in articles:
        translated = translate_article(article["text"], article["lang"])
        print("Translated:", translated[:80] + "...")

# Run every hour
schedule.every().hour.do(monitor_and_translate)
monitor_and_translate()  # Run immediately on start

人事

多言語の求人情報

ヨーロッパ各地で求人を掲載する企業は、求人情報を自動的に翻訳できます。英語の原文から、数秒で6言語に翻訳して公開できます。

const API_KEY = "rk_live_YOUR_API_KEY";
const BASE_URL = "https://ravira.dev/api/v1";

const TARGET_MARKETS = ["de", "fr", "es", "it", "pl", "ro"];

async function publishJobPosting(jobDescription) {
  const postings = {};
  for (const lang of TARGET_MARKETS) {
    const res = await fetch(BASE_URL + "/translate", {
      method: "POST",
      headers: {
        "Authorization": "Bearer " + API_KEY,
        "Content-Type": "application/json"
      },
      body: JSON.stringify({
        text: jobDescription,
        source_lang: "en",
        target_lang: lang
      })
    });
    postings[lang] = (await res.json()).translated_text;
  }
  console.log("Published in " + Object.keys(postings).length + " languages");
  return postings;
}

const job = "Senior Backend Engineer. Remote. Competitive salary.";
publishJobPosting(job);

技術

ソフトウェアのドキュメント

開発者向けツールは、海外のユーザーにも利用してもらえるよう、ドキュメントを翻訳します。コードブロックには手を加えず、Markdownファイルを翻訳します。

import requests
import re

API_KEY = "rk_live_YOUR_API_KEY"
BASE_URL = "https://ravira.dev/api/v1"

def translate_markdown(md_text, target_lang):
    """Translate markdown, preserving code blocks."""
    # Extract code blocks before translation
    code_blocks = {}
    def save_code(match):
        key = f"CODE_BLOCK_{len(code_blocks)}"
        code_blocks[key] = match.group(0)
        return key
    protected = re.sub(r"```[\s\S]*?```", save_code, md_text)
    # Translate text only
    response = requests.post(
        BASE_URL + "/translate",
        headers={"Authorization": "Bearer " + API_KEY},
        json={"text": protected, "source_lang": "en", "target_lang": target_lang}
    )
    translated = response.json()["translated_text"]
    # Restore code blocks
    for key, block in code_blocks.items():
        translated = translated.replace(key, block)
    return translated

with open("README.md") as f:
    readme = f.read()
translated_readme = translate_markdown(readme, "ro")
print(translated_readme[:300])

医療

患者受付フォーム

医療機関は、海外からの患者向けに受付フォームを翻訳します。院内での利用と患者の安心のために使用し、診療上の判断を行う前に、必ず資格を持つ医療スタッフが確認します。

import requests

API_KEY = "rk_live_YOUR_API_KEY"
BASE_URL = "https://ravira.dev/api/v1"

def translate_intake_form(form_data, patient_lang):
    """
    Translate patient intake form for non-English speaking patients.
    For internal use only. Always reviewed by qualified medical staff.
    """
    fields_to_translate = [
        "chief_complaint", "medical_history", "current_medications", "allergies"
    ]
    translated = {}
    for field in fields_to_translate:
        if field in form_data:
            response = requests.post(
                BASE_URL + "/translate",
                headers={"Authorization": "Bearer " + API_KEY},
                json={
                    "text": form_data[field],
                    "source_lang": patient_lang,
                    "target_lang": "en"
                }
            )
            translated[field] = response.json()["translated_text"]
    return translated

patient_form = {
    "chief_complaint": "Durere puternica in piept de 2 zile",
    "allergies": "Penicilina, Ibuprofen"
}
english_form = translate_intake_form(patient_form, "ro")
print("For medical staff review:", english_form)

今すぐ始めませんか？

数秒でAPIキーを作成できます。初期費用やサブスクリプションは不要。翻訳した文字数分だけお支払いいただきます。

APIキーを取得する

ご質問がありますか？こちらまでお問い合わせください。 humans@ravira.dev