API

既存のプロジェクトにMultillectの翻訳機能を付加するためのAPIを公開しています。当翻訳システムは、使用回数毎に翻訳品質が改善します。尚、使用価額は文字数を基に計算されており、百万字当り$5となります。

翻訳のご希望の方は、https://api.multillect.com/translate/json/1.0/<account-id><account-id> は各使用客の固有識別子にHTTP要求をご送信下さい。

使用可能なメソッド: GET及びPOST.
応答形式: JSON
応答エンコーディング: UTF-8

要求パラメーター:

パラメーター 必須 説明
method 「translate/api/translate」のみ
from 原言語。不設定の場合は、 Multillect システムが自動的に判定し、判定結果を応答の「language」フィルドで提供されます。
to 目的言語
text 翻訳対象となるUTF-8にエンコードされた文字列(2文字以上)
politeness 丁寧度。例:だ体/ます体
   

意味
polite ます体
rude だ体
gender_from 話し手の性別
   
意味
male 男性
female 女性
gender_to 話し相手の性別( gender_from を参照)
sig 秘密キー

言語一覧:

言語 コード
アラビア語 ar
英語 en
スペイン語 es
中国語 zh
韓国語 ko
ドイツ語 de
ロシア語 ru
トルコ語 tr
ウクライナ語 uk
フランス語 fr
日本語 ja
ポーランド語 pl
ペルシア語 fa
ヒンディー語 hi
カザフ語 kk
ポルトガル語 pt

応答

応答は下記のプロパティーを有するJSONオブジェクトです:

プロパティー 説明
result 結果オブジェクト(エラーの場合は「null」)
 
プロパティー
説明
translated 翻訳文
language 原言語判定結果
politeness 丁寧度判定結果(要求パラメーター「politeness」を参照)
error 「null」又はエラーオブジェクト
 
プロパティー 説明
code エラー・コード
message エラーメッセージ

例 1 (en->ja対訳)

GET https://api.multillect.com/translate/json/1.0/2711024?method=translate/api/translate&from=en&to=ja&text=test&sig=38f4c080a05411e6a0328c89a5a1fd3

{
    "result": {
        "translated": "テスト",
        "language": {
            "code": null
        }
    }
    "error": null,
    "timestamp": 1478019472,
    "id": null
}

例 2 (原言語判定)

GET https://api.multillect.com/translate/json/1.0/2711024?method=translate/api/translate&to=ja&text=test&sig=38f4c080a05411e6a0328c89a5a1fd3

{
    "result": {
        "translated": "テスト",
        "language": {
            "code": "en"
        }
    }
    "error": null,
    "timestamp": 1478019472,
    "id": null
}

例 3 (エラー状況)

GET https://api.multillect.com/translate/json/1.0/2711024?method=translate/api/translate&from=en&to=ja&text=&sig=38f4c080a05411e6a0328c89a5a1fd3

{
    "result": null,
    "error": {
        "code": 15,
        "message": "Too short text for translation"
    },
    "timestamp": 1478022138,
    "id": null
}

例 4 (文体判定)

GET https://api.multillect.com/translate/json/1.0/2711024?method=translate/api/translate&from=ru&to=en&text=Вы%20великолепны&politeness=&sig=38f4c080a05411e6a0328c89a5a1fd3

{
  "result": {
    "translated": "You are magnificent",
    "language": {
      "code": "ru"
    },
    "politeness": "polite"
  },
  "error": null,
  "timestamp": 1478284482,
  "id": null
}