Google Sheets

// 타입캐스트 API 구성
const TYPECAST_API_KEY = "YOUR_API_KEY_HERE"; // 실제 API 키로 교체
const TYPECAST_API_URL = "https://api.typecast.ai/v1/text-to-speech";

/**
 * 스프레드시트가 열릴 때 사용자 정의 메뉴 생성
 */
function onOpen() {
  const ui = SpreadsheetApp.getUi();
  ui.createMenu("🎙️ Typecast TTS")
    .addItem("모든 오디오 생성", "generateAllAudio")
    .addItem("선택한 행만 생성", "generateSelectedAudio")
    .addSeparator()
    .addItem("오디오 URL 지우기", "clearAudioUrls")
    .addToUi();
}

/**
 * 텍스트가 있는 모든 행에 대해 오디오 생성
 */
function generateAllAudio() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const lastRow = sheet.getLastRow();

  if (lastRow < 2) {
    SpreadsheetApp.getUi().alert("처리할 데이터가 없습니다!");
    return;
  }

  // 더 나은 성능을 위해 모든 데이터를 한 번에 가져오기
  const dataRange = sheet.getRange(2, 1, lastRow - 1, 4);
  const data = dataRange.getValues();

  let successCount = 0;
  let errorCount = 0;

  // 각 행 처리
  data.forEach((row, index) => {
    const text = row[0];
    const voiceNameOrId = row[1];
    const language = row[2] || "kor"; // 지정되지 않으면 기본값 한국어
    const rowNumber = index + 2;

    // 텍스트 또는 음성 이름/ID가 비어있으면 건너뛰기
    if (!text || !voiceNameOrId) {
      return;
    }

    // 오디오 URL이 이미 있으면 건너뛰기
    if (row[3]) {
      return;
    }

    try {
      const audioUrl = callTypecastAPI(text, voiceNameOrId, language);
      sheet.getRange(rowNumber, 4).setValue(audioUrl);
      successCount++;

      // 요청 제한을 피하기 위해 약간의 지연 추가
      Utilities.sleep(500);
    } catch (error) {
      sheet.getRange(rowNumber, 4).setValue("오류: " + error.message);
      errorCount++;
    }
  });

  SpreadsheetApp.getUi().alert(
    `생성 완료!\n\n성공: ${successCount}\n오류: ${errorCount}`,
  );
}

/**
 * 선택한 행에 대해서만 오디오 생성
 */
function generateSelectedAudio() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const selection = sheet.getActiveRange();
  const startRow = selection.getRow();
  const numRows = selection.getNumRows();

  if (startRow === 1) {
    SpreadsheetApp.getUi().alert("데이터 행을 선택하세요 (헤더 제외)");
    return;
  }

  let successCount = 0;
  let errorCount = 0;

  for (let i = 0; i < numRows; i++) {
    const rowNumber = startRow + i;
    const text = sheet.getRange(rowNumber, 1).getValue();
    const voiceNameOrId = sheet.getRange(rowNumber, 2).getValue();
    const language = sheet.getRange(rowNumber, 3).getValue() || "kor";

    if (!text || !voiceNameOrId) {
      continue;
    }

    try {
      const audioUrl = callTypecastAPI(text, voiceNameOrId, language);
      sheet.getRange(rowNumber, 4).setValue(audioUrl);
      successCount++;

      Utilities.sleep(500);
    } catch (error) {
      sheet.getRange(rowNumber, 4).setValue("오류: " + error.message);
      errorCount++;
    }
  }

  SpreadsheetApp.getUi().alert(
    `생성 완료!\n\n성공: ${successCount}\n오류: ${errorCount}`,
  );
}

/**
 * D열의 모든 오디오 URL 지우기
 */
function clearAudioUrls() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const lastRow = sheet.getLastRow();

  if (lastRow < 2) {
    return;
  }

  const response = SpreadsheetApp.getUi().alert(
    "오디오 URL 지우기",
    "모든 오디오 URL을 지우시겠습니까?",
    SpreadsheetApp.getUi().ButtonSet.YES_NO,
  );

  if (response === SpreadsheetApp.getUi().Button.YES) {
    sheet.getRange(2, 4, lastRow - 1, 1).clearContent();
    SpreadsheetApp.getUi().alert("오디오 URL이 지워졌습니다!");
  }
}

/**
 * Voices API를 호출하여 음성 이름에서 음성 ID 가져오기
 * @param {string} voiceName - 조회할 음성 이름
 * @returns {string} 음성 ID (예: tc_66aca22c7d31e45ff05ff418)
 */
function getVoiceIdByName(voiceName) {
  const url = "https://api.typecast.ai/v2/voices";

  const options = {
    method: "get",
    headers: {
      "X-API-KEY": TYPECAST_API_KEY,
    },
    muteHttpExceptions: true,
  };

  const response = UrlFetchApp.fetch(url, options);
  const responseCode = response.getResponseCode();

  if (responseCode !== 200) {
    throw new Error(`음성 가져오기 실패: ${responseCode}`);
  }

  const voices = JSON.parse(response.getContentText());

  // 이름으로 음성 검색 (대소문자 구분 없음)
  const searchName = voiceName.toLowerCase().trim();
  const voice = voices.find((v) => v.voice_name.toLowerCase() === searchName);

  if (!voice) {
    throw new Error(
      `"${voiceName}" 음성을 찾을 수 없습니다. 음성 이름을 확인하거나 음성 ID를 대신 사용하세요.`,
    );
  }

  return voice.voice_id;
}

/**
 * 타입캐스트 API를 호출하여 음성 생성
 * @param {string} text - 음성으로 변환할 텍스트
 * @param {string} voiceNameOrId - 음성 이름 (예: "Emily") 또는 음성 ID (예: "tc_66aca22c7d31e45ff05ff418")
 * @param {string} language - 언어 코드 (eng, kor, jpn, cmn 등)
 * @returns {string} 생성된 오디오 파일의 URL
 */
function callTypecastAPI(text, voiceNameOrId, language) {
  // 입력값 정리 및 검증
  text = String(text).trim();
  voiceNameOrId = String(voiceNameOrId).trim();
  language = String(language || "kor").trim();

  if (!text || !voiceNameOrId) {
    throw new Error("텍스트와 음성 이름/ID가 필요합니다");
  }

  // 입력이 음성 ID인지 이름인지 결정
  // 음성 ID는 "tc_"로 시작
  let voiceId;
  if (voiceNameOrId.startsWith("tc_")) {
    voiceId = voiceNameOrId;
    Logger.log("음성 ID 사용: " + voiceId);
  } else {
    // 음성 이름이므로 ID 조회
    Logger.log("음성 이름 조회 중: " + voiceNameOrId);
    voiceId = getVoiceIdByName(voiceNameOrId);
    Logger.log("음성 ID 찾음: " + voiceId);
  }

  // 디버깅용 로그
  Logger.log("API 호출 중, 텍스트: " + text);
  Logger.log("언어: " + language);

  const payload = {
    voice_id: voiceId,
    text: text,
    model: "ssfm-v30",
    language: language,
    prompt: {
      emotion_type: "smart", // 자연스러운 음성을 위한 스마트 이모션 활성화
    },
    output: {
      audio_format: "mp3",
    },
  };

  // 디버깅용 페이로드 로그
  Logger.log("페이로드: " + JSON.stringify(payload));

  const options = {
    method: "post",
    contentType: "application/json",
    headers: {
      "X-API-KEY": TYPECAST_API_KEY,
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true,
  };

  const response = UrlFetchApp.fetch(TYPECAST_API_URL, options);
  const responseCode = response.getResponseCode();

  if (responseCode !== 200) {
    const errorBody = response.getContentText();
    Logger.log("오류 응답: " + errorBody);
    throw new Error(`API 오류: ${responseCode} - ${errorBody}`);
  }

  // 오디오 blob 가져오기
  const audioBlob = response.getBlob();

  // Google Drive에 업로드
  const folder = DriveApp.getRootFolder(); // 또는 특정 폴더 지정
  const fileName = `typecast_${new Date().getTime()}.mp3`;
  const file = folder.createFile(audioBlob.setName(fileName));

  // 링크로 접근 가능하도록 파일 설정
  file.setSharing(DriveApp.Access.ANYONE_WITH_LINK, DriveApp.Permission.VIEW);

  // 파일 URL 반환
  return file.getUrl();
}