⚙️ 接続設定ガイド

バックエンドサーバーの設定ガイドです。
初心者の方には「Google翻訳 (GAS)」がおすすめです。

☁️ Google翻訳字幕の作成手順(無料・1日5000回まで)

Google Script Appsの翻訳APIを使用します。PCへのインストール不要で手軽です。
※ Googleアカウントが必要です。
1
GASプロジェクトの作成
普段お使いのブラウザ(Google アカウントにログイン済み)で以下のURLにアクセスし、「新しいプロジェクト」を作成します。
https://script.google.com
2
コードの貼り付け
エディタの内容を全て削除し、以下のコードを貼り付けてください。
/* ==============================================
   Hamham Subtitle Atelier (Backend Script)
   Version: 2025.12
   ============================================== */

/**
 * メイン処理: 外部からのリクエストを受け取ります
 */
function doGet(e) {
  try {
    const params = e.parameter;
    const text = params.text || '';
    const targetLangs = params.targetLangs ? JSON.parse(params.targetLangs) : [];
    const sequenceId = params.sequenceId ? parseInt(params.sequenceId) : null; 
    const sourceLang = ''; 

    const translations = targetLangs.map(lang => {
      return translateWithGoogle(text, lang, sourceLang);
    });

    const result = { translations, sequenceId };
    return ContentService.createTextOutput(JSON.stringify(result))
      .setMimeType(ContentService.MimeType.JSON);

  } catch (error) {
    return ContentService.createTextOutput(
      JSON.stringify({ 
        error: 'Translation Error: ' + error.message, 
        sequenceId: e.parameter.sequenceId ? parseInt(e.parameter.sequenceId) : null 
      })
    ).setMimeType(ContentService.MimeType.JSON);
  }
}

function translateWithGoogle(text, targetLang, sourceLang) {
  if (!text || text.trim() === '') return '';
  try {
    return LanguageApp.translate(text, sourceLang, targetLang);
  } catch (error) {
    return `[Error] ${error.message}`;
  }
}
3
デプロイ (設定注意)
右上の「デプロイ」→「新しいデプロイ」→種類の選択→「ウェブアプリ」を選択。
アクセスできるユーザー:全員 に設定してデプロイします。
4
IDの取得
発行された「デプロイ ID」をコピーし、字幕ツールの設定欄に貼り付けてください。
GAS ID貼り付け場所

💻 ローカルサーバー (Windows PC / Node.js)

PC上でAIサーバーを動かします。使用するAIモデルを選択してください。
Gemini (Google)
🤖 OpenAI (ChatGPT)
1
Gemini版のダウンロード
Google Gemini 2.5 Flash モデルを使用します。高速ですが、従量課金(Pay-as-you-go)の設定が必須です。
📥 Gemini版 ZIPをダウンロード
2
APIキーの取得と設定
Google AI Studio にアクセスしてキーを取得します。
字幕はリクエスト頻度が高いため、必ずクレジットカードを登録し、課金設定(Set up billing)を行ってください。
⚠️ 重要:
無料プランのままだと、すぐに「制限超過」エラーが発生して字幕生成が停止します。
以下のURLをコピーし、お使いのブラウザで開いてください:
https://aistudio.google.com/app/apikey
3
設定ファイルの編集
解凍したフォルダにある .env.example というファイルをメモ帳で開きます。
以下の2か所を書き換えて、そのまま上書き保存してください。 (※ファイル名を .env に変更する必要はありません。起動時に自動処理されます)
GEMINI_API_KEY=(コピーしたGoogleのキー)
VALID_API_KEY=(自分で決めたパスワード)
AI_PROVIDER=gemini
1
OpenAI版のダウンロード
ChatGPT (GPT-4o/mini) を使用します。従量課金制ですが非常に高精度です。
📥 OpenAI版 ZIPをダウンロード
2
APIキーの取得
OpenAI Platform にアクセスしてキー(要クレジットカード登録)を取得してください。
以下のURLをコピーし、お使いのブラウザで開いてください:
https://platform.openai.com/api-keys
3
設定ファイルの編集
解凍したフォルダにある .env.example というファイルをメモ帳で開きます。
以下の2か所を書き換えて、そのまま上書き保存してください。
OPENAI_API_KEY=(sk-から始まるキー)
VALID_API_KEY=(自分で決めたパスワード)
AI_PROVIDER=openai
4
起動と接続
startapi.bat をダブルクリックして実行します。
※ 初回起動時に、編集した .env.example が自動的に読み込まれます。
黒い画面に表示された接続URLをコピーして、字幕ツールに入力してください。

2回目以降startapi.bat を実行するだけで起動できます。
ハムハム字幕アトリエ:翻訳クラウド接続に入力 → パスワード://localhost:8083
Localリンク貼り付け場所