Equalang は何をしますか？
ファイルを指定すると、アップロード、ジョブの待機、結果を元のファイルの隣に書き出します。パスが返され、ファイルの内容は返されません。レイアウト、表、画像、数式はそのまま保持され、大きなデータが会話に入ることはありません。
作業はユーザーのクレジットを消費します。translateまたはtranscribeの前に、コストとユーザーの同意を得てください。 estimateはファイルのクレジット数を無料で表示します。
セットアップ
キーは1行EQUALANG_API_KEY=el_...で、~/.config/equalang/.env（$XDG_CONFIG_HOMEが設定されている場合はその下）に保存します：マシンごとに1ファイル、Equalang MCPサーバーと共有され、このスキルを再インストールまたは更新しても保持されます。ユーザーは https://equalang.com/api-keys でキーを作成します。
dir="${XDG_CONFIG_HOME:-$HOME/.config}/equalang"
mkdir -p "$dir" && (umask 077 && echo 'EQUALANG_API_KEY=el_...' > "$dir/.env")
環境変数EQUALANG_API_KEYはファイルよりも優先されます。キーがない場合、すべてのコマンドはキーの取得方法と保存場所を返します。キーを自分で作成しないでください。ユーザーに尋ねてください。
コマンド
このスキルのディレクトリから実行します。python3のみが必要です。各コマンドは1つのJSONオブジェクトを出力します。--helpでコマンドのフラグを表示します。
# いくらかかるか？アップロードは行いますが、何も開始しません。無料です。`kept_until`はアップロードが保持される期間を示します。
python3 scripts/equalang.py estimate report.pdf
# -> {"file_id": "...", "credits_to_translate": 12.34, "credits_to_transcribe": null, ...}
# ファイルを翻訳します。パス、パブリックURL（Equalangがフェッチ）、またはestimateからの--file-idを指定します。
python3 scripts/equalang.py translate report.pdf --to zh-CN
python3 scripts/equalang.py translate --file-id <file_id> --to zh-CN # 2回目のアップロードなし
python3 scripts/equalang.py translate https://example.com/deck.pptx --to ja -o ./out
# 録音：翻訳された字幕、または話された言語での文字起こし。
python3 scripts/equalang.py translate talk.mp4 --to en --bilingual --format srt --format txt
python3 scripts/equalang.py transcribe interview.mp3 --format srt --format txt
# 文字列をバルクで（それぞれ個別に翻訳。最大50個、各5000文字、1回の呼び出しで20000文字まで）。
python3 scripts/equalang.py text "Save changes" "Delete project" --to de
# 1つの長いプレーンテキスト - 記事、メモ、.mdファイル - 最大100,000文字。Equalangが文単位で分割します。自分で分割しないでください。
python3 scripts/equalang.py text --file notes.md --to ja -o notes.ja.md
# ジョブを再度確認する・停止する・残高照会・言語コード（キー不要）
python3 scripts/equalang.py status <job_id> -o ./out
python3 scripts/equalang.py cancel <job_id>
python3 scripts/equalang.py balance
python3 scripts/equalang.py languages chinese
出力の読み方
完了したジョブはoutputs（それぞれにpathあり）とcredits_chargedを出力します。両方をユーザーに伝えてください。特に要求がない限り、生成されたファイルを読み返して要約しないでください：それは完全なドキュメントであり、パスの目的はその内容を会話から遠ざけることです。
失敗時は{"error", "code", "retryable"}を出力し、終了コード1で終了します。retryableがtrueの場合のみ再試行してください。INSUFFICIENT_CREDITSは、ユーザーが https://equalang.com/pricing でクレジットを追加する必要があることを意味し、再試行しません。
知っておくべきこと
- フォーマット。 ドキュメント：pdf、docx、pptx、xlsx、epub、html、txt。字幕：srt、vtt。画像：jpg、png、webp、bmp。録音：mp3、m4a、wav、flac、ogg、aac、opus、mp4、mov、webm、mkv。最大100MB。
transcribeは録音のみ対応。 - 結果は上書きされません。 ローカルソースの隣（または
-o DIR、URLの場合はカレントディレクトリ）にEqualangが付けた名前で保存され、既存の名前がある場合は(1)が付加されます。完了したジョブに再度statusを実行すると、ファイルをコピーせずに既に書き込んだファイル名を表示します。 - 長いファイルは秒ではなく分単位です。 コマンドは待機し、進行状況をstderrに出力します。割り込んでもジョブはキャンセルされません：
status <job_id>で再開し、cancel <job_id>で停止します。キャンセルまたは失敗したジョブは課金されません。 - 録音は実際に聞こえた音声に対して課金されます - 無音や音楽は課金されないため、通常
estimateよりも低くなります。ドキュメントはestimateの通りのコストです。 - 言語コード は
en、zh-CN、zh-TW、ja、ptのようになります。ライブAPIから読み取られ、メモリからは読み取られません：languagesはファイルが受け付ける言語を、languages --kind textはtextが受け付けるより広いセットを、languages chineseは名前で検索します。--source-languageを省略すると自動検出されます。 - 複数のファイル？ それぞれを見積もり、合計を計算し、1回だけ承認を求めます。独自の判断でフォルダをループしないでください。
- この背後にあるAPI（スクリプトが行わないことに対応）：https://equalang.com/llms.txt