よくある問題
よくある問題Classic Editorベースの長い投稿の翻訳が失敗する

Classic Editorベースの長い投稿の翻訳が失敗する

Classic Editorベースの長い投稿は、最大トークン数が少ないAPIを使用している場合に翻訳が失敗することがあります(例:DeepSeek V3の最大トークン数は8Kのみです)。

原因は、Classic Editorが翻訳対象のHTMLコンテンツを単一のかたまりとして保持しているためです。この文字列が最大トークン数を超えると、リクエストとして送信できなくなります。

その場合、ログに次のエラーメッセージが表示されます:

🔴 ERROR [Query "translate-customposts"] Execution with errors: String to translate exceeds max length of '...': ...

解決策として、以下のいずれかを実施できます:

  • より多くの最大トークン数を提供するAPIサービスに切り替える
  • Gutenbergエディターに切り替え、単一のHTMLコンテンツを複数のGutenberg html ブロックに移行する(各ブロックが8000文字を超えないようにする)

Gutenbergエディターベースの投稿はブロックで構成されており、各ブロックのプロパティを個別に翻訳できます。多数の文字列が複数のリクエストに分割されるため、投稿が長くても問題ありません。