APICK Convert
File conversion: PDF, DOCX, STT, TTS, watermarking
사용해야 할까요
품질 및 안전성
발견 사항 (8)
- LOWtts_jobs_quality에서
- LOWtts_jobs_retry에서
- LOWtts_jobs_candidate_audio에서
- LOWvoice_change에서
- LOWface_blur에서
- LOWpdf_merge에서
- LOWbase64_to_image에서
- LOWset_watermark에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"convert": {
"url": "https://apick.app/mcp/convert"
}
}
}원격 엔드포인트
https://apick.app/mcp/convertstreamable-http할 수 있는 일
도구 목록
도구 (22)
🟢stt(language, audio_url)
Convert a speech audio file to text (STT). 음성 파일을 텍스트로 변환합니다. MP3, WAV, M4A, AAC, OGG, FLAC, WEBM 등 일반적인 오디오 포맷을 지원하며, 변환된 텍스트를 JSON으로 반환합니다. [호출당 50포인트]
입력 스키마
{
"type": "object",
"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)"
}
},
"required": [
"audio_url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡tts_jobs_create(voice_id, text)
Create an asynchronous Korean narration job with one of 16 voices. 16개 한국어 내레이션 목소리 중 하나로 비동기 TTS 작업을 접수합니다. text는 최대 800자이며 접수 성공 시 과금되고 이후 취소해도 환불되지 않습니다. [100자당 10포인트]
입력 스키마
{
"type": "object",
"properties": {
"voice_id": {
"type": "string",
"enum": [
"v2_ann_m_30s_01",
"v2_ann_m_30s_02",
"v2_ann_m_30s_04",
"v2_ann_m_30s_05",
"v2_ann_f_30s_01",
"v2_ann_f_30s_02",
"v2_ann_f_30s_03",
"v2_ann_f_30s_04",
"v2_ann_f_30s_05",
"v2_m_teen_01",
"v2_m_young_01",
"v2_m_mid_01",
"v2_m_senior_01",
"v2_f_teen_01",
"v2_f_young_01",
"v2_f_senior_01"
],
"description": "지원 voice_id"
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 800,
"description": "합성할 한국어 텍스트 (최대 800자)"
}
},
"required": [
"voice_id",
"text"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢tts_jobs_status(job_id)
Get the public status and result availability of a TTS job. TTS 작업의 waiting, processing, completed, cancelled, failed 상태와 MP3·ASS 자막 준비 여부를 조회합니다. [무료]
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"minLength": 32,
"maxLength": 32,
"pattern": "^[a-f0-9]{32}$",
"description": "작업 접수에서 받은 32자리 ID"
}
},
"required": [
"job_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴tts_jobs_cancel(job_id)
Cancel a waiting or processing TTS job without refunding the accepted charge. waiting 또는 processing 상태의 TTS 작업을 취소합니다. 접수 시 과금된 금액은 환불되지 않습니다. [추가 과금 없음]
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"minLength": 32,
"maxLength": 32,
"pattern": "^[a-f0-9]{32}$",
"description": "취소할 32자리 ID"
}
},
"required": [
"job_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴tts_jobs_result(job_id)
Download the completed MP3 result once as base64. 완료된 TTS MP3 결과를 base64로 한 번 내려받습니다. 호출이 시작되면 서버 원본이 소모되므로 재실행할 수 없습니다. [추가 과금 없음]
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"minLength": 32,
"maxLength": 32,
"pattern": "^[a-f0-9]{32}$",
"description": "completed 상태인 32자리 ID"
}
},
"required": [
"job_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴tts_jobs_subtitles(job_id)
Download the completed ASS subtitles once as base64. 완료된 TTS의 발화 타이밍 ASS 자막을 base64로 한 번 내려받습니다. 호출이 시작되면 자막 원본이 소모되므로 재실행할 수 없습니다. [추가 과금 없음]
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"minLength": 32,
"maxLength": 32,
"pattern": "^[a-f0-9]{32}$",
"description": "completed 상태인 32자리 ID"
}
},
"required": [
"job_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢tts_jobs_quality(job_id)
TTS 발화별 검수 결과와 후보 이력을 조회합니다. 종료 후 72시간 보존되며 최종 결과 다운로드를 소비하지 않습니다. [무료]
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "소유한 작업 ID"
}
},
"required": [
"job_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}⚪tts_jobs_retry(job_id, utterance_ids, idempotency_key)
실패 발화만 같은 작업에서 재개합니다. 동일 멱등 키는 중복 실행·과금되지 않습니다. [추가 과금 없음]
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "소유한 작업 ID"
},
"utterance_ids": {
"type": "array",
"items": {},
"description": "u001부터 시작하는 실패 발화 ID 목록"
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 128,
"description": "동일 재개 요청에 재사용하는 키"
}
},
"required": [
"job_id",
"utterance_ids",
"idempotency_key"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢tts_jobs_candidate_audio(job_id, candidate_id)
품질 이력의 후보 WAV를 조회합니다. 최종 결과의 일회 다운로드를 소비하지 않습니다. REST에서는 Range 재생을 지원합니다. [무료]
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "소유한 작업 ID"
},
"candidate_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "품질 이력의 후보 ID"
}
},
"required": [
"job_id",
"candidate_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢voice_change(type, media_url)
Modulate the voice in a video or audio file to a lower or higher pitch. 동영상 또는 오디오 파일의 음성을 저음 또는 고음으로 변조합니다. MP3, WAV 등 오디오와 MP4, MOV 등 동영상 포맷을 지원하며, 변조된 파일을 반환합니다. [호출당 10포인트]
입력 스키마
{
"type": "object",
"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)"
}
},
"required": [
"type",
"media_url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢face_blur(threshold, image_url)
Detect faces in an image and blur (mosaic) them. 이미지 파일에서 얼굴을 인식해 해당 영역을 모자이크 처리한 이미지(JPEG)를 반환합니다. PNG, JPEG 등 일반 이미지 포맷을 지원합니다. [호출당 20포인트]
입력 스키마
{
"type": "object",
"properties": {
"threshold": {
"type": "number",
"description": "얼굴 추출 민감도 (0 ~ 0.9, 기본값 0.5, 작을수록 민감하게 추출)"
},
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp, image/bmp) (최대 50MB)"
}
},
"required": [
"image_url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢pdf_to_docx(pdf_url)
Convert a PDF file to a DOCX (Word) file. PDF 파일을 DOCX 파일로 변환해 반환합니다. PDF 형식의 파일만 허용됩니다. [호출당 30포인트]
입력 스키마
{
"type": "object",
"properties": {
"pdf_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB)"
}
},
"required": [
"pdf_url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢pdf_to_image(pdf_url)
Convert each page of a PDF file to PNG images, returned as a ZIP archive. PDF 파일의 각 페이지를 PNG 이미지로 변환하고 ZIP 파일로 묶어 반환합니다. PDF 형식의 파일만 허용됩니다. [호출당 2포인트]
입력 스키마
{
"type": "object",
"properties": {
"pdf_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB)"
}
},
"required": [
"pdf_url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢pdf_merge(pdf_url_1, pdf_url_2)
Merge two PDF files into one. 두 개의 PDF 파일을 순서대로 하나의 PDF 파일로 합쳐 반환합니다. PDF 형식의 파일만 허용됩니다. [호출당 2포인트]
입력 스키마
{
"type": "object",
"properties": {
"pdf_url_1": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB)"
},
"pdf_url_2": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB)"
}
},
"required": [
"pdf_url_1",
"pdf_url_2"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢html_to_pdf(html, pagination)
Render HTML code into a PDF file. HTML 코드를 렌더링해 PDF 파일로 변환합니다. HTML 문자열을 입력하면 변환된 PDF 파일을 반환합니다. [호출당 30포인트]
입력 스키마
{
"type": "object",
"properties": {
"html": {
"type": "string",
"description": "변환할 HTML 코드"
},
"pagination": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "페이지 번호 표시 여부 (0: 없음(기본값), 1: 표시)"
}
},
"required": [
"html"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢docx_to_pdf(docx_url)
Convert a DOCX (Word) file to a PDF file. DOCX 파일을 PDF 파일로 변환해 반환합니다. DOCX 형식의 파일만 허용됩니다. [호출당 80포인트]
입력 스키마
{
"type": "object",
"properties": {
"docx_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: application/vnd.openxmlformats-officedocument.wordprocessingml.document) (최대 25MB)"
}
},
"required": [
"docx_url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢json_to_excel(data_list, sheet_name)
Convert JSON data into an Excel (XLSX) file. JSON 데이터를 EXCEL(XLSX) 파일로 변환해 반환합니다. data_list 는 객체 배열([{"컬럼":"값", ...}, ...]) 또는 2차원 배열([[...], ...]) 형식을 지원합니다. [호출당 1포인트]
입력 스키마
{
"type": "object",
"properties": {
"data_list": {
"type": "array",
"items": {},
"description": "변환할 데이터 목록. 객체 배열 또는 2차원 배열 (2차원 배열은 모든 행의 열 개수가 같아야 함)"
},
"sheet_name": {
"type": "string",
"description": "엑셀 시트 이름"
}
},
"required": [
"data_list"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢base64_to_image(base64)
Decode a base64-encoded image string back into an image file. base64 로 인코딩된 이미지 문자열을 원본 이미지 파일로 디코딩해 반환합니다. "data:image/타입;base64," 접두어가 붙은 문자열도 허용됩니다. [호출당 2포인트]
입력 스키마
{
"type": "object",
"properties": {
"base64": {
"type": "string",
"description": "이미지 base64 문자열 (data:image/타입;base64, 접두어 허용)"
}
},
"required": [
"base64"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢set_watermark(code, image_url)
Embed an invisible watermark code into an image. 원본 이미지에 보이지 않는 워터마크 코드를 삽입한 PNG 이미지를 반환합니다. 이미지가 일부 변형되어도 높은 확률로 워터마크를 확인할 수 있습니다. PNG, JPEG 등 일반 이미지 포맷을 지원합니다. [호출당 10포인트]
입력 스키마
{
"type": "object",
"properties": {
"code": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "삽입할 워터마크 코드 (1 ~ 21,767,823,359 사이의 숫자)"
},
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp, image/bmp) (최대 50MB)"
}
},
"required": [
"code",
"image_url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_watermark(image_url)
Read the invisible watermark code embedded in an image. 이미지에 삽입된 비가시성 워터마크 코드를 조회해 JSON 으로 반환합니다. 이미지가 일부 변형되어도 높은 확률로 워터마크를 확인할 수 있습니다. PNG, JPEG 등 일반 이미지 포맷을 지원합니다. [호출당 10포인트]
입력 스키마
{
"type": "object",
"properties": {
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp, image/bmp) (최대 50MB)"
}
},
"required": [
"image_url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢draw_watermark_pdf(wm, font_size, color, opacity, angle, ...)
Draw a visible text watermark across every page of a PDF file. PDF 파일 전체 페이지에 텍스트 워터마크를 삽입한 PDF 를 반환합니다. 글자 크기·색상·투명도·각도·밀집도·적용 영역을 조절할 수 있으며, PDF 형식의 파일만 허용됩니다. [호출당 10포인트]
입력 스키마
{
"type": "object",
"properties": {
"wm": {
"type": "string",
"description": "워터마크 문자열 (최대 30자)"
},
"font_size": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "워터마크 글자 크기 (8 ~ 30, 기본값 10)"
},
"color": {
"type": "string",
"description": "워터마크 색상 HEX (000000 ~ FFFFFF, 기본값 EEEEEE)"
},
"opacity": {
"type": "number",
"description": "워터마크 투명도 (0 ~ 1, 기본값 0.05)"
},
"angle": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "워터마크 각도 (0 ~ 360, 기본값 35)"
},
"density": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "워터마크 글자 밀집도 (100 ~ 200, 기본값 150)"
},
"width": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "워터마크 적용 너비 (0 ~ 2000, 기본값 550, A4 기준)"
},
"height": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "워터마크 적용 높이 (0 ~ 2000, 기본값 800, A4 기준)"
},
"pdf_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB)"
}
},
"required": [
"wm",
"pdf_url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢draw_watermark_image(wm, font_size, color, opacity, density, ...)
Draw a visible text watermark across an image. 이미지 파일에 텍스트 워터마크를 삽입한 PNG 이미지를 반환합니다. 글자 크기·색상·투명도·밀집도를 조절할 수 있으며, PNG, JPEG 등 일반 이미지 포맷을 지원합니다. [호출당 10포인트]
입력 스키마
{
"type": "object",
"properties": {
"wm": {
"type": "string",
"description": "워터마크 문자열 (최대 30자)"
},
"font_size": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "워터마크 글자 크기 (10 ~ 100, 기본값 10)"
},
"color": {
"type": "string",
"description": "워터마크 색상 HEX (000000 ~ FFFFFF, 기본값 EEEEEE)"
},
"opacity": {
"type": "number",
"description": "워터마크 투명도 (0 ~ 1, 기본값 0.5)"
},
"density": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "워터마크 글자 밀집도 (5 ~ 15, 기본값 10)"
},
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp, image/bmp) (최대 50MB)"
}
},
"required": [
"wm",
"image_url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}권장 프롬프트
get_watermarkget_watermark커뮤니티
증거