개발가이드

  • 개발가이드

텍스트 요약 AI

입력 텍스트(최대 10만 자)의 핵심 내용을 간결하고 정확하게 요약합니다. 빠른 응답에 최적화되어 있으며 모델·파라미터는 서버가 모두 고정합니다.

정보

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

과금 정책

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

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

제한사항

구분
내용
입력 길이
최대 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_summary" \
-H "Content-Type: application/json" \
-H "CL_AUTH_KEY: $API_KEY" \
-d '{
  "text": "최근 국내 소비자 물가 상승률이 2개월 연속 2%대에 머물렀다. 정부는 신선식품 수급 불안이 여전하나, 유가 하락 효과로 전반적 물가는 안정세를 찾고 있다고 평가했다. ..."
}'
응답 예시

{
  "data": {
    "text": "국내 소비자 물가 상승률이 2개월 연속 2%대를 유지한 가운데, 신선식품 가격 불안은 이어지고 있으나 유가 하락으로 전반적 물가는 안정세로 접어들었다는 정부 평가가 나왔다.",
    "input_length": 132,
    "output_length": 90,
    "ic_id": null,
    "result": 1,
    "msg": "",
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 100,
    "ms": 1832,
    "pl_id": 901234
  }
}
현재 페이지 북마크