翻訳API
スクリプトからEdgepedia 翻訳にお手元の文書を送信し、翻訳結果を取得できます。翻訳ページと同じサービスを同じ料金で利用でき、クレジットも共通です。
APIキーの取得
翻訳ページでAPIキーを作成します。ログインし、右上のアカウントを開いて、「APIキー」の「作成」を選択してください。
すべてのリクエストにAuthorization: Bearer ept_…としてAPIキーを付けて送信してください。APIキーを持っている人は誰でもあなたのクレジットを使えるため、他人に知られないように保管してください。
料金
- 標準:250語あたり1クレジット(最低1クレジット)。
- Pro:75語あたり1クレジット(最低2クレジット)。
- 翻訳元と翻訳先がどちらも英語以外の場合、料金は2倍になります。
- 100クレジット = 1 USD。
翻訳に失敗した場合、クレジットは返還されます。
ルート
ベースURL:https://translate.edgepedia.ai。リクエストとレスポンスはJSON形式で、エラーは{"error": "…"}です。
GET /api/v1/languages
言語の一覧と、各言語でProを利用できるかどうかを返します。
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/languages
GET /api/v1/balance
クレジット残高を返します。
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/balance
POST /api/v1/quote
翻訳を開始せずに、料金と予想所要時間を取得します。modeはstandardまたはproです。
見積もりには"source": "auto"も指定できます。その場合、レスポンスの"source"に検出された言語が入り、"detected": trueが付きます。翻訳は、その言語コードを指定して開始します。
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard"}' \
https://translate.edgepedia.ai/api/v1/quote
POST /api/v1/translations
テキスト、または10 MBまでの.txt、.md、.docx、.pdfファイルの翻訳を開始します。"expect_credits"を追加すると、料金が想定と異なる場合にリクエストが拒否されます(409)。"wait"を追加すると、最大120秒待機し、同じレスポンスで完成した翻訳を取得できます。
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard", "wait": 60}' \
https://translate.edgepedia.ai/api/v1/translations
curl -H "Authorization: Bearer $KEY" -F file=@report.docx -F source=en -F target=ar -F mode=standard \
https://translate.edgepedia.ai/api/v1/translations
GET /api/v1/translations/{id}
翻訳の状態(queued、running、done、failedのいずれか)と、完了している場合は翻訳文を返します。失敗した場合は理由を返します。完了した翻訳は30日間取得できます。
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations/$ID
GET /api/v1/translations/{id}/download
ファイルの翻訳結果を返します。.docxと.pdfファイルは.docx形式、.txtと.mdファイルはテキストで返します。
curl -H "Authorization: Bearer $KEY" -o translated.docx https://translate.edgepedia.ai/api/v1/translations/$ID/download
GET /api/v1/translations
翻訳を新しい順に最大50件返します。
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations
ステータスコード
| コード | 意味 |
|---|---|
| 200 | OK。waitを指定して開始した場合は、翻訳が完了または失敗しています。 |
| 202 | 翻訳を開始したか、waitによる待機後も処理が続いています。 |
| 400 | 送信されたリクエストのままでは翻訳できません。理由はエラーに示されます。 |
| 401 | APIキーが指定されていないか、不明なキー、または無効化済みのキーです。 |
| 402 | クレジットが不足しています。 |
| 404 | アカウント内に該当する翻訳がありません。 |
| 409 | 料金がexpect_creditsと異なります。料金は請求されていません。 |
| 413 | ファイルが10 MBを超えています。 |
| 429 | 1分間のリクエスト数が60件を超えました。Retry-Afterに示された秒数が経過してから再試行してください。 |