Servers Playground How we check Add a server Log in

APICK Convert

Working · 626 ms

app.apick/convertv2.0.0 Domain verified

File conversion: PDF, DOCX, STT, asynchronous TTS with MP3/ASS downloads, watermarking

Utilities Design & Creative

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://apick.app/mcp/convert

Authorization (optional)

Bearer <APICK license key>. Get a free key with 1,000 free points at https://apick.app (tools/list works without a key).

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

base64_to_image Read-only

Decode a base64-encoded image string back into an image file. base64 로 인코딩된 이미지 문자열을 원본 이미지 파일로 디코딩해 반환합니다. "data:image/타입;base64," 접두어가 붙은 문자열도 허용됩니다. [호출당 2포인트]

base64string, required

이미지 base64 문자열 (data:image/타입;base64, 접두어 허용)

APICK Convert MCP server | mcptry

Tools (25)

base64_to_image

read-only

Argument	Type	Description
base64*	string	이미지 base64 문자열 (data:image/타입;base64, 접두어 허용)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "base64"
  ],
  "properties": {
    "base64": {
      "type": "string",
      "description": "이미지 base64 문자열 (data:image/타입;base64, 접두어 허용)"
    }
  }
}

docx_to_pdf

Convert a DOCX (Word) file to a PDF file. DOCX 파일을 PDF 파일로 변환해 반환합니다. DOCX 형식의 파일만 허용됩니다. [호출당 80포인트]

read-only

Argument	Type	Description
docx_url*	string	다운로드 가능한 https URL (허용 형식: application/vnd.openxmlformats-officedocument.wordprocessingml.document) (최대 25MB)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "docx_url"
  ],
  "properties": {
    "docx_url": {
      "type": "string",
      "description": "다운로드 가능한 https URL (허용 형식: application/vnd.openxmlformats-officedocument.wordprocessingml.document) (최대 25MB)"
    }
  }
}

draw_watermark_image

Draw a visible text watermark across an image. 이미지 파일에 텍스트 워터마크를 삽입한 PNG 이미지를 반환합니다. 글자 크기·색상·투명도·밀집도를 조절할 수 있으며, PNG, JPEG 등 일반 이미지 포맷을 지원합니다. [호출당 10포인트]

read-only

Argument	Type	Description
wm*	string	워터마크 문자열 (최대 30자)
color	string	워터마크 색상 HEX (000000 ~ FFFFFF, 기본값 EEEEEE)
density	integer	워터마크 글자 밀집도 (5 ~ 15, 기본값 10)
opacity	number	워터마크 투명도 (0 ~ 1, 기본값 0.5)
font_size	integer	워터마크 글자 크기 (10 ~ 100, 기본값 10)
image_url*	string	다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp, image/bmp) (최대 50MB)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "wm",
    "image_url"
  ],
  "properties": {
    "wm": {
      "type": "string",
      "description": "워터마크 문자열 (최대 30자)"
    },
    "color": {
      "type": "string",
      "description": "워터마크 색상 HEX (000000 ~ FFFFFF, 기본값 EEEEEE)"
    },
    "density": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "워터마크 글자 밀집도 (5 ~ 15, 기본값 10)"
    },
    "opacity": {
      "type": "number",
      "description": "워터마크 투명도 (0 ~ 1, 기본값 0.5)"
    },
    "font_size": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "워터마크 글자 크기 (10 ~ 100, 기본값 10)"
    },
    "image_url": {
      "type": "string",
      "description": "다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp, image/bmp) (최대 50MB)"
    }
  }
}

draw_watermark_pdf

Draw a visible text watermark across every page of a PDF file. PDF 파일 전체 페이지에 텍스트 워터마크를 삽입한 PDF 를 반환합니다. 글자 크기·색상·투명도·각도·밀집도·적용 영역을 조절할 수 있으며, PDF 형식의 파일만 허용됩니다. [호출당 10포인트]

read-only

Argument	Type	Description
wm*	string	워터마크 문자열 (최대 30자)
angle	integer	워터마크 각도 (0 ~ 360, 기본값 35)
color	string	워터마크 색상 HEX (000000 ~ FFFFFF, 기본값 EEEEEE)
width	integer	워터마크 적용 너비 (0 ~ 2000, 기본값 550, A4 기준)
height	integer	워터마크 적용 높이 (0 ~ 2000, 기본값 800, A4 기준)
density	integer	워터마크 글자 밀집도 (100 ~ 200, 기본값 150)
opacity	number	워터마크 투명도 (0 ~ 1, 기본값 0.05)
pdf_url*	string	다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB)
font_size	integer	워터마크 글자 크기 (8 ~ 30, 기본값 10)

face_blur

Detect faces in an image and blur (mosaic) them. 이미지 파일에서 얼굴을 인식해 해당 영역을 모자이크 처리한 이미지(JPEG)를 반환합니다. PNG, JPEG 등 일반 이미지 포맷을 지원합니다. [호출당 20포인트]

read-only

Argument	Type	Description
image_url*	string	다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp, image/bmp) (최대 50MB)
threshold	number	얼굴 추출 민감도 (0 ~ 0.9, 기본값 0.5, 작을수록 민감하게 추출)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "image_url"
  ],
  "properties": {
    "image_url": {
      "type": "string",
      "description": "다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp, image/bmp) (최대 50MB)"
    },
    "threshold": {
      "type": "number",
      "description": "얼굴 추출 민감도 (0 ~ 0.9, 기본값 0.5, 작을수록 민감하게 추출)"
    }
  }
}

get_watermark

Read the invisible watermark code embedded in an image. 이미지에 삽입된 비가시성 워터마크 코드를 조회해 JSON 으로 반환합니다. 이미지가 일부 변형되어도 높은 확률로 워터마크를 확인할 수 있습니다. PNG, JPEG 등 일반 이미지 포맷을 지원합니다. [호출당 10포인트]

read-only

Argument	Type	Description
image_url*	string	다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp, image/bmp) (최대 50MB)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "image_url"
  ],
  "properties": {
    "image_url": {
      "type": "string",
      "description": "다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp, image/bmp) (최대 50MB)"
    }
  }
}

html_to_pdf

Render HTML code into a PDF file. HTML 코드를 렌더링해 PDF 파일로 변환합니다. HTML 문자열을 입력하면 변환된 PDF 파일을 반환합니다. [호출당 30포인트]

read-only

Argument	Type	Description
html*	string	변환할 HTML 코드
pagination	integer	페이지 번호 표시 여부 (0: 없음(기본값), 1: 표시)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "html"
  ],
  "properties": {
    "html": {
      "type": "string",
      "description": "변환할 HTML 코드"
    },
    "pagination": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "페이지 번호 표시 여부 (0: 없음(기본값), 1: 표시)"
    }
  }
}

json_to_excel

Convert JSON data into an Excel (XLSX) file. JSON 데이터를 EXCEL(XLSX) 파일로 변환해 반환합니다. data_list 는 객체 배열([{"컬럼":"값", ...}, ...]) 또는 2차원 배열([[...], ...]) 형식을 지원합니다. [호출당 1포인트]

read-only

Argument	Type	Description
data_list*	array	변환할 데이터 목록. 객체 배열 또는 2차원 배열 (2차원 배열은 모든 행의 열 개수가 같아야 함)
sheet_name	string	엑셀 시트 이름

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "data_list"
  ],
  "properties": {
    "data_list": {
      "type": "array",
      "items": {},
      "description": "변환할 데이터 목록. 객체 배열 또는 2차원 배열 (2차원 배열은 모든 행의 열 개수가 같아야 함)"
    },
    "sheet_name": {
      "type": "string",
      "description": "엑셀 시트 이름"
    }
  }
}

pdf_merge

Merge two PDF files into one. 두 개의 PDF 파일을 순서대로 하나의 PDF 파일로 합쳐 반환합니다. PDF 형식의 파일만 허용됩니다. [호출당 2포인트]

read-only

Argument	Type	Description
pdf_url_1*	string	다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB)
pdf_url_2*	string	다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "pdf_url_1",
    "pdf_url_2"
  ],
  "properties": {
    "pdf_url_1": {
      "type": "string",
      "description": "다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB)"
    },
    "pdf_url_2": {
      "type": "string",
      "description": "다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB)"
    }
  }
}

pdf_to_docx

Convert a PDF file to a DOCX (Word) file. PDF 파일을 DOCX 파일로 변환해 반환합니다. PDF 형식의 파일만 허용됩니다. [호출당 30포인트]

read-only

Argument	Type	Description
pdf_url*	string	다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "pdf_url"
  ],
  "properties": {
    "pdf_url": {
      "type": "string",
      "description": "다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB)"
    }
  }
}

pdf_to_image

Convert each page of a PDF file to PNG images, returned as a ZIP archive. PDF 파일의 각 페이지를 PNG 이미지로 변환하고 ZIP 파일로 묶어 반환합니다. PDF 형식의 파일만 허용됩니다. [호출당 2포인트]

read-only

Argument	Type	Description
pdf_url*	string	다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "pdf_url"
  ],
  "properties": {
    "pdf_url": {
      "type": "string",
      "description": "다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB)"
    }
  }
}

set_watermark

Embed an invisible watermark code into an image. 원본 이미지에 보이지 않는 워터마크 코드를 삽입한 PNG 이미지를 반환합니다. 이미지가 일부 변형되어도 높은 확률로 워터마크를 확인할 수 있습니다. PNG, JPEG 등 일반 이미지 포맷을 지원합니다. [호출당 10포인트]

read-only

Argument	Type	Description
code*	integer	삽입할 워터마크 코드 (1 ~ 21,767,823,359 사이의 숫자)
image_url*	string	다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp, image/bmp) (최대 50MB)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "code",
    "image_url"
  ],
  "properties": {
    "code": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "삽입할 워터마크 코드 (1 ~ 21,767,823,359 사이의 숫자)"
    },
    "image_url": {
      "type": "string",
      "description": "다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp, image/bmp) (최대 50MB)"
    }
  }
}

stt

Convert a speech audio file to text (STT). 음성 파일을 텍스트로 변환합니다. MP3, WAV, WMV 파일을 지원하며, 변환된 텍스트를 JSON으로 반환합니다. [호출당 50포인트]

read-only

Argument	Type	Description
language	string	추출 언어 코드 (예: ko, en, ja). 기본값 ko
audio_url*	string	다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/mp3, audio/wav, audio/x-wav, audio/mp4, audio/aac, audio/ogg, audio/flac, audio/webm) (최대 200MB)
artifact_filter	string	무음·잡음 구간에서 생긴 비음성 문구 처리: flag=구간에 suspect 표시, remove=제거 후 text 재구성. 생략 시 기존과 동일

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "audio_url"
  ],
  "properties": {
    "language": {
      "type": "string",
      "description": "추출 언어 코드 (예: ko, en, ja). 기본값 ko"
    },
    "audio_url": {
      "type": "string",
      "description": "다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/mp3, audio/wav, audio/x-wav, audio/mp4, audio/aac, audio/ogg, audio/flac, audio/webm) (최대 200MB)"
    },
    "artifact_filter": {
      "enum": [
        "flag",
        "remove"
      ],
      "type": "string",
      "description": "무음·잡음 구간에서 생긴 비음성 문구 처리: flag=구간에 suspect 표시, remove=제거 후 text 재구성. 생략 시 기존과 동일"
    }
  }
}

tts_gemini_create

Gemini 음성에 목소리·낭독 스타일·본문 또는 화자별 발화를 전달합니다. 기본 on 정규화는 합계 2,000자 한도와 스킬 요금이 적용됩니다. 꺼도 MP3·원문 ASS 결과 구조는 같습니다. [실제 사용량 기준(작업당 기본요금 5P) + 정규화 스킬 요금]

Argument	Type	Description
pace	number	말 속도 배율 0.5~2.0. 1이 기본
text	string	utterances와 둘 중 하나
tone	string	용도·톤. 생략 시 기본
pitch	number	음높이 -12~12 반음. 0이 기본
style	string	자유 서술 낭독 스타일
accent	string	억양. 생략 시 표준어
emotion	string	감정 표현. 생략 시 기본
speakers	object	화자 이름 → {voice_id, style, emotion, tone, accent, pace, pitch, volume_gain_db}
voice_id	string	목소리 목록의 ID. 기본 Kore
utterances	array	각 항목 text, voice_id, style, speaker, emotion, tone, accent, pace, pitch, volume_gain_db
multi_speaker

tts_gemini_voices

공개 기본·확장 목소리, 성별·공식 음색, 검증 시각을 조회합니다. 연령은 별도 검수된 경우에만 표시합니다. [무료]

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

tts_jobs_cancel

waiting 또는 processing TTS 작업에 취소를 요청합니다. 이미 수행한 유료 처리분은 정산하고 미사용 예약금은 해제합니다. 연결 종료만으로는 취소되지 않습니다. [추가 과금 없음]

destructive

Argument	Type	Description
job_id*	string	취소할 32자리 ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "pattern": "^[a-f0-9]{32}$",
      "maxLength": 32,
      "minLength": 32,
      "description": "취소할 32자리 ID"
    }
  }
}

tts_jobs_create

한국어 TTS를 접수합니다. 기본 정규화 스킬이 발음을 다듬으며 추가 요금이 합산됩니다. normalize_text=false로 끌 수 있습니다. 완료 후 MP3와 원문 ASS를 공통 API로 받습니다. 서버 오류로 최종 실패하면 정규화까지 전액 환불하고, 연결 종료는 정상 과금합니다. [실제 사용량 기준(작업당 기본요금 5P) + 기본 on 정규화 스킬 요금]

Argument	Type	Description
pace	number	말 속도 배율 0.5~2.0. 1이 기본
text	string	합성할 한국어 텍스트. utterances와 둘 중 하나
tone	string	용도·톤. 생략 시 기본
pitch	number	음높이 -12~12 반음. 0이 기본
style	string	자유 서술 낭독 스타일
accent	string	억양. 생략 시 표준어
emotion	string	감정 표현. 생략 시 기본
speakers	object	화자 이름 → {voice_id, style, emotion, tone, accent, pace, pitch, volume_gain_db}
voice_id	string	Gemini 목소리 ID. 기본 Kore. tts_gemini_voices에서 기본·확장 목록 조회
utterances	array	발화 목록. text와 둘 중 하나
multi_speaker

tts_jobs_result

Download the completed MP3 result once as base64. 완료된 TTS MP3 결과를 base64로 한 번 내려받습니다. 호출이 시작되면 서버 원본이 소모되므로 재실행할 수 없습니다. [추가 과금 없음]

destructive

Argument	Type	Description
job_id*	string	completed 상태인 32자리 ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "pattern": "^[a-f0-9]{32}$",
      "maxLength": 32,
      "minLength": 32,
      "description": "completed 상태인 32자리 ID"
    }
  }
}

tts_jobs_status

Get the public status and result availability of a TTS job. TTS 작업의 waiting, processing, completed, cancelled, failed 상태와 MP3·ASS 자막 준비 여부를 조회합니다. [무료]

read-only

Argument	Type	Description
job_id*	string	작업 접수에서 받은 32자리 ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "pattern": "^[a-f0-9]{32}$",
      "maxLength": 32,
      "minLength": 32,
      "description": "작업 접수에서 받은 32자리 ID"
    }
  }
}

tts_jobs_subtitles

Download the completed ASS subtitles once as base64. 완료된 TTS의 발화 타이밍 ASS 자막을 base64로 한 번 내려받습니다. 호출이 시작되면 자막 원본이 소모되므로 재실행할 수 없습니다. [추가 과금 없음]

destructive

Argument	Type	Description
job_id*	string	completed 상태인 32자리 ID

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "pattern": "^[a-f0-9]{32}$",
      "maxLength": 32,
      "minLength": 32,
      "description": "completed 상태인 32자리 ID"
    }
  }
}

tts_openai_create

ChatGPT 음성으로 목소리·낭독 스타일·본문 또는 발화를 전달합니다. 기본 on 정규화는 합계 2,000자 한도와 스킬 요금이 적용됩니다. 꺼도 MP3·원문 ASS 결과 구조는 같습니다. [실제 사용량 기준(작업당 기본요금 5P) + 정규화 스킬 요금]

Argument	Type	Description
pace	number	말 속도 배율 0.5~2.0. 1이 기본
text	string	utterances와 둘 중 하나
tone	string	용도·톤. 생략 시 기본
pitch	number	음높이 -12~12 반음. 0이 기본
style	string	자유 서술 낭독 스타일
accent	string	억양. 생략 시 표준어
emotion	string	감정 표현. 생략 시 기본
speakers	object	화자 이름 → {voice_id, style, emotion, tone, accent, pace, pitch, volume_gain_db}
voice_id	string	목소리. 기본 alloy
utterances	array	각 항목 text, voice_id, style, speaker, emotion, tone, accent, pace, pitch, volume_gain_db
multi_speaker

tts_openai_voices

ChatGPT TTS에서 사용할 수 있는 목소리와 음색 특성을 조회합니다. [무료]

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

tts_options

Gemini·ChatGPT의 표현 옵션과 화자 수 제한을 조회합니다. 수치 입력이 정밀한 음향 조절을 보장하지는 않습니다. [무료]

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

tts_quote

합성·정규화 예상 요금과 최대 예약금을 조회합니다. 실제 정산액은 완료된 작업의 billing을 확인하세요. [무료]

read-only

Argument	Type	Description
pace	number	말 속도 배율 0.5~2.0. 1이 기본
text	string	합성 본문
tone	string	용도·톤. 생략 시 기본
pitch	number	음높이 -12~12 반음. 0이 기본
style	string	자유 서술 낭독 스타일
accent	string	억양. 생략 시 표준어
engine	string	기본 gemini
emotion	string	감정 표현. 생략 시 기본
speakers	object	화자 이름 → {voice_id, style, emotion, tone, accent, pace, pitch, volume_gain_db}
voice_id	string	목소리 ID. 생략 시 엔진 기본 목소리
utterances	array

voice_change

Modulate the voice in a video or audio file to a lower or higher pitch. 동영상 또는 오디오 파일의 음성을 저음 또는 고음으로 변조합니다. MP3, WAV 등 오디오와 MP4, MOV 등 동영상 포맷을 지원하며, 변조된 파일을 반환합니다. [호출당 10포인트]

read-only

Argument	Type	Description
type*	string	변조음 타입 (1: 저음, 2: 고음)
media_url*	string	다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/mp3, audio/wav, audio/x-wav, audio/mp4, audio/aac, audio/ogg, video/mp4, video/quicktime, video/x-msvideo, video/x-matroska, video/webm) (최대 200MB)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "type",
    "media_url"
  ],
  "properties": {
    "type": {
      "type": "string",
      "description": "변조음 타입 (1: 저음, 2: 고음)"
    },
    "media_url": {
      "type": "string",
      "description": "다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/mp3, audio/wav, audio/x-wav, audio/mp4, audio/aac, audio/ogg, video/mp4, video/quicktime, video/x-msvideo, video/x-matroska, video/webm) (최대 200MB)"
    }
  }
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "wm",
    "pdf_url"
  ],
  "properties": {
    "wm": {
      "type": "string",
      "description": "워터마크 문자열 (최대 30자)"
    },
    "angle": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "워터마크 각도 (0 ~ 360, 기본값 35)"
    },
    "color": {
      "type": "string",
      "description": "워터마크 색상 HEX (000000 ~ FFFFFF, 기본값 EEEEEE)"
    },
    "width": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "워터마크 적용 너비 (0 ~ 2000, 기본값 550, A4 기준)"
    },
    "height": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "워터마크 적용 높이 (0 ~ 2000, 기본값 800, A4 기준)"
    },
    "density": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "워터마크 글자 밀집도 (100 ~ 200, 기본값 150)"
    },
    "opacity": {
      "type": "number",
      "description": "워터마크 투명도 (0 ~ 1, 기본값 0.05)"
    },
    "pdf_url": {
      "type": "string",
      "description": "다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB)"
    },
    "font_size": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "워터마크 글자 크기 (8 ~ 30, 기본값 10)"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "pace": {
      "type": "number",
      "description": "말 속도 배율 0.5~2.0. 1이 기본"
    },
    "text": {
      "type": "string",
      "maxLength": 8000,
      "description": "utterances와 둘 중 하나"
    },
    "tone": {
      "enum": [
        "narration",
        "news",
        "audiobook",
        "documentary",
        "ad",
        "conversation",
        "announcement",
        "tutorial",
        "storytelling"
      ],
      "type": "string",
      "description": "용도·톤. 생략 시 기본"
    },
    "pitch": {
      "type": "number",
      "description": "음높이 -12~12 반음. 0이 기본"
    },
    "style": {
      "type": "string",
      "maxLength": 1000,
      "description": "자유 서술 낭독 스타일"
    },
    "accent": {
      "enum": [
        "standard",
        "seoul",
        "gyeongsang",
        "jeolla",
        "chungcheong"
      ],
      "type": "string",
      "description": "억양. 생략 시 표준어"
    },
    "emotion": {
      "enum": [
        "neutral",
        "calm",
        "cheerful",
        "excited",
        "sad",
        "serious",
        "friendly",
        "empathetic",
        "confident",
        "gentle",
        "whisper",
        "narration"
      ],
      "type": "string",
      "description": "감정 표현. 생략 시 기본"
    },
    "speakers": {
      "type": "object",
      "description": "화자 이름 → {voice_id, style, emotion, tone, accent, pace, pitch, volume_gain_db}",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "voice_id": {
      "type": "string",
      "description": "목소리 목록의 ID. 기본 Kore"
    },
    "utterances": {
      "type": "array",
      "items": {},
      "description": "각 항목 text, voice_id, style, speaker, emotion, tone, accent, pace, pitch, volume_gain_db"
    },
    "multi_speaker": {
      "type": "boolean",
      "description": "멀티화자. Gemini는 화자 2명까지 한 호출, ChatGPT는 발화별 목소리 대화"
    },
    "normalize_text": {
      "type": "boolean",
      "description": "기본 true, 정규화 추가 과금"
    },
    "volume_gain_db": {
      "type": "number",
      "description": "음량 보정 -12~12 dB. 0이 기본"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_.:-]+$",
      "maxLength": 128,
      "description": "같은 요청의 재접수 키"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "pace": {
      "type": "number",
      "description": "말 속도 배율 0.5~2.0. 1이 기본"
    },
    "text": {
      "type": "string",
      "maxLength": 8000,
      "minLength": 1,
      "description": "합성할 한국어 텍스트. utterances와 둘 중 하나"
    },
    "tone": {
      "enum": [
        "narration",
        "news",
        "audiobook",
        "documentary",
        "ad",
        "conversation",
        "announcement",
        "tutorial",
        "storytelling"
      ],
      "type": "string",
      "description": "용도·톤. 생략 시 기본"
    },
    "pitch": {
      "type": "number",
      "description": "음높이 -12~12 반음. 0이 기본"
    },
    "style": {
      "type": "string",
      "maxLength": 1000,
      "description": "자유 서술 낭독 스타일"
    },
    "accent": {
      "enum": [
        "standard",
        "seoul",
        "gyeongsang",
        "jeolla",
        "chungcheong"
      ],
      "type": "string",
      "description": "억양. 생략 시 표준어"
    },
    "emotion": {
      "enum": [
        "neutral",
        "calm",
        "cheerful",
        "excited",
        "sad",
        "serious",
        "friendly",
        "empathetic",
        "confident",
        "gentle",
        "whisper",
        "narration"
      ],
      "type": "string",
      "description": "감정 표현. 생략 시 기본"
    },
    "speakers": {
      "type": "object",
      "description": "화자 이름 → {voice_id, style, emotion, tone, accent, pace, pitch, volume_gain_db}",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "voice_id": {
      "type": "string",
      "maxLength": 160,
      "description": "Gemini 목소리 ID. 기본 Kore. tts_gemini_voices에서 기본·확장 목록 조회"
    },
    "utterances": {
      "type": "array",
      "items": {},
      "description": "발화 목록. text와 둘 중 하나"
    },
    "multi_speaker": {
      "type": "boolean",
      "description": "멀티화자. Gemini는 화자 2명까지 한 호출, ChatGPT는 발화별 목소리 대화"
    },
    "normalize_text": {
      "type": "boolean",
      "description": "기본 true. 정규화 스킬 비용 합산, false는 실행·과금 생략"
    },
    "volume_gain_db": {
      "type": "number",
      "description": "음량 보정 -12~12 dB. 0이 기본"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_.:-]+$",
      "maxLength": 128,
      "description": "접수 응답 유실 시 같은 요청에 재사용할 키"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "pace": {
      "type": "number",
      "description": "말 속도 배율 0.5~2.0. 1이 기본"
    },
    "text": {
      "type": "string",
      "maxLength": 8000,
      "description": "utterances와 둘 중 하나"
    },
    "tone": {
      "enum": [
        "narration",
        "news",
        "audiobook",
        "documentary",
        "ad",
        "conversation",
        "announcement",
        "tutorial",
        "storytelling"
      ],
      "type": "string",
      "description": "용도·톤. 생략 시 기본"
    },
    "pitch": {
      "type": "number",
      "description": "음높이 -12~12 반음. 0이 기본"
    },
    "style": {
      "type": "string",
      "maxLength": 1000,
      "description": "자유 서술 낭독 스타일"
    },
    "accent": {
      "enum": [
        "standard",
        "seoul",
        "gyeongsang",
        "jeolla",
        "chungcheong"
      ],
      "type": "string",
      "description": "억양. 생략 시 표준어"
    },
    "emotion": {
      "enum": [
        "neutral",
        "calm",
        "cheerful",
        "excited",
        "sad",
        "serious",
        "friendly",
        "empathetic",
        "confident",
        "gentle",
        "whisper",
        "narration"
      ],
      "type": "string",
      "description": "감정 표현. 생략 시 기본"
    },
    "speakers": {
      "type": "object",
      "description": "화자 이름 → {voice_id, style, emotion, tone, accent, pace, pitch, volume_gain_db}",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "voice_id": {
      "enum": [
        "alloy",
        "ash",
        "ballad",
        "coral",
        "echo",
        "fable",
        "onyx",
        "nova",
        "sage",
        "shimmer",
        "verse"
      ],
      "type": "string",
      "description": "목소리. 기본 alloy"
    },
    "utterances": {
      "type": "array",
      "items": {},
      "description": "각 항목 text, voice_id, style, speaker, emotion, tone, accent, pace, pitch, volume_gain_db"
    },
    "multi_speaker": {
      "type": "boolean",
      "description": "멀티화자. Gemini는 화자 2명까지 한 호출, ChatGPT는 발화별 목소리 대화"
    },
    "normalize_text": {
      "type": "boolean",
      "description": "기본 true, 정규화 추가 과금"
    },
    "volume_gain_db": {
      "type": "number",
      "description": "음량 보정 -12~12 dB. 0이 기본"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_.:-]+$",
      "maxLength": 128,
      "description": "같은 요청의 재접수 키"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "pace": {
      "type": "number",
      "description": "말 속도 배율 0.5~2.0. 1이 기본"
    },
    "text": {
      "type": "string",
      "description": "합성 본문"
    },
    "tone": {
      "enum": [
        "narration",
        "news",
        "audiobook",
        "documentary",
        "ad",
        "conversation",
        "announcement",
        "tutorial",
        "storytelling"
      ],
      "type": "string",
      "description": "용도·톤. 생략 시 기본"
    },
    "pitch": {
      "type": "number",
      "description": "음높이 -12~12 반음. 0이 기본"
    },
    "style": {
      "type": "string",
      "maxLength": 1000,
      "description": "자유 서술 낭독 스타일"
    },
    "accent": {
      "enum": [
        "standard",
        "seoul",
        "gyeongsang",
        "jeolla",
        "chungcheong"
      ],
      "type": "string",
      "description": "억양. 생략 시 표준어"
    },
    "engine": {
      "enum": [
        "gemini",
        "openai"
      ],
      "type": "string",
      "description": "기본 gemini"
    },
    "emotion": {
      "enum": [
        "neutral",
        "calm",
        "cheerful",
        "excited",
        "sad",
        "serious",
        "friendly",
        "empathetic",
        "confident",
        "gentle",
        "whisper",
        "narration"
      ],
      "type": "string",
      "description": "감정 표현. 생략 시 기본"
    },
    "speakers": {
      "type": "object",
      "description": "화자 이름 → {voice_id, style, emotion, tone, accent, pace, pitch, volume_gain_db}",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "voice_id": {
      "type": "string",
      "description": "목소리 ID. 생략 시 엔진 기본 목소리"
    },
    "utterances": {
      "type": "array",
      "items": {},
      "description": "발화 목록"
    },
    "multi_speaker": {
      "type": "boolean",
      "description": "멀티화자. Gemini는 화자 2명까지 한 호출, ChatGPT는 발화별 목소리 대화"
    },
    "normalize_text": {
      "type": "boolean",
      "description": "기본 true"
    },
    "volume_gain_db": {
      "type": "number",
      "description": "음량 보정 -12~12 dB. 0이 기본"
    }
  }
}