한글 발음 변환 AI

기능·제공 범위

인증: Bearer 키
요청: form-data
응답: JSON
요금·이용 조건: 100자까지 20P · 이후 100자당 10P

빠른 시작

서버의 APICK_API_KEY를 준비하고 입력값을 바꾸세요. 아래에서 경로별 입력·응답·실행 환경을 함께 확인할 수 있습니다.

요청과 응답

API 요청 예제직접 실행하지 않습니다POST /rest/llm/text_pronunciation

POSIX 셸 · APICK_API_KEY 환경변수를 먼저 설정하세요. Windows에서는 Unicode 지원 cURL을 사용하세요.

curl --fail-with-body --request POST 'https://apick.app/rest/llm/text_pronunciation' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'text=서울에서 부산까지는 5시간이 넘게 걸리고 거리는 400km쯤 된다. 5번 버스를 타고 가서 버튼을 5번 누르세요.'

Node.js 22+ · 서버에서 실행하는 ESM 예제입니다. 키를 브라우저에 넣지 마세요.

const form = new FormData();
form.append("text", "서울에서 부산까지는 5시간이 넘게 걸리고 거리는 400km쯤 된다. 5번 버스를 타고 가서 버튼을 5번 누르세요.");
const response = await fetch("https://apick.app/rest/llm/text_pronunciation", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);

Python 3 · requests 설치가 필요합니다. 키는 서버 환경변수로 읽습니다.

import os
import requests
parts = [
    ("text", (None, "서울에서 부산까지는 5시간이 넘게 걸리고 거리는 400km쯤 된다. 5번 버스를 타고 가서 버튼을 5번 누르세요.")),
]
response = requests.request("POST", "https://apick.app/rest/llm/text_pronunciation",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
    files=parts,
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)

PHP 8 · cURL 확장이 필요합니다. 키는 서버 환경변수로 읽습니다.

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'text' => '서울에서 부산까지는 5시간이 넘게 걸리고 거리는 400km쯤 된다. 5번 버스를 타고 가서 버튼을 5번 누르세요.',
];
$curl = curl_init('https://apick.app/rest/llm/text_pronunciation');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

POSIX 셸 · APICK_API_KEY 환경변수를 먼저 설정하세요. Windows에서는 Unicode 지원 cURL을 사용하세요.

curl --fail-with-body --request POST 'https://apick.app/rest/llm/text_pronunciation' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --connect-timeout 10 --max-time 120 \
  --form-string 'text=서울에서 부산까지는 5시간이 넘게 걸리고 거리는 400km쯤 된다. 5번 버스를 타고 가서 버튼을 5번 누르세요.'

Node.js 22+ · 서버에서 실행하는 ESM 예제입니다. 키를 브라우저에 넣지 마세요.

const form = new FormData();
form.append("text", "서울에서 부산까지는 5시간이 넘게 걸리고 거리는 400km쯤 된다. 5번 버스를 타고 가서 버튼을 5번 누르세요.");
const response = await fetch("https://apick.app/rest/llm/text_pronunciation", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
if (result.error || result.data?.error || result.result?.error || result.success === false || result.api?.success === false) {
  throw new Error(JSON.stringify(result));
}
console.log(result);

Python 3 · requests 설치가 필요합니다. 키는 서버 환경변수로 읽습니다.

import os
import requests
parts = [
    ("text", (None, "서울에서 부산까지는 5시간이 넘게 걸리고 거리는 400km쯤 된다. 5번 버스를 타고 가서 버튼을 5번 누르세요.")),
]
response = requests.request("POST", "https://apick.app/rest/llm/text_pronunciation",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
    files=parts,
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
if result.get("error") or (isinstance(result.get("data"), dict) and result["data"].get("error")) or (isinstance(result.get("result"), dict) and result["result"].get("error")) or result.get("success") is False or (result.get("api") or {}).get("success") is False:
    raise RuntimeError(result)
print(result)

PHP 8 · cURL 확장이 필요합니다. 키는 서버 환경변수로 읽습니다.

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
    'text' => '서울에서 부산까지는 5시간이 넘게 걸리고 거리는 400km쯤 된다. 5번 버스를 타고 가서 버튼을 5번 누르세요.',
];
$curl = curl_init('https://apick.app/rest/llm/text_pronunciation');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
if (!empty($result["error"]) || !empty($result["data"]["error"]) || !empty($result["result"]["error"]) || ($result["success"] ?? true) === false || ($result["api"]["success"] ?? true) === false) {
    throw new RuntimeException($body);
}
print_r($result);

API 요청

POST/rest/llm/text_pronunciation

Bearer 인증 · multipart/form-data · JSON 응답

입력 항목

폼 항목·타입

필수

설명·예제

textstring

필수

변환할 원문 텍스트 (최대 2,000자)예:

서울에서 부산까지는 5시간이 넘게 걸리고 거리는 400km쯤 된다. 5번 버스를 타고 가서 버튼을 5번 누르세요.

modestring

선택

normalize(기본) 또는 phonetic

응답과 성공 판정

HTTP 성공과 업무 결과를 구분하세요. 아래 서비스별 결과 필드가 실제 성공·실패를 나타냅니다.

응답 상태

{
  "data": {
    "text": "서울에서 부산까지는 다섯 시간이 넘게 걸리고 거리는 사백 킬로미터쯤 된다. 오 번 버스를 타고 가서 버튼을 다섯 번 누르세요.",
    "mode": "normalize",
    "input_length": 63,
    "output_length": 70,
    "ic_id": null,
    "result": 1,
    "msg": "",
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 20,
    "ms": 2874,
    "pl_id": 901236
  }
}

필드·타입

의미·조건

dataobject

아래 하위 항목을 확인하세요.

data.textstring

변환된 문장

data.modestring

적용된 변환 모드 (normalize 또는 phonetic)

data.input_lengthinteger

과금 기준 입력 글자 수 (앞뒤 공백 제외)

data.output_lengthinteger

변환 결과 글자 수

data.ic_id

아래 하위 항목을 확인하세요. null 허용.

data.resultinteger

아래 하위 항목을 확인하세요.

data.msgstring

아래 하위 항목을 확인하세요.

data.successinteger

아래 하위 항목을 확인하세요.

data.ic_id / result / msg / successstring

공통 래퍼 필드 (ic_id=null, result=success=1, msg="") null 허용.

apiobject

아래 하위 항목을 확인하세요.

api.successboolean

API 처리 성공 여부

api.costinteger

실제 차감된 포인트 (실패 시 0)

api.msinteger

서버 처리 소요시간(ms)

api.pl_idinteger

PaymentLog ID null 허용.

정적 연동 예시입니다. 실제 계정·개인정보를 조회하지 않습니다.

추가 입력 조건·전송 규칙

Header

이름

필수

설명

Content-Type

O

multipart/form-data; boundary는 클라이언트가 자동 설정합니다.

Authorization

O

Bearer 인증키

응답 상세

서비스 고유 응답·필드 상세 설명

응답 포맷

모든 응답은 공통 래퍼 { data, api } 구조입니다. 과금은 api.cost 에만 표기됩니다.

data

이름

타입

설명

text

String

변환된 문장

mode

String

적용된 변환 모드 (normalize 또는 phonetic)

input_length

Integer

과금 기준 입력 글자 수 (앞뒤 공백 제외)

output_length

Integer

변환 결과 글자 수

ic_id / result / msg / success

-

공통 래퍼 필드 (ic_id=null, result=success=1, msg="")

api

이름

타입

설명

success

Boolean

API 처리 성공 여부

cost

Integer

실제 차감된 포인트 (실패 시 0)

ms

Integer

서버 처리 소요시간(ms)

pl_id

Integer/null

PaymentLog ID

경로별 응답 예시와 필드 명세는 위 API 요청 설명에 붙어 있습니다. JSON을 파일로 저장하기 전에는 Content-Type과 오류를 확인하세요.

상태·오류·재시도

HTTP 상태 → API 처리 여부 → 업무 상태 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.

서비스별 코드·조건 전체 보기

에러 코드

HTTP

의미

400

text 누락, 2,000자 초과, 지원하지 않는 mode

402

잔액 부족 (선불 회원, 해당 요청의 과금액 이상 필요)

500

서버 설정 오류

502

변환 처리 중 일시적 오류 (과금되지 않으며 다시 요청할 수 있습니다)

공통 폼 입력 오류

FORM_DATA_INVALID · HTTP 400: 필드 이름·타입·배열 인덱스를 확인하세요. 인덱스는 0부터 연속으로 사용합니다.

FORM_DATA_FIELD_CONFLICT · HTTP 400: 같은 값과 중첩 경로를 동시에 지정하지 마세요.

MULTIPART_LIMIT_OR_PARSE_ERROR · HTTP 400/413: boundary·파일 크기·필드 개수를 확인하세요. 서비스별 제한이 우선 적용됩니다.

요금·제한·이용 조건

기능·제공 범위·요금·제한 전체 보기

Method

URL

POST

https://apick.app/rest/llm/text_pronunciation

과금 정책

입력 글자 수에 따라 과금됩니다. 100자까지 20포인트이고, 이후 100자마다 10포인트가 추가됩니다(1포인트 = 1원, 부가세별도). 글자 수는 앞뒤 공백을 뺀 text 길이이며, 변환 결과를 돌려준 요청만 과금합니다.

입력 글자 수

과금

1~100자

20P

101~200자

30P

201~300자

40P

901~1,000자

110P

1,901~2,000자

210P

계산식: 20 + 올림((글자 수 - 100) / 100) × 10 (100자 이하는 20P)

제한사항

구분

내용

입력 길이

최대 2,000자 (초과 시 400 반환)

최소 잔액

선불 회원은 해당 요청의 과금액 이상 잔액이 있어야 합니다. 부족하면 402를 반환합니다.

상태 관리

완전 무상태(stateless). 매 요청은 독립적인 단발 호출이며 같은 입력도 매번 새로 처리하고 과금합니다.

HTTP 메서드

POST 만 허용

변환 모드

mode

동작

예시

normalize (기본)

숫자·단위·기호·영문처럼 읽는 법이 표기에 드러나지 않는 부분만 한글로 풀어 씁니다. 일반 낱말의 표기는 그대로 둡니다.

국밥 5그릇을 같이 먹었다. → 국밥 다섯 그릇을 같이 먹었다.

phonetic

normalize 를 적용한 뒤 문장 전체를 실제 소리 나는 대로 적습니다.

국밥 5그릇을 같이 먹었다. → 국빱 다섣 끄르슬 가치 머걷따.

음성 합성기는 대부분 낱말의 발음 변환을 스스로 하므로 normalize 를 권장합니다. phonetic 은 발음 변환 기능이 없는 합성기에 넣거나 발음 표기 자체가 필요할 때 사용하세요.

어떤 변환을 해주나요?

대상

입력

결과

수량

오징어 5마리, 20명, 5세, 5살

오징어 다섯 마리, 스무 명, 오 세, 다섯 살

번호와 횟수

5번 버스 / 버튼을 5번

오 번 버스 / 버튼을 다섯 번

날짜·시각

2026년 10월 2일 오전 9시 30분

이천이십육 년 시월 이 일 오전 아홉 시 삼십 분

금액

12,500원, 3.5억원

만 이천오백 원, 삼억 오천만 원

단위

400km, 80km/h, -5℃, 32GB

사백 킬로미터, 시속 팔십 킬로미터, 영하 오 도, 삼십이 기가바이트

소수·퍼센트·비율

12.5%, 16:9

십이 점 오 퍼센트, 십육 대 구

전화번호·숫자 코드

010-1234-5678, 인증번호 105028

공일공, 일이삼사, 오육칠팔 / 인증번호 일공오공이팔

영문 약어·기술 용어

API, CPU, Node.js 22.22.3

에이피아이, 씨피유, 노드 제이에스 이십이 점 이십이 점 삼

같은 숫자라도 뒤에 오는 단위와 문맥에 따라 읽는 법을 정합니다. 원문의 의미와 숫자 값, 문장부호, 줄바꿈은 유지하며 변환된 문장만 반환합니다(부가 설명 없음).

연동 시 확인할 내용

예제는 경로별로 최소 요청과 오류 처리 포함 모드를 제공합니다. 실제 사용 환경의 시간 제한·취소·업무 성공 판정을 적용하세요.

추가 예제·서비스별 연동 안내

요청 예시 (cURL)

form-data 전체 예제 보기

응답 예시


{
  "data": {
    "text": "서울에서 부산까지는 다섯 시간이 넘게 걸리고 거리는 사백 킬로미터쯤 된다. 오 번 버스를 타고 가서 버튼을 다섯 번 누르세요.",
    "mode": "normalize",
    "input_length": 63,
    "output_length": 70,
    "ic_id": null,
    "result": 1,
    "msg": "",
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 20,
    "ms": 2874,
    "pl_id": 901236
  }
}

요청 예시 (소리 나는 대로 적기)

form-data 전체 예제 보기

기능·제공 범위

빠른 시작

요청과 응답

API 요청

입력 항목

응답과 성공 판정

Header

응답 상세

응답 포맷

data

api

상태·오류·재시도

에러 코드

요금·제한·이용 조건

과금 정책

제한사항

변환 모드

어떤 변환을 해주나요?

연동 시 확인할 내용

요청 예시 (cURL)

응답 예시

요청 예시 (소리 나는 대로 적기)

개발가이드 검색

AI•LLM

전체상품

API 체험하기

요금정책

고객지원

개발가이드