ご利用方法 
すぐにアカウントを発行

無料で試す

ダーク

ライト

TLS1.0/1.1無効化のお知らせ(05/18更新)

TEXT TRANSLATION
同期テキスト翻訳(リアルタイム翻訳エンジン)
同期テキスト翻訳。翻訳終了後、自動的に結果を取得します。
音声翻訳のレスポンスタイムを短縮するため、リアルタイム翻訳エンジンを利用します。
他のエンジンをご利用の場合、「テキスト翻訳(同期)」を参照してください。
Endpoint
Request details
POST
https://translate.rozetta-api.io/api/v1/translate
Header
Header
Description
Content-Type
application/json
accessKey, nonce, signature
「認証方法」をご参照ください。
Body
Key
Required
Description
fieldId
O
分野ID。 リアルタイム翻訳エンジンを利用する場合、「1」に指定してください
text
O
翻訳の原文。 文字列のリストで指定してください。 空文字列を指定しないでください。 配列の各要素の長さは200ワード以内でお願いいたします。 配列内全体のサイズの上限は270KBです。(日本語9万ワード相当)
sourceLang
O
原文の言語。 一部の言語(zh-CN、zh-TWなど)以外はISO 639-1コードで指定します。 言語を自動判定する場合、autoで指定してください。現在英語、日本語、中国語を自動判定できます。 また、すべての対応言語は「言語一覧取得」を参照してください。
contractId
契約のID。 保有する契約が一つのみの場合、指定する必要はございません。 複数保有する場合は、契約IDの指定が必要です。 (利用するAPIが跨がる場合も含めます。例:テキスト翻訳と音声翻訳の契約をそれぞれ保有している場合は、指定が必要。)
targetLang
O
訳文の言語。 一部の言語(zh-CN、zh-TWなど)以外はISO 639-1コードで指定します。 対応の言語は「言語一覧取得」を参照してください。
autoSplit
長文(1000ワード数以上)を自動分割する場合、trueを指定してください。現在英語、日本語、中国語の原文を分割できます。
Request例
{
    "fieldId": "1",
    "text": [
        "This is a pen.",
        "I like apple."
    ],
    "targetLang": "ja",
    "sourceLang": "en"
}
Response
Key
Description
status
成功の場合は「success」、失敗の場合は「failure」 を返します。 ※複数の文章を含む1リクエスト内で、1文でも翻訳失敗した場合、そのリクエスト自体がエラーになります。
taskId
タスクID。 弊社に問い合わせする際に、このIDで問題のある箇所を迅速に特定することができます。
translationResult
翻訳結果(リスト)
sourceText
原文
translatedText
訳文
Response例
{
  "status": "success",
  "data": {
    "taskId": "ae914ccc-8866-43bc-8a26-0a652c4f1819",
    "translationResult": [
      {
        "sourceText": "This is a pen.",
        "translatedText": "これはペンです。"
      },
      {
        "sourceText": "I like apple.",
        "translatedText": "私はりんごが好きです。"
      }
    ]
  }
}
Limitation
制限
Key(accessKey)1つにつき、1分あたりのリクエスト数は「60」までです。超過の場合はエラーとなります。60秒以上の間隔をあけて、再度リクエストを送信してください。

api/v1/translate
「This is a pen.」と「I have an apple.」二文を英語から日本語に翻訳します。
// Define struct of request json body
type TranslateJson struct {
  FieldId string `json:"fieldId"`
  Text []string `json:"text"`
  TargetLang string `json:"targetLang"`
  SourceLang string `json:"sourceLang"`
}

// Post text and get translation results
func PostApiExample(accessKey, secretKey, basePath, nonce string) {
  translatePath := "/api/v1/translate"
    
  signTranslate := MakeHMAC(nonce, translatePath, secretKey)

  testJson := &TranslateJson{
    FieldId: "1",
    Text: []string{"This is a pen.", "I have an apple."},
    TargetLang: "ja", 
    SourceLang: "en",
    ContractId: "your contractId"}
  jsonValue, _ := json.Marshal(testJson)

  client := &http.Client{}
  req, err := http.NewRequest(
    "POST",
    GetFullUrl(basePath, translatePath),
    bytes.NewBuffer([]byte(jsonValue)),
  )
  req.Header.Set("Content-Type", "application/json")
  req.Header.Set("nonce", nonce)
  req.Header.Set("accessKey", accessKey)
  req.Header.Set("signature", signTranslate)
  res, err := client.Do(req)
    
  if err != nil {
    fmt.Printf("The HTTP request failed with error %s\n", err)
  } else {
    data, _ := ioutil.ReadAll(res.Body)
    fmt.Println(string(data))
  }
}
認証については、「認証方法」をご参照ください。
各言語の完全版のサンプルコードをここで参照できます。
©️ 2019 Rozetta API  ・  Powered by Rozetta

株式会社ロゼッタ

^