edgepedia 翻訳

翻訳API

スクリプトからEdgepedia 翻訳にお手元の文書を送信し、翻訳結果を取得できます。翻訳ページと同じサービスを同じ料金で利用でき、クレジットも共通です。

APIキーの取得

翻訳ページでAPIキーを作成します。ログインし、右上のアカウントを開いて、「APIキー」の「作成」を選択してください。

すべてのリクエストにAuthorization: Bearer ept_…としてAPIキーを付けて送信してください。APIキーを持っている人は誰でもあなたのクレジットを使えるため、他人に知られないように保管してください。

料金

翻訳に失敗した場合、クレジットは返還されます。

ルート

ベース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

ステータスコード

コード意味
200OK。waitを指定して開始した場合は、翻訳が完了または失敗しています。
202翻訳を開始したか、waitによる待機後も処理が続いています。
400送信されたリクエストのままでは翻訳できません。理由はエラーに示されます。
401APIキーが指定されていないか、不明なキー、または無効化済みのキーです。
402クレジットが不足しています。
404アカウント内に該当する翻訳がありません。
409料金がexpect_creditsと異なります。料金は請求されていません。
413ファイルが10 MBを超えています。
4291分間のリクエスト数が60件を超えました。Retry-Afterに示された秒数が経過してから再試行してください。