개발가이드

  • 개발가이드

텍스트 다듬기 AI

입력 텍스트(최대 10만 자)의 문법 오류, 맞춤법·오타, 어색한 표현, 문장 순서를 자연스럽게 다듬어 줍니다. 빠른 응답에 최적화되어 있으며 모델·파라미터는 서버가 모두 고정합니다.

정보

Method
URL
POST
https://apick.app/rest/llm/text_polish

과금 정책

본 API 는 토큰 수와 무관하게 요청당 100포인트(=100원, 부가세별도)로 고정 과금됩니다.

항목
값
과금 방식
건당 고정
단가
100 포인트 / 1회 요청
최소 잔액
100 포인트 (선불 v1)
PaymentLog uri
text_polish

제한사항

구분
내용
입력 길이
최대 100,000자 (초과 시 400 반환)
모델·파라미터
서버가 모두 고정합니다. 클라이언트에서 model, temperature, max_tokens, stream 등 어떤 파라미터를 보내도 무시됩니다.
상태 관리
완전 무상태(stateless). 세션·히스토리·응답 캐시를 사용하지 않으며, 매 요청은 독립적인 단발 호출입니다. 같은 입력이라도 매번 새로 처리됩니다.
응답 속도
빠른 응답에 최적화되어 운영됩니다.
HTTP 메서드
POST 만 허용

어떤 교정을 해주나요?

대상
설명
문법 오류
주어-술어 호응, 조사/어미 오용, 시제 불일치 등
맞춤법·오타
표기법 오류, 띄어쓰기, 자주 틀리는 오타
어색한 표현
비문, 번역 투, 불필요한 반복, 모호한 표현
문장 순서
논리 흐름에 맞게 문장·구 재배열

원문의 의미와 뉘앙스는 최대한 유지하며, 다듬어진 최종 텍스트만 반환합니다(부가 설명 없음).

요청

Header
이름
필수
설명
Content-Type
O
application/json
CL_AUTH_KEY
O
인증키(MD5)
Body (JSON)
이름
타입
필수
설명
text
String
O
다듬을 원문 텍스트 (최대 100,000자)

응답 포맷

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

data
이름
타입
설명
text
String
다듬어진 최종 텍스트
input_length
Integer
입력 원문 글자 수
output_length
Integer
다듬은 결과 글자 수
ic_id / result / msg / success
-
공통 래퍼 필드 (ic_id=null, result=success=1, msg="")
api
이름
타입
설명
success
Boolean
API 처리 성공 여부
cost
Integer
실제 차감된 포인트 (성공 시 100, 고정)
ms
Integer
서버 처리 소요시간(ms)
pl_id
Integer/null
PaymentLog ID

에러 코드

HTTP
의미
400
text 누락 또는 100,000자 초과
402
잔액 부족 (선불 v1, 최소 100포인트 필요)
500
서버 설정 오류 (api key 미설정)
502
LLM 응답 처리 중 일시적 오류

예시

요청 예시 (cURL)

curl -k -X POST "https://apick.app/rest/llm/text_polish" \
-H "Content-Type: application/json" \
-H "CL_AUTH_KEY: $API_KEY" \
-d '{
  "text": "어제 회의에서 결정된 내용은 다음과 같다 첫째로는 마감일을 일주일 미루기로햇고 둘째로 각자 담당할 기능을 정하기로 햇음. 근데 아직 디자인쪽 피드백이 안와서 확정은 다음주로 미뤄질듯."
}'
응답 예시

{
  "data": {
    "text": "어제 회의에서 결정된 내용은 다음과 같습니다. 첫째, 마감일을 일주일 연기하기로 하였고, 둘째, 각자 담당할 기능을 정하기로 하였습니다. 다만 아직 디자인팀의 피드백이 도착하지 않아 최종 확정은 다음 주로 미뤄질 것으로 보입니다.",
    "input_length": 104,
    "output_length": 132,
    "ic_id": null,
    "result": 1,
    "msg": "",
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 100,
    "ms": 2451,
    "pl_id": 901235
  }
}
현재 페이지 북마크