APICK Korean data, building register, simple-auth lookups, OCR, search, image, video and TTS
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
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.
Look up the account holder name of a Korean bank account. 대한민국 은행 계좌의 예금주명을 조회합니다. 송금 전 예금주 확인 등에 사용합니다. bank_code 또는 bank_name 중 하나는 입력해야 합니다. [호출당 60포인트]
계좌번호 (숫자만, 하이픈 제외)
은행 코드 (bank_code Tool로 조회 가능, 예: 004)
은행명 (예: 국민). bank_code 대신 입력 가능
Tool list last changed Oct 23, 2026.
Look up the account holder name of a Korean bank account. 대한민국 은행 계좌의 예금주명을 조회합니다. 송금 전 예금주 확인 등에 사용합니다. bank_code 또는 bank_name 중 하나는 입력해야 합니다. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| bank_code | string | 은행 코드 (bank_code Tool로 조회 가능, 예: 004) |
| bank_name | string | 은행명 (예: 국민). bank_code 대신 입력 가능 |
| account_num* | string | 계좌번호 (숫자만, 하이픈 제외) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"account_num"
],
"properties": {
"bank_code": {
"type": "string",
"description": "은행 코드 (bank_code Tool로 조회 가능, 예: 004)"
},
"bank_name": {
"type": "string",
"description": "은행명 (예: 국민). bank_code 대신 입력 가능"
},
"account_num": {
"type": "string",
"description": "계좌번호 (숫자만, 하이픈 제외)"
}
}
}Amazon product by URL or ASIN: title, price, rating, reviews count, availability, seller, features, images. 아마존 상품 주소 또는 ASIN 으로 상품명·가격·평점·리뷰 수·재고·판매자·특징·이미지를 조회합니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| url | string | 아마존 상품 주소 (/dp/ASIN 형식, url 또는 asin 중 하나 필수) |
| asin | string | ASIN 10자리 (미국 아마존 기준) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"url": {
"type": "string",
"description": "아마존 상품 주소 (/dp/ASIN 형식, url 또는 asin 중 하나 필수)"
},
"asin": {
"type": "string",
"description": "ASIN 10자리 (미국 아마존 기준)"
}
}
}Get iOS app metadata and customer reviews by numeric app id. iOS 앱 정보(평점·가격·장르)와 고객 리뷰를 함께 돌려줍니다. country 기본 kr, page 로 리뷰 페이지를 넘깁니다(최대 10). [호출당 100포인트]
| Argument | Type | Description |
|---|---|---|
| page | integer | 리뷰 페이지 (기본 1, 최대 10) |
| appId* | string | iOS 앱 ID (숫자) |
| country | string | 국가 코드 (기본 kr) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"appId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "리뷰 페이지 (기본 1, 최대 10)"
},
"appId": {
"type": "string",
"pattern": "^[0-9]{1,12}$",
"description": "iOS 앱 ID (숫자)"
},
"country": {
"type": "string",
"pattern": "^[a-z]{2}$",
"description": "국가 코드 (기본 kr)"
}
}
}List Korean bank codes and names. 대한민국 은행 코드·은행명 전체 목록을 반환합니다. transfer_1won, account_realname Tool의 bank_code 입력값을 찾을 때 사용합니다. 무료입니다. [무료]
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Decode a base64-encoded image string back into an image file. base64 로 인코딩된 이미지 문자열을 원본 이미지 파일로 디코딩해 반환합니다. "data:image/타입;base64," 접두어가 붙은 문자열도 허용됩니다. [호출당 2포인트]
| Argument | Type | Description |
|---|---|---|
| base64* | string | 이미지 base64 문자열 (data:image/타입;base64, 접두어 허용) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"base64"
],
"properties": {
"base64": {
"type": "string",
"description": "이미지 base64 문자열 (data:image/타입;base64, 접두어 허용)"
}
}
}Analyze Korean public-sector award results: success-rate distribution and averages, winner concentration, low-rate notices. 공공기관 낙찰 결과를 모아 평균·중위 낙찰률, 낙찰률 분포, 업체별 낙찰 점유와 집중도(HHI), 저가 낙찰 공고를 분석합니다. 응답은 summary·distribution·competitors·low_rate·insights 이며 원문 목록은 제공하지 않습니다. [호출당 50포인트]
| Argument | Type | Description |
|---|---|---|
| pageNo | integer | 페이지 번호 (기본 1) |
| bizType | string | 업무구분 (물품·공사·용역·외자, 기본 용역) |
| endDate | string | 조회 종료일 (YYYYMMDD 또는 YYYYMMDDHHMM) |
| bidNtceNo | string | 입찰공고번호 (지정 시 공고번호로 조회) |
| numOfRows | integer | 페이지당 결과 수 (기본 10, 최대 999) |
| startDate | string | 조회 시작일 (YYYYMMDD 또는 YYYYMMDDHHMM) |
| indstrytyCd | string | 업종코드 (선택) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"pageNo": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "페이지 번호 (기본 1)"
},
"bizType": {
"enum": [
"물품",
"공사",
"용역",
"외자"
],
"type": "string",
"description": "업무구분 (물품·공사·용역·외자, 기본 용역)"
},
"endDate": {
"type": "string",
"description": "조회 종료일 (YYYYMMDD 또는 YYYYMMDDHHMM)"
},
"bidNtceNo": {
"type": "string",
"pattern": "^[A-Za-z0-9]*[0-9][A-Za-z0-9]*(?![\\s\\S])",
"maxLength": 20,
"minLength": 1,
"description": "입찰공고번호 (지정 시 공고번호로 조회)"
},
"numOfRows": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "페이지당 결과 수 (기본 10, 최대 999)"
},
"startDate": {
"type": "string",
"description": "조회 시작일 (YYYYMMDD 또는 YYYYMMDDHHMM)"
},
"indstrytyCd": {
"type": "string",
"description": "업종코드 (선택)"
}
}
}Analyze Korean public-sector bid notices: budget bands, agencies, industries, closing urgency and largest opportunities. 공공기관 입찰공고를 모아 예산구간·발주기관·업종 분포, 마감 임박 공고, 규모 상위 공고를 분석합니다. 응답은 summary·distribution·deadlines·largest·insights 이며 공고 원문 목록은 제공하지 않습니다. bizType 을 생략하면 용역 공고를 분석합니다. [호출당 50포인트]
| Argument | Type | Description |
|---|---|---|
| pageNo | integer | 페이지 번호 (기본 1) |
| bizType | string | 업무구분 (물품·공사·용역·외자, 기본 용역) |
| endDate | string | 조회 종료일 (YYYYMMDD 또는 YYYYMMDDHHMM) |
| bidNtceNo | string | 입찰공고번호 (지정 시 공고번호로 조회) |
| numOfRows | integer | 페이지당 결과 수 (기본 10, 최대 999) |
| startDate | string | 조회 시작일 (YYYYMMDD 또는 YYYYMMDDHHMM) |
| indstrytyCd | string | 업종코드 (선택) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"pageNo": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "페이지 번호 (기본 1)"
},
"bizType": {
"enum": [
"물품",
"공사",
"용역",
"외자"
],
"type": "string",
"description": "업무구분 (물품·공사·용역·외자, 기본 용역)"
},
"endDate": {
"type": "string",
"description": "조회 종료일 (YYYYMMDD 또는 YYYYMMDDHHMM)"
},
"bidNtceNo": {
"type": "string",
"pattern": "^[A-Za-z0-9]*[0-9][A-Za-z0-9]*(?![\\s\\S])",
"maxLength": 20,
"minLength": 1,
"description": "입찰공고번호 (지정 시 공고번호로 조회)"
},
"numOfRows": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "페이지당 결과 수 (기본 10, 최대 999)"
},
"startDate": {
"type": "string",
"description": "조회 시작일 (YYYYMMDD 또는 YYYYMMDDHHMM)"
},
"indstrytyCd": {
"type": "string",
"description": "업종코드 (선택)"
}
}
}Look up general status information of a Korean business by its 10-digit business registration number. 사업자등록번호로 해당 사업자의 일반 현황 정보(대표자, 주소, 직원수, 설립일, 업종, 업태, 종목, 연락처, 사업자상태, 과세유형 등)를 조회합니다. 법인은 financial_info=Y 로 기업재무정보(요약재무제표·재무상태표·손익계산서)를 추가 요금 없이 함께 받을 수 있습니다. [호출당 50포인트]
| Argument | Type | Description |
|---|---|---|
| biz_no* | string | 사업자등록번호 (숫자 10자리, 하이픈 제외, 예: 1234567890) |
| financial_info | string | Y 이면 법인의 기업재무정보(최근 3개 사업연도 요약재무제표, 최근 사업연도 재무상태표·손익계산서)를 기업재무정보 필드에 함께 반환합니다. 법인만 제공되며 추가 요금은 없습니다. 재무정보가 없으면 기업재무정보.조회결과=N 과 사유코드를 반환합니다. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"biz_no"
],
"properties": {
"biz_no": {
"type": "string",
"description": "사업자등록번호 (숫자 10자리, 하이픈 제외, 예: 1234567890)"
},
"financial_info": {
"enum": [
"Y",
"N"
],
"type": "string",
"description": "Y 이면 법인의 기업재무정보(최근 3개 사업연도 요약재무제표, 최근 사업연도 재무상태표·손익계산서)를 기업재무정보 필드에 함께 반환합니다. 법인만 제공되며 추가 요금은 없습니다. 재무정보가 없으면 기업재무정보.조회결과=N 과 사유코드를 반환합니다."
}
}
}Look up a Korean building register by parcel number or lot address. PNU 또는 시군구·법정동·번지로 표제부·총괄표제부·기본개요·층별개요·전유부·전유공용면적·주택가격·오수정화시설·부속지번·지역지구구역을 조회합니다. PNU(19자리) 또는 sigunguCd·bjdongCd 중 하나가 필요합니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| ji | string | 부번 (기본 0000) |
| bun | string | 본번. 숫자만 보내면 4자리로 채웁니다. |
| pnu | string | 필지고유번호 19자리. 주면 번지 항목은 무시합니다. |
| hoNm | string | 호 이름. floor·expos·area·price 전용 |
| type | string | 대장 종류 (기본 title) |
| flrNo | integer | 층 번호. area 전용. 지하는 음수 |
| dongNm | string | 동 이름. floor·expos·area·price 전용 |
| pageNo | integer | 쪽 번호 (기본 1) |
| endDate | string | 대장 생성일 범위 끝. title·recap 전용. 연·월만 보내면 그 달 마지막 날로 맞춥니다. |
| bjdongCd | string | 법정동코드 5자리 (pnu 가 없을 때) |
Validate email syntax, MX availability, and free or disposable domain status. 이메일 형식, MX 수신 가능 여부, 무료·일회용 메일 여부를 검사합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| email* | string | 이메일 주소 (예: [email protected]) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "이메일 주소 (예: [email protected])"
}
}
}Validate and format a phone number and check the carrier and line type. 전화번호 형식 검사와 통신사·회선유형 확인을 함께 제공합니다. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| number* | string | 전화번호 (예: 01012341234, 해외는 +국가코드 형식) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"number"
],
"properties": {
"number": {
"type": "string",
"description": "전화번호 (예: 01012341234, 해외는 +국가코드 형식)"
}
}
}Check whether a phone number has been reported for spam, advertising, or criminal use in Korea. 스팸/광고/범죄에 사용된 전화번호인지 조회합니다. 수신 전화 필터링, 이상 거래 탐지 등에 사용합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| number* | string | 전화번호 (예: 01012341234) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"number"
],
"properties": {
"number": {
"type": "string",
"description": "전화번호 (예: 01012341234)"
}
}
}Get a company financial package by corporate registration number and year. 요약재무제표·재무상태표·손익계산서를 한 번에 조회하고 부채비율·영업이익률·ROA·ROE·전년 대비 성장률을 계산해 돌려줍니다. [호출당 100포인트]
| Argument | Type | Description |
|---|---|---|
| crno* | string | 법인등록번호 (13자리, 하이픈 없이) |
| type | string | 조회 항목 (기본 all=통합) |
| scope | string | 연결·별도 구분 (기본 all) |
| bizYear | string | 사업연도 (YYYY, 생략하면 가장 최근 연도) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"crno"
],
"properties": {
"crno": {
"type": "string",
"description": "법인등록번호 (13자리, 하이픈 없이)"
},
"type": {
"enum": [
"all",
"summary",
"balance",
"income"
],
"type": "string",
"description": "조회 항목 (기본 all=통합)"
},
"scope": {
"enum": [
"all",
"consolidated",
"separate"
],
"type": "string",
"description": "연결·별도 구분 (기본 all)"
},
"bizYear": {
"type": "string",
"description": "사업연도 (YYYY, 생략하면 가장 최근 연도)"
}
}
}Coupang product by URL or product id: title, prices, discount, rating, reviews, stock, seller, options, categories and images. 쿠팡 상품 주소 또는 상품번호로 상품명·정가·판매가·할인율·평점·리뷰 수·재고·판매자·옵션·카테고리·이미지를 조회합니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| url | string | 쿠팡 상품 주소 (/vp/products/ 형식, url 또는 product_id 중 하나 필수) |
| product_id | string | 쿠팡 상품번호 (숫자) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"url": {
"type": "string",
"description": "쿠팡 상품 주소 (/vp/products/ 형식, url 또는 product_id 중 하나 필수)"
},
"product_id": {
"type": "string",
"description": "쿠팡 상품번호 (숫자)"
}
}
}Look up a Korean court auction case by case number and court. 법원 경매 사건번호와 법원(이름·코드)으로 사건 기본정보·매각기일·감정평가액·최저매각가격·진행상태를 조회합니다. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| court* | string | 법원 이름 또는 법원 코드 (예: 서울중앙지방법원) |
| case_no* | string | 사건번호 (예: 2024타경12345) — 연도·사건부호·번호 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"case_no",
"court"
],
"properties": {
"court": {
"type": "string",
"description": "법원 이름 또는 법원 코드 (예: 서울중앙지방법원)"
},
"case_no": {
"type": "string",
"description": "사건번호 (예: 2024타경12345) — 연도·사건부호·번호"
}
}
}Look up a YouTube channel profile and its latest uploaded videos. 유튜브 계정(채널) 정보와 최근 게시한 동영상 정보를 조회해 반환합니다. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| user_id* | string | 조회할 유튜브 채널 아이디(예: CNN)·핸들(@CNN)·채널 ID(UC…) 또는 채널 URL |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"user_id"
],
"properties": {
"user_id": {
"type": "string",
"description": "조회할 유튜브 채널 아이디(예: CNN)·핸들(@CNN)·채널 ID(UC…) 또는 채널 URL"
}
}
}Convert a DOCX (Word) file to a PDF file. DOCX 파일을 PDF 파일로 변환해 반환합니다. DOCX 형식의 파일만 허용됩니다. [호출당 80포인트]
| Argument | Type | Description |
|---|---|---|
| docx_url* | string | 다운로드 가능한 https URL (허용 형식: application/vnd.openxmlformats-officedocument.wordprocessingml.document) (최대 25MB) |
{
"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 a visible text watermark across an image. 이미지 파일에 텍스트 워터마크를 삽입한 PNG 이미지를 반환합니다. 글자 크기·색상·투명도·밀집도를 조절할 수 있으며, PNG, JPEG 등 일반 이미지 포맷을 지원합니다. [호출당 10포인트]
| 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) |
{
"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 a visible text watermark across every page of a PDF file. PDF 파일 전체 페이지에 텍스트 워터마크를 삽입한 PDF 를 반환합니다. 글자 크기·색상·투명도·각도·밀집도·적용 영역을 조절할 수 있으며, PDF 형식의 파일만 허용됩니다. [호출당 10포인트]
| 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) |
Extract preview thumbnail images from a video at regular intervals and return them as a ZIP file. 동영상에서 일정 구간마다 미리보기 이미지를 추출해 ZIP 파일로 반환합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| count | string | 추출할 이미지 개수 (범위: 0 ~ 200, 기본값 100) |
| width | string | 이미지 가로 길이 (범위: 100 ~ 2000, 기본값 480). 세로 길이는 가로 비율에 따라 자동 계산 |
| video_url* | string | 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/x-msvideo, video/webm, video/x-matroska) (최대 200MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"video_url"
],
"properties": {
"count": {
"type": "string",
"description": "추출할 이미지 개수 (범위: 0 ~ 200, 기본값 100)"
},
"width": {
"type": "string",
"description": "이미지 가로 길이 (범위: 100 ~ 2000, 기본값 480). 세로 길이는 가로 비율에 따라 자동 계산"
},
"video_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/x-msvideo, video/webm, video/x-matroska) (최대 200MB)"
}
}
}Detect faces in an image and blur (mosaic) them. 이미지 파일에서 얼굴을 인식해 해당 영역을 모자이크 처리한 이미지(JPEG)를 반환합니다. PNG, JPEG 등 일반 이미지 포맷을 지원합니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp, image/bmp) (최대 50MB) |
| threshold | number | 얼굴 추출 민감도 (0 ~ 0.9, 기본값 0.5, 작을수록 민감하게 추출) |
{
"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, 작을수록 민감하게 추출)"
}
}
}Detect faces in an image and return their coordinates. 이미지 파일에서 얼굴을 인식해 해당 좌표를 반환합니다. use_feature=1 입력 시 얼굴 특징 정보를 함께 반환합니다. [호출당 3포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, image/webp, image/bmp) (최대 50MB) |
| threshold | string | 얼굴 추출 민감도 (범위: 0 ~ 0.9, 기본값 0.5, 높을수록 정확한 얼굴만 추출) |
| use_feature | string | 얼굴 특징 정보 포함 여부 (포함: 1, 미포함: 0, 기본값 0) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"image_url"
],
"properties": {
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, image/webp, image/bmp) (최대 50MB)"
},
"threshold": {
"type": "string",
"description": "얼굴 추출 민감도 (범위: 0 ~ 0.9, 기본값 0.5, 높을수록 정확한 얼굴만 추출)"
},
"use_feature": {
"type": "string",
"description": "얼굴 특징 정보 포함 여부 (포함: 1, 미포함: 0, 기본값 0)"
}
}
}Find the APICK tools that best fit a task described in natural language (Korean or English) and return the top matches with a relevance label (high, medium, low). Use it before choosing among the many tools on this server. 자연어로 설명한 작업(한국어·영어)에 맞는 에이픽 Tool을 찾아 이름·제목·설명·관련도(high·medium·low)와 함께 상위 K개를 돌려줍니다. 인증키 없이 호출할 수 있습니다. [무료]
| Argument | Type | Description |
|---|---|---|
| task* | string | 하려는 작업 설명 (예: "사업자등록번호로 폐업 여부 확인", "Merge two PDF files") |
| limit | integer | 돌려받을 Tool 수 (기본 5, 최대 10) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task"
],
"properties": {
"task": {
"type": "string",
"maxLength": 500,
"minLength": 2,
"description": "하려는 작업 설명 (예: \"사업자등록번호로 폐업 여부 확인\", \"Merge two PDF files\")"
},
"limit": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "돌려받을 Tool 수 (기본 5, 최대 10)"
}
}
}Return ranked Korean address candidates for a partial input, merging road-name and jibun results. 입력 중인 주소의 도로명·지번 후보를 합쳐 일치도 순으로 제안합니다. 주소 입력 화면의 자동완성에 씁니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| size | integer | 후보 수 (기본 5, 최대 10) |
| query* | string | 입력 중인 주소 (예: 테헤란로) |
| category | string | 검색 범위 (기본 auto) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"size": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "후보 수 (기본 5, 최대 10)"
},
"query": {
"type": "string",
"maxLength": 50,
"description": "입력 중인 주소 (예: 테헤란로)"
},
"category": {
"enum": [
"auto",
"road",
"parcel"
],
"type": "string",
"description": "검색 범위 (기본 auto)"
}
}
}Score a list of Korean addresses for validity and completeness, grade them, and suggest alternatives for addresses that fail. 주소 목록의 유효성·완성도를 점수와 등급으로 진단하고, 찾지 못한 주소에는 대안 후보를 최대 3건 제시합니다. 고객 주소 데이터 정제에 씁니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| addrType | string | 주소 유형 (기본 auto) |
| addresses* | array | 진단할 주소 목록 (최대 20건) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"addresses"
],
"properties": {
"addrType": {
"enum": [
"auto",
"parcel",
"road"
],
"type": "string",
"description": "주소 유형 (기본 auto)"
},
"addresses": {
"type": "array",
"items": {},
"description": "진단할 주소 목록 (최대 20건)"
}
}
}Search Korean road-name and jibun addresses and return standardized text, parcel number, region code and coordinates. 도로명·지번 주소를 검색해 표준 주소, 필지번호, 지역코드, 좌표로 정리합니다. 도로명과 지번 결과를 합쳐 중복을 제거합니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| page | integer | 페이지 번호 (기본 1) |
| size | integer | 페이지당 결과 수 (기본 10, 최대 20) |
| query* | string | 검색어 (예: 테헤란로 152) |
| category | string | 검색 범위 (기본 auto) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "페이지 번호 (기본 1)"
},
"size": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "페이지당 결과 수 (기본 10, 최대 20)"
},
"query": {
"type": "string",
"maxLength": 100,
"description": "검색어 (예: 테헤란로 152)"
},
"category": {
"enum": [
"auto",
"road",
"parcel"
],
"type": "string",
"description": "검색 범위 (기본 auto)"
}
}
}Extract administrative names and codes (sido, sigungu, eupmyeondong, admin dong, lawd code) from an address or coordinates. 주소나 좌표에서 시도·시군구·읍면동·행정동 이름과 법정동코드·지역코드를 뽑습니다. lawdCd 는 실거래가 조회에 쓰는 지역코드입니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| x | number | 경도 |
| y | number | 위도 |
| point | string | 좌표 문자열 "경도,위도" |
| address | string | 주소. 좌표와 둘 중 하나는 필요합니다. |
| addrType | string | 주소 유형 (기본 auto) |
| includeZipcode | boolean | 우편번호 포함 여부 (기본 true) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"x": {
"type": "number",
"description": "경도"
},
"y": {
"type": "number",
"description": "위도"
},
"point": {
"type": "string",
"description": "좌표 문자열 \"경도,위도\""
},
"address": {
"type": "string",
"description": "주소. 좌표와 둘 중 하나는 필요합니다."
},
"addrType": {
"enum": [
"auto",
"parcel",
"road"
],
"type": "string",
"description": "주소 유형 (기본 auto)"
},
"includeZipcode": {
"type": "boolean",
"description": "우편번호 포함 여부 (기본 true)"
}
}
}Geocode a list of Korean addresses at once, deduplicating repeats and summarizing successes and failures. 주소 목록을 중복 제거해 최대 50건까지 한 번에 좌표·필지번호·행정코드로 바꾸고 성공·실패를 요약합니다. 엑셀·DB에 쌓인 주소를 한 번에 정리할 때 씁니다. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| dedupe | boolean | 중복 주소를 한 번만 조회 (기본 true) |
| addrType | string | 주소 유형 (기본 auto) |
| addresses* | array | 주소 목록. 최대 50건 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"addresses"
],
"properties": {
"dedupe": {
"type": "boolean",
"description": "중복 주소를 한 번만 조회 (기본 true)"
},
"addrType": {
"enum": [
"auto",
"parcel",
"road"
],
"type": "string",
"description": "주소 유형 (기본 auto)"
},
"addresses": {
"type": "array",
"items": {},
"description": "주소 목록. 최대 50건"
}
}
}Decide whether two Korean addresses refer to the same parcel or building, with distance and text similarity. 두 주소를 각각 좌표로 바꿔 같은 필지·같은 건물인지, 거리와 유사도는 얼마인지 판정합니다. 고객·거래처 주소 중복 정리에 씁니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| addrType | string | 주소 유형 (기본 auto) |
| addressA* | string | 첫 번째 주소 |
| addressB* | string | 두 번째 주소 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"addressA",
"addressB"
],
"properties": {
"addrType": {
"enum": [
"auto",
"parcel",
"road"
],
"type": "string",
"description": "주소 유형 (기본 auto)"
},
"addressA": {
"type": "string",
"maxLength": 200,
"description": "첫 번째 주소"
},
"addressB": {
"type": "string",
"maxLength": 200,
"description": "두 번째 주소"
}
}
}Look up an administrative district boundary and compute its area, perimeter, centroid and bounding box with an optional simplified GeoJSON. 시도·시군구·읍면동 경계를 받아 면적·둘레·중심점·경계 상자를 계산하고 단순화한 GeoJSON 을 돌려줍니다. 정점이 3000개를 넘으면 자동으로 단순화합니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| level | string | 행정구역 단계. 생략하면 이름으로 추정합니다. |
| query* | string | 행정구역 이름 또는 코드 (예: 강남구, 11680) |
| simplify | number | 단순화 허용 오차(m) |
| includeGeometry | boolean | 단순화한 경계 포함 여부 (기본 true) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"level": {
"enum": [
"L1",
"L2",
"L3",
"L4"
],
"type": "string",
"description": "행정구역 단계. 생략하면 이름으로 추정합니다."
},
"query": {
"type": "string",
"maxLength": 60,
"description": "행정구역 이름 또는 코드 (예: 강남구, 11680)"
},
"simplify": {
"type": "number",
"description": "단순화 허용 오차(m)"
},
"includeGeometry": {
"type": "boolean",
"description": "단순화한 경계 포함 여부 (기본 true)"
}
}
}Compute area, perimeter, centroid and bounding box of GeoJSON, check whether a point is inside, and return a simplified boundary. GeoJSON 의 면적·둘레·중심점·경계 상자를 계산하고, 지정점 포함 여부와 단순화 경계를 돌려줍니다. 면적은 m²·평·km² 로 함께 제공합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| x | number | 확인점 경도 |
| y | number | 확인점 위도 |
| point | string | 포함 여부를 확인할 점 "경도,위도" |
| geojson* | object | GeoJSON 객체 (Polygon·MultiPolygon·Feature·FeatureCollection, 1MB 이하) |
| simplify | number | 단순화 허용 오차(m). 0 이면 단순화하지 않습니다. |
| includeGeometry | boolean | 단순화한 도형 포함 여부 (기본 true) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"geojson"
],
"properties": {
"x": {
"type": "number",
"description": "확인점 경도"
},
"y": {
"type": "number",
"description": "확인점 위도"
},
"point": {
"type": "string",
"description": "포함 여부를 확인할 점 \"경도,위도\""
},
"geojson": {
"type": "object",
"description": "GeoJSON 객체 (Polygon·MultiPolygon·Feature·FeatureCollection, 1MB 이하)",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"simplify": {
"type": "number",
"description": "단순화 허용 오차(m). 0 이면 단순화하지 않습니다."
},
"includeGeometry": {
"type": "boolean",
"description": "단순화한 도형 포함 여부 (기본 true)"
}
}
}Measure segment distances, bearings, total length, polygon area, perimeter, centroid and bounding box from a coordinate list. 좌표 목록의 구간 거리·방위·총길이와 폐합 면적·중심점·경계 상자를 계산합니다. 지도에서 그린 경로나 필지 좌표를 바로 측량할 때 씁니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| mode | string | path 길이(기본), polygon 면적·둘레·중심점 |
| unit | string | 거리 단위 (기본 m) |
| matrix | boolean | 지점 간 거리 행렬 포함 여부 |
| coordinates* | array | 좌표 목록 (최대 200개). ["127.025,37.504", ...] 또는 [[경도,위도], ...] |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"coordinates"
],
"properties": {
"mode": {
"enum": [
"path",
"polygon"
],
"type": "string",
"description": "path 길이(기본), polygon 면적·둘레·중심점"
},
"unit": {
"enum": [
"m",
"km"
],
"type": "string",
"description": "거리 단위 (기본 m)"
},
"matrix": {
"type": "boolean",
"description": "지점 간 거리 행렬 포함 여부"
},
"coordinates": {
"type": "array",
"items": {},
"description": "좌표 목록 (최대 200개). [\"127.025,37.504\", ...] 또는 [[경도,위도], ...]"
}
}
}Analyze daily-life facilities around an address or coordinate by category, with nearest lists and average distance within a radius. 기준 주소·좌표 반경 안의 편의점·지하철역·학교·병원·약국 등을 분류별로 찾아 가까운 순서와 평균 거리로 요약합니다. 상권·입지 분석에 씁니다. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| x | number | 기준점 경도 |
| y | number | 기준점 위도 |
| limit | integer | 분류별 가까운 시설 수 (기본 5, 최대 10) |
| point | string | 기준점 "경도,위도" |
| radius | number | 반경(m). 기본 500 |
| address | string | 기준 주소. 좌표와 둘 중 하나는 필요합니다. |
| categories | array | 분류 이름 목록 (최대 6개). 생략하면 편의점·지하철역·학교·병원·약국 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"x": {
"type": "number",
"description": "기준점 경도"
},
"y": {
"type": "number",
"description": "기준점 위도"
},
"limit": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "분류별 가까운 시설 수 (기본 5, 최대 10)"
},
"point": {
"type": "string",
"description": "기준점 \"경도,위도\""
},
"radius": {
"type": "number",
"maximum": 2000,
"minimum": 100,
"description": "반경(m). 기본 500"
},
"address": {
"type": "string",
"description": "기준 주소. 좌표와 둘 중 하나는 필요합니다."
},
"categories": {
"type": "array",
"items": {},
"description": "분류 이름 목록 (최대 6개). 생략하면 편의점·지하철역·학교·병원·약국"
}
}
}Search places by name and enrich each result with category hierarchy, addresses, distance and bearing from an origin. 장소명으로 검색해 분류·주소·좌표를 정리하고, 기준점이 있으면 각 결과의 거리와 방위를 계산해 가까운 순으로 정렬합니다. radius 로 반경 밖 결과를 제외합니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| x | number | 기준점 경도. origin 대신 사용합니다. |
| y | number | 기준점 위도. origin 대신 사용합니다. |
| page | integer | 페이지 번호 (기본 1) |
| size | integer | 페이지당 결과 수 (기본 10, 최대 20) |
| sort | string | 정렬 (기본 distance, 기준점이 있을 때만 적용) |
| query* | string | 장소 검색어 |
| origin | string | 기준점 "경도,위도" (예: 127.025,37.504) |
| radius | number | 반경(m), 1~5000. 주면 반경 밖 결과를 제외합니다. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"x": {
"type": "number",
"description": "기준점 경도. origin 대신 사용합니다."
},
"y": {
"type": "number",
"description": "기준점 위도. origin 대신 사용합니다."
},
"page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "페이지 번호 (기본 1)"
},
"size": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "페이지당 결과 수 (기본 10, 최대 20)"
},
"sort": {
"enum": [
"distance",
"relevance"
],
"type": "string",
"description": "정렬 (기본 distance, 기준점이 있을 때만 적용)"
},
"query": {
"type": "string",
"maxLength": 100,
"description": "장소 검색어"
},
"origin": {
"type": "string",
"description": "기준점 \"경도,위도\" (예: 127.025,37.504)"
},
"radius": {
"type": "number",
"description": "반경(m), 1~5000. 주면 반경 밖 결과를 제외합니다."
}
}
}Convert coordinates into jibun and road addresses, postal code and administrative codes. 경위도 좌표를 지번·도로명 주소, 우편번호, 법정동·행정동 코드로 바꿉니다. 지도에서 고른 지점의 주소와 행정구역을 바로 확인할 때 씁니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| x | number | 경도 (-180~180). point 를 쓰지 않을 때 필요합니다. |
| y | number | 위도 (-90~90). point 를 쓰지 않을 때 필요합니다. |
| point | string | 좌표 문자열 "경도,위도" (예: 127.025,37.504) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"x": {
"type": "number",
"description": "경도 (-180~180). point 를 쓰지 않을 때 필요합니다."
},
"y": {
"type": "number",
"description": "위도 (-90~90). point 를 쓰지 않을 때 필요합니다."
},
"point": {
"type": "string",
"description": "좌표 문자열 \"경도,위도\" (예: 127.025,37.504)"
}
}
}Normalize a Korean address into standard jibun/road text, administrative codes, coordinates and postal code in one response. 지번·도로명 주소를 표준 표기, 법정동·행정동·지역 코드, 좌표, 우편번호로 한 번에 분해합니다. 주소 대신 19자리 필지번호를 주면 좌표 조회 없이 코드만 만듭니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| pnu | string | 필지번호 19자리. 주면 좌표 조회 없이 코드와 지번만 만듭니다. |
| address | string | 지번 또는 도로명 주소. pnu 와 둘 중 하나는 필요합니다. |
| addrType | string | 주소 유형 (기본 auto) |
| includeZipcode | boolean | 우편번호 포함 여부 (기본 true) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"pnu": {
"type": "string",
"pattern": "^[0-9]{19}$",
"description": "필지번호 19자리. 주면 좌표 조회 없이 코드와 지번만 만듭니다."
},
"address": {
"type": "string",
"description": "지번 또는 도로명 주소. pnu 와 둘 중 하나는 필요합니다."
},
"addrType": {
"enum": [
"auto",
"parcel",
"road"
],
"type": "string",
"description": "주소 유형 (기본 auto)"
},
"includeZipcode": {
"type": "boolean",
"description": "우편번호 포함 여부 (기본 true)"
}
}
}req_business_cert_bundle의 transactionId로 승인 상태와 사업자 증빙서류 통합발급 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 증명마다 result.businessRegistrationCert·result.vatTaxBaseCert·result.financialStatementCert에 따로 있습니다. 일부만 발급되면 status가 PARTIAL_SUCCESS이며 결과 단가는 그대로 청구되고, resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 126P (사업자등록증명·과세표준증명·표준재무제표증명 3종 묶음); 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_business_cert_bundle 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_business_cert_bundle 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}Check whether a Korean vehicle has a flood damage record, by VIN or license plate number. 차대번호(VIN) 또는 차량번호로 자동차의 침수 이력 여부를 조회합니다. 중고차 구매 전 확인 등에 사용합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| type* | string | 조회 종류. 1: 차대번호(VIN), 2: 차량번호 |
| value* | string | 차대번호(type=1, 17자리) 또는 차량번호(type=2) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"type",
"value"
],
"properties": {
"type": {
"type": "string",
"description": "조회 종류. 1: 차대번호(VIN), 2: 차량번호"
},
"value": {
"type": "string",
"description": "차대번호(type=1, 17자리) 또는 차량번호(type=2)"
}
}
}Check whether a Korean vehicle has a scrap/total-loss accident record, by VIN or license plate number. 차대번호(VIN) 또는 차량번호로 폐차사고처리 여부를 조회합니다. 중고차 구매 전 확인 등에 사용합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| type* | string | 조회 종류. 1: 차대번호(VIN), 2: 차량번호 |
| value* | string | 차대번호(type=1, 17자리) 또는 차량번호(type=2) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"type",
"value"
],
"properties": {
"type": {
"type": "string",
"description": "조회 종류. 1: 차대번호(VIN), 2: 차량번호"
},
"value": {
"type": "string",
"description": "차대번호(type=1, 17자리) 또는 차량번호(type=2)"
}
}
}req_cash_receipt_deduction의 transactionId로 승인 상태와 현금영수증 소득공제 내역 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.cashReceiptDeduction에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 60P × (1 + 0.5 × (incomeYears - 1)), 기본 60P; 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_cash_receipt_deduction 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_cash_receipt_deduction 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}req_driving_license의 transactionId로 승인 상태와 운전면허 조회 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.drivingLicense에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 반환 시 조회 범위별 과금, 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_driving_license 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_driving_license 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}req_employment의 transactionId로 승인 상태와 재직·보험료 확인 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.employment에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 반환 시 조회 범위별 과금, 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_employment 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_employment 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}req_health_checkup의 transactionId로 승인 상태와 국가 건강검진 결과 조회 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.healthCheckup에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 반환 시 조회 범위별 과금, 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_health_checkup 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_health_checkup 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}req_income_cert_bundle의 transactionId로 승인 상태와 소득 증빙서류 통합발급 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 증명마다 result.incomeAmountCert·result.pensionCreditCert에 따로 있습니다. 일부만 발급되면 status가 PARTIAL_SUCCESS이며 결과 단가는 그대로 청구되고, resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 84P (소득금액증명·공제확인서 2종 묶음); 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_income_cert_bundle 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_income_cert_bundle 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}req_nps_career_history의 transactionId로 승인 상태와 국민연금 경력 이력 조회 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.npsCareerHistory에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 반환 시 조회 범위별 과금, 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_nps_career_history 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_nps_career_history 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}req_nps_deduction_cert의 transactionId로 승인 상태와 국민연금 소득공제용 납부확인서 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.npsDeductionCert에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 60P × (1 + 0.5 × (years - 1)), 기본 60P; 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_nps_deduction_cert 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_nps_deduction_cert 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}req_nps_join_history의 transactionId로 승인 상태와 국민연금 가입내역 조회 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.npsJoinHistory에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 반환 시 조회 범위별 과금, 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_nps_join_history 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_nps_join_history 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}Retrieve a Korean Personal Customs Clearance Code (PCCC) by transaction ID. req_pccc 로 받은 tx_id 를 입력하면 처리 상태를 확인합니다. 아직 승인 전이면 status 는 pending, message 는 "인증 대기중입니다." 이며 과금되지 않습니다. 승인이 끝나면 개인통관고유부호·주소와 함께 조회 완료 시각 checked_at 을 반환하며 이때 과금됩니다. 조회는 정상 처리됐지만 발급된 부호가 없으면 message 는 "조회된 개인통관고유부호가 없습니다." 이고 과금되지 않습니다. 결과는 24시간 동안 재조회할 수 있고 재조회할 때마다 과금됩니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| tx_id* | string | req_pccc 응답의 트랜잭션 ID |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tx_id"
],
"properties": {
"tx_id": {
"type": "string",
"description": "req_pccc 응답의 트랜잭션 ID"
}
}
}req_personal_income의 transactionId로 승인 상태와 금융소득(이자·배당) 조회 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.personalIncome에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 반환 시 조회 범위별 과금, 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_personal_income 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_personal_income 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}req_tax_return_history의 transactionId로 승인 상태와 국세 신고내역 조회 결과를 조회합니다. AUTH_WAITING이면 휴대폰 승인을 기다리고 COLLECTING이면 잠시 후 같은 ID로 조회하세요. 최초 결과 반환 시 과금되며 유효기간 내 재조회는 무료입니다. resultAvailable과 status, errorCode를 확인하세요. 결과는 result.taxReturnHistory에 있으며 resultExpiresAt 이후에는 RESULT_EXPIRED가 반환되어 새 인증 접수가 필요합니다. [최초 결과 60P × (1 + 0.5 × (years - 1)), 기본 60P; 대기·유효기간 내 재조회 무료]
| Argument | Type | Description |
|---|---|---|
| transactionId* | string | 동일 상품의 req_tax_return_history 응답에서 받은 transactionId (소문자 16진수 32자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactionId"
],
"properties": {
"transactionId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "동일 상품의 req_tax_return_history 응답에서 받은 transactionId (소문자 16진수 32자리)"
}
}
}Read the invisible watermark code embedded in an image. 이미지에 삽입된 비가시성 워터마크 코드를 조회해 JSON 으로 반환합니다. 이미지가 일부 변형되어도 높은 확률로 워터마크를 확인할 수 있습니다. PNG, JPEG 등 일반 이미지 포맷을 지원합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp, image/bmp) (최대 50MB) |
{
"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)"
}
}
}Google image search by keyword: return image results (image URL, source link, title). 특정 키워드의 구글 이미지 검색 결과(이미지 URL·게시 페이지 링크·제목)를 조회합니다. page 로 결과 페이지를 넘겨 가며 조회할 수 있습니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| page | string | 검색 결과 조회 페이지 1~5 (기본값 1, 페이지당 20건) |
| keyword* | string | 검색할 키워드 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"keyword"
],
"properties": {
"page": {
"type": "string",
"description": "검색 결과 조회 페이지 1~5 (기본값 1, 페이지당 20건)"
},
"keyword": {
"type": "string",
"description": "검색할 키워드"
}
}
}Reverse image search: upload an image and get visually matching web pages and labels. 이미지 파일을 업로드해 해당 이미지와 관련된 웹 페이지(링크·이미지·텍스트)와 라벨을 조회합니다. 이미지 형식 파일만 허용됩니다. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, image/webp, image/gif, image/bmp) (최대 50MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"image_url"
],
"properties": {
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, image/webp, image/gif, image/bmp) (최대 50MB)"
}
}
}Google Maps place search: return up to 20 places (name, address, phone, rating, reviews, hours, coordinates) for a keyword. 키워드의 구글 지도 장소(상호·주소·전화·평점·리뷰 수·영업시간·좌표)를 최대 20곳 조회합니다. 처리에 보통 30~60초가 걸립니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| keyword* | string | 장소 검색어 (예: 강남역 카페, 1~200자) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"keyword"
],
"properties": {
"keyword": {
"type": "string",
"description": "장소 검색어 (예: 강남역 카페, 1~200자)"
}
}
}Google News search: return news results (title, publisher, published time, link) for a keyword. 키워드의 구글 뉴스 검색 결과(제목·언론사·게시 시각·링크)를 조회합니다. [호출당 5포인트]
| Argument | Type | Description |
|---|---|---|
| page | string | 결과 페이지 1~10 (기본값 1) |
| keyword* | string | 검색어 (1~200자) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"keyword"
],
"properties": {
"page": {
"type": "string",
"description": "결과 페이지 1~10 (기본값 1)"
},
"keyword": {
"type": "string",
"description": "검색어 (1~200자)"
}
}
}Google rank check: find where a domain ranks (1-100) in Google results for a keyword. 키워드로 구글을 검색했을 때 지정한 도메인이 1~100위 중 몇 위에 노출되는지 확인합니다. 순위를 정하는 데 필요한 구간을 모두 확인하지 못하면 결과 없이 실패로 끝나며 과금되지 않습니다. [호출당 50포인트]
| Argument | Type | Description |
|---|---|---|
| domain* | string | 순위를 확인할 도메인 (예: apick.app). 하위 도메인도 함께 찾습니다 |
| keyword* | string | 검색어 (1~200자) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"keyword",
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "순위를 확인할 도메인 (예: apick.app). 하위 도메인도 함께 찾습니다"
},
"keyword": {
"type": "string",
"description": "검색어 (1~200자)"
}
}
}Google keyword search: return web search results (link, title, snippet) for a keyword. 특정 키워드의 구글 검색 결과(링크·제목·요약)를 조회합니다. page 로 결과 페이지를 넘겨 가며 조회할 수 있습니다. [호출당 5포인트]
| Argument | Type | Description |
|---|---|---|
| page | string | 검색 결과 조회 페이지 (기본값 1) |
| keyword* | string | 검색할 키워드 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"keyword"
],
"properties": {
"page": {
"type": "string",
"description": "검색 결과 조회 페이지 (기본값 1)"
},
"keyword": {
"type": "string",
"description": "검색할 키워드"
}
}
}Google Shopping search: return product results (title, price, shop, rating, link) for a keyword. 키워드의 구글 쇼핑 검색 결과(상품명·가격·판매처·평점·링크)를 조회합니다. [호출당 5포인트]
| Argument | Type | Description |
|---|---|---|
| page | string | 결과 페이지 1~10 (기본값 1) |
| keyword* | string | 검색어 (1~200자) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"keyword"
],
"properties": {
"page": {
"type": "string",
"description": "결과 페이지 1~10 (기본값 1)"
},
"keyword": {
"type": "string",
"description": "검색어 (1~200자)"
}
}
}Mask resident registration numbers found in an image and return the masked image. 이미지에서 주민등록번호를 인식해 지정한 방식으로 가린 이미지를 반환합니다. 이미지 파일과 type(1: 주민등록번호 전체 가림, 2: 뒷자리 전체 가림, 3: 뒷자리 첫 숫자 제외 가림, 4: 주민등록번호와 주소 가림)을 모두 입력해야 합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| type* | string | 가림 처리 타입 (1: 주민등록번호 전체, 2: 뒷자리 전체, 3: 뒷자리 첫 숫자 제외, 4: 주민등록번호+주소) |
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/jpeg, image/png) (최대 50MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"type",
"image_url"
],
"properties": {
"type": {
"type": "string",
"description": "가림 처리 타입 (1: 주민등록번호 전체, 2: 뒷자리 전체, 3: 뒷자리 첫 숫자 제외, 4: 주민등록번호+주소)"
},
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/jpeg, image/png) (최대 50MB)"
}
}
}Check whether a Korean vehicle has unpaid expressway (Hi-pass) tolls by plate number. 차량번호로 고속도로 통행료 미납 대상 여부와 미납 건수를 조회합니다. 미납이 없으면(unpaid_target=false) 과금되지 않습니다. 미납 금액·통행 내역은 제공하지 않습니다. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| car_no* | string | 차량번호. 예: 12가3456, 서울12가3456 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"car_no"
],
"properties": {
"car_no": {
"type": "string",
"description": "차량번호. 예: 12가3456, 서울12가3456"
}
}
}Look up Korean public holidays for a given year and month. 해당 년월의 대한민국 공휴일 정보를 조회합니다. 영업일 계산, 일정 관리 등에 사용합니다. [호출당 3포인트]
| Argument | Type | Description |
|---|---|---|
| year* | string | 조회 년도 (1900 ~ 2200, 예: 2024) |
| month* | string | 조회 월 (1 ~ 12, 예: 02) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"year",
"month"
],
"properties": {
"year": {
"type": "string",
"description": "조회 년도 (1900 ~ 2200, 예: 2024)"
},
"month": {
"type": "string",
"description": "조회 월 (1 ~ 12, 예: 02)"
}
}
}Render HTML code into a PDF file. HTML 코드를 렌더링해 PDF 파일로 변환합니다. HTML 문자열을 입력하면 변환된 PDF 파일을 반환합니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| html* | string | 변환할 HTML 코드 |
| pagination | integer | 페이지 번호 표시 여부 (0: 없음(기본값), 1: 표시) |
{
"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: 표시)"
}
}
}Verify the authenticity of a Korean resident registration card (jumin-deungnokjeung) using text input. 주민등록증의 기재 정보를 입력해 진위 여부를 확인합니다. name, rrn1, rrn2, date 네 항목을 모두 입력해야 하며, date는 숫자만 허용됩니다(예: 20230101). 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| date* | string | 발급일자 (숫자만, 예: 20230101) |
| name* | string | 성명 |
| rrn1* | string | 주민등록번호 앞 6자리 |
| rrn2* | string | 주민등록번호 뒤 7자리 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"rrn1",
"rrn2",
"date"
],
"properties": {
"date": {
"type": "string",
"description": "발급일자 (숫자만, 예: 20230101)"
},
"name": {
"type": "string",
"description": "성명"
},
"rrn1": {
"type": "string",
"description": "주민등록번호 앞 6자리"
},
"rrn2": {
"type": "string",
"description": "주민등록번호 뒤 7자리"
}
}
}Check Korean driver license number and personal details. ghost_num is optional, may be empty, and is not used in the match decision. 운전면허번호와 인적사항을 조회합니다. birth_y, birth_m, birth_d, name과 licen_no0~licen_no3은 필수입니다. ghost_num(식별번호)은 생략·빈값·임의 문자열 모두 허용하며 전달값을 판정에 사용하지 않습니다. rrn1, rrn2도 선택 입력입니다. 암호일련번호 자체나 실물 면허증의 위·변조 여부는 검증하지 않습니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| name* | string | 성명 |
| rrn1 | string | 주민등록번호 앞 6자리 (선택) |
| rrn2 | string | 주민등록번호 뒤 7자리 (선택) |
| birth_d* | string | 생년월일 - 일 (예: 01) |
| birth_m* | string | 생년월일 - 월 (예: 01) |
| birth_y* | string | 생년월일 - 년 (예: 2000) |
| ghost_num | string | 식별번호 (선택, 생략·빈값 허용, 전달값은 판정에 사용하지 않음) |
| licen_no0* | string | 면허번호 1구획 (예: 21) |
Verify the authenticity of a Korean passport using text input. 여권의 기재 정보를 입력해 진위 여부를 확인합니다. name, pass_num, made_date, exp_date, birth_date 다섯 항목을 모두 입력해야 하며, 일자 세 항목은 숫자만 허용됩니다(예: 20230101). 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| name* | string | 성명 |
| exp_date* | string | 만료일자 (숫자만, 예: 20330101) |
| pass_num* | string | 여권번호 (예: M00000000) |
| made_date* | string | 발급일자 (숫자만, 예: 20230101) |
| birth_date* | string | 생년월일 (숫자만, 예: 20000101) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"pass_num",
"made_date",
"exp_date",
"birth_date"
],
"properties": {
"name": {
"type": "string",
"description": "성명"
},
"exp_date": {
"type": "string",
"description": "만료일자 (숫자만, 예: 20330101)"
},
"pass_num": {
"type": "string",
"description": "여권번호 (예: M00000000)"
},
"made_date": {
"type": "string",
"description": "발급일자 (숫자만, 예: 20230101)"
},
"birth_date": {
"type": "string",
"description": "생년월일 (숫자만, 예: 20000101)"
}
}
}Verify the authenticity of a Korean resident registration certificate (jumin-deungnok-deungbon) using text input. 주민등록등본·초본의 문서확인번호로 진위 여부를 확인합니다. 문서확인번호를 네 구획으로 나눈 doc_num1~doc_num4(마지막 구획은 4~5자리)와 발급 종류 type(1: 온라인 발급, 2: 기타 발급)을 보냅니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| type* | string | 발급 경로 구분 (1: 인터넷으로 발급한 등본, 2: 그 밖의 경로로 발급한 등본) |
| doc_num1* | string | 문서확인번호 1구획 (4자리) |
| doc_num2* | string | 문서확인번호 2구획 (4자리) |
| doc_num3* | string | 문서확인번호 3구획 (4자리) |
| doc_num4* | string | 문서확인번호 4구획 (4~5자리) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"doc_num1",
"doc_num2",
"doc_num3",
"doc_num4",
"type"
],
"properties": {
"type": {
"type": "string",
"description": "발급 경로 구분 (1: 인터넷으로 발급한 등본, 2: 그 밖의 경로로 발급한 등본)"
},
"doc_num1": {
"type": "string",
"description": "문서확인번호 1구획 (4자리)"
},
"doc_num2": {
"type": "string",
"description": "문서확인번호 2구획 (4자리)"
},
"doc_num3": {
"type": "string",
"description": "문서확인번호 3구획 (4자리)"
},
"doc_num4": {
"type": "string",
"description": "문서확인번호 4구획 (4~5자리)"
}
}
}Verify the authenticity of a Korean alien registration card (residence card) using text input. 외국인등록증의 기재 정보를 입력해 진위 여부를 확인합니다. rrn(외국인등록번호 13자리)과 made_date(발급일자 10자리, 예: 2020-01-01)는 필수이며, card_sn(뒷면 일련번호)은 입력 시 11자리여야 하고 2011-01-01 이후 발급된 등록증은 필수입니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| rrn* | string | 외국인등록번호 (숫자 13자리) |
| card_sn | string | 뒷면 일련번호 (11자리). 2011-01-01 이후 발급분은 필수 |
| made_date* | string | 발급일자 (10자리, 예: 2020-01-01) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"rrn",
"made_date"
],
"properties": {
"rrn": {
"type": "string",
"description": "외국인등록번호 (숫자 13자리)"
},
"card_sn": {
"type": "string",
"description": "뒷면 일련번호 (11자리). 2011-01-01 이후 발급분은 필수"
},
"made_date": {
"type": "string",
"description": "발급일자 (10자리, 예: 2020-01-01)"
}
}
}Verify the authenticity of a Korean resident registration card from an image or PDF file. 주민등록증 이미지 또는 PDF 파일을 업로드하면 기재 정보를 자동 인식해 진위 여부를 확인합니다. 텍스트 입력 없이 파일 하나만 전달하면 됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, application/pdf) (최대 50MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"image_url"
],
"properties": {
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, application/pdf) (최대 50MB)"
}
}
}Verify the authenticity of a Korean driver license from an image or PDF file. 운전면허증 이미지 또는 PDF 파일을 업로드하면 기재 정보를 자동 인식해 진위 여부를 확인합니다. 텍스트 입력 없이 파일 하나만 전달하면 됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, application/pdf) (최대 50MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"image_url"
],
"properties": {
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, application/pdf) (최대 50MB)"
}
}
}Verify the authenticity of a Korean passport from an image or PDF file. 여권 인적사항면 이미지 또는 PDF 파일을 업로드하면 기재 정보를 자동 인식해 진위 여부를 확인합니다. 텍스트 입력 없이 파일 하나만 전달하면 됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, application/pdf) (최대 50MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"image_url"
],
"properties": {
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, application/pdf) (최대 50MB)"
}
}
}Verify the authenticity of a Korean resident registration certificate from an image or PDF file. 주민등록등본 이미지 또는 PDF 파일을 업로드하면 문서확인번호 등 기재 정보를 자동 인식해 진위 여부를 확인합니다. 텍스트 입력 없이 파일 하나만 전달하면 됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, application/pdf) (최대 50MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"image_url"
],
"properties": {
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, application/pdf) (최대 50MB)"
}
}
}Verify the authenticity of a Korean alien registration card (residence card) from an image or PDF file. 외국인등록증 이미지 또는 PDF 파일을 업로드하면 기재 정보를 자동 인식해 진위 여부를 확인합니다. card_sn(뒷면 일련번호 11자리)은 선택 입력이며, 2011-01-01 이후 발급된 등록증은 필수입니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| card_sn | string | 뒷면 일련번호 (11자리). 2011-01-01 이후 발급분은 필수 |
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, application/pdf) (최대 50MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"image_url"
],
"properties": {
"card_sn": {
"type": "string",
"description": "뒷면 일련번호 (11자리). 2011-01-01 이후 발급분은 필수"
},
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, application/pdf) (최대 50MB)"
}
}
}Extract key fields from a Korean driver license image and mask the last 6 digits of the RRN. 운전면허증(주민등록번호 표기형) 이미지에서 지정 정보를 추출하고 주민등록번호 뒷자리 6자리를 마스킹한 이미지를 함께 반환합니다. PNG 또는 JPEG 이미지 파일 하나만 전달하면 되며, 마스킹된 이미지는 JSON 응답의 masked_image 필드에 base64로 포함됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/jpeg, image/png) (최대 50MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"image_url"
],
"properties": {
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/jpeg, image/png) (최대 50MB)"
}
}
}Extract key fields from a Korean resident registration card image and mask the last 6 digits of the RRN. 주민등록증 이미지에서 지정 정보를 추출하고 주민등록번호 뒷자리 6자리를 마스킹한 이미지를 함께 반환합니다. PNG 또는 JPEG 이미지 파일 하나만 전달하면 되며, 마스킹된 이미지는 JSON 응답의 masked_image 필드에 base64로 포함됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/jpeg, image/png) (최대 50MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"image_url"
],
"properties": {
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/jpeg, image/png) (최대 50MB)"
}
}
}Extract key fields from a passport image and mask the passport number and MRZ area. 여권 인적사항면 이미지에서 지정 정보를 추출하고 여권번호 및 MRZ 영역을 마스킹한 이미지를 함께 반환합니다. MRZ 2줄이 포함되도록 촬영한 PNG 또는 JPEG 이미지 파일 하나만 전달하면 되며, 마스킹된 이미지는 JSON 응답의 masked_image 필드에 base64로 포함됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/jpeg, image/png) (최대 50MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"image_url"
],
"properties": {
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/jpeg, image/png) (최대 50MB)"
}
}
}Extract key fields from a Korean residence card, permanent resident card, or overseas Korean resident card image and mask the last 6 digits of the registration or domestic residence report number. 외국인등록증·영주증·외국국적동포 국내거소신고증 이미지에서 지정 정보를 추출하고 등록번호 또는 거소신고번호 뒷자리 6자리를 마스킹한 이미지를 함께 반환합니다. 한 번에 신분증 한 장이 포함된 PNG 또는 JPEG 이미지만 전달해야 하며, 마스킹된 이미지는 JSON 응답의 masked_image 필드에 base64로 포함됩니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/jpeg, image/png) (최대 50MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"image_url"
],
"properties": {
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/jpeg, image/png) (최대 50MB)"
}
}
}이미지 1~50장의 비동기 생성 또는 편집 작업을 접수합니다. 요금은 품질별 장당 고정가(기본 40P·고급 350P·최고급 1,400P)이며 장수만큼 선차감하고 실패한 장은 환급합니다. 같은 요청도 매번 새 작업으로 접수하며, 접수 후에는 취소할 수 없습니다. [장당 기본 40P · 고급 350P · 최고급 1,400P]
| Argument | Type | Description |
|---|---|---|
| mode* | string | 작업 방식 |
| size | string | 표준 출력 크기, 기본 1024x1024 |
| prompt* | string | 생성 또는 편집 지시, 최대 28,000자 |
| quality | string | 이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic |
| image_url | string | 편집 모드에서 변경할 원본 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| background | string | 배경 방식 |
| image_count* | integer | 만들 이미지 장수, 1~50 |
| output_format | string | 출력 포맷 |
| reference_image_url | string | 생성 모드에서 사용할 참고 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
완료된 대량 작업 결과 중 지정한 한 장을 이미지 콘텐츠로 반환합니다. [무료]
| Argument | Type | Description |
|---|---|---|
| index* | integer | 0부터 시작하는 이미지 번호 |
| job_id* | string | 작업 ID |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id",
"index"
],
"properties": {
"index": {
"type": "integer",
"maximum": 49,
"minimum": 0,
"description": "0부터 시작하는 이미지 번호"
},
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "작업 ID"
}
}
}대량 이미지 작업의 진행 상태, 선차감·환급·현재 차감 포인트를 조회합니다. [무료]
| Argument | Type | Description |
|---|---|---|
| job_id* | string | 작업 ID |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "작업 ID"
}
}
}원본 이미지와 편집 지시로 이미지 한 장을 편집합니다. 요금은 품질별 장당 고정가(기본 40P·고급 350P·최고급 1,400P)이며, 같은 요청을 다시 보내도 매번 새로 편집하고 과금합니다. [장당 기본 40P · 고급 350P · 최고급 1,400P]
| Argument | Type | Description |
|---|---|---|
| size | string | 표준 출력 크기, 기본 1024x1024 |
| prompt* | string | 편집 지시, 최대 28,000자 |
| quality | string | 이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic |
| image_url* | string | 원본 이미지 — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| background | string | 배경 방식 |
| output_format | string | 출력 포맷 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"prompt",
"image_url"
],
"properties": {
"size": {
"enum": [
"1024x1024",
"1536x1024",
"1024x1536",
"1152x864",
"864x1152"
],
"type": "string",
"description": "표준 출력 크기, 기본 1024x1024"
},
"prompt": {
"type": "string",
"maxLength": 28000,
"description": "편집 지시, 최대 28,000자"
},
"quality": {
"enum": [
"basic",
"advanced",
"premium"
],
"type": "string",
"description": "이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic"
},
"image_url": {
"type": "string",
"description": "원본 이미지 — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"background": {
"enum": [
"auto",
"opaque",
"transparent"
],
"type": "string",
"description": "배경 방식"
},
"output_format": {
"enum": [
"png",
"jpeg",
"webp"
],
"type": "string",
"description": "출력 포맷"
}
}
}텍스트만 사용하거나 참고 이미지와 텍스트를 함께 사용해 이미지 한 장을 생성합니다. 요금은 품질별 장당 고정가(기본 40P·고급 350P·최고급 1,400P)이며, 같은 요청을 다시 보내도 매번 새로 생성하고 과금합니다. [장당 기본 40P · 고급 350P · 최고급 1,400P]
| Argument | Type | Description |
|---|---|---|
| size | string | 표준 이미지 크기, 기본 1024x1024 |
| prompt* | string | 생성 프롬프트, 최대 28,000자 |
| quality | string | 이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic |
| background | string | 배경 방식 |
| output_format | string | 출력 포맷 |
| reference_image_url | string | 새 이미지의 제품·인물·색감·구도 참고용 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"prompt"
],
"properties": {
"size": {
"enum": [
"1024x1024",
"1536x1024",
"1024x1536",
"1152x864",
"864x1152"
],
"type": "string",
"description": "표준 이미지 크기, 기본 1024x1024"
},
"prompt": {
"type": "string",
"maxLength": 28000,
"description": "생성 프롬프트, 최대 28,000자"
},
"quality": {
"enum": [
"basic",
"advanced",
"premium"
],
"type": "string",
"description": "이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic"
},
"background": {
"enum": [
"auto",
"opaque",
"transparent"
],
"type": "string",
"description": "배경 방식"
},
"output_format": {
"enum": [
"png",
"jpeg",
"webp"
],
"type": "string",
"description": "출력 포맷"
},
"reference_image_url": {
"type": "string",
"description": "새 이미지의 제품·인물·색감·구도 참고용 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
}
}
}Compare a base image with another image and return a similarity score. 기준 이미지와 비교 대상 이미지의 유사도를 분석해 점수를 반환합니다. 원본 검증, 중복 이미지 탐지 등에 사용합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, image/webp, image/bmp) (최대 50MB) |
| compare_image_url* | string | 다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, image/webp, image/bmp) (최대 50MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"image_url",
"compare_image_url"
],
"properties": {
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, image/webp, image/bmp) (최대 50MB)"
},
"compare_image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, image/webp, image/bmp) (최대 50MB)"
}
}
}Check your APICK account balance and status. 현재 인증 키에 연결된 APICK 계정의 잔여 포인트와 계정 상태 정보를 조회합니다. 무료입니다. [무료]
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Instagram post or reel by URL: likes, comments count, views, caption, hashtags and media URLs. 인스타그램 게시물·릴스 주소로 좋아요·댓글 수·조회수·캡션·해시태그·미디어 주소를 조회합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| url* | string | 인스타그램 게시물·릴스 주소 (예: https://www.instagram.com/p/코드/ 또는 /reel/코드/) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "인스타그램 게시물·릴스 주소 (예: https://www.instagram.com/p/코드/ 또는 /reel/코드/)"
}
}
}Instagram public profile: followers, following, posts count, bio, verification and the 12 latest posts. 인스타그램 공개 계정의 팔로워·팔로잉·게시물 수·소개·인증 여부와 최근 게시물 12개를 조회합니다. 처리에 보통 40~60초가 걸립니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| url | string | 인스타그램 프로필 주소 (예: https://www.instagram.com/natgeo/) |
| username | string | 인스타그램 사용자명 (username 또는 url 중 하나 필수) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"url": {
"type": "string",
"description": "인스타그램 프로필 주소 (예: https://www.instagram.com/natgeo/)"
},
"username": {
"type": "string",
"description": "인스타그램 사용자명 (username 또는 url 중 하나 필수)"
}
}
}Look up the historical IP address changes of a domain. 도메인에 대한 IP 주소 변경 이력 정보를 조회합니다. 최상위 도메인 기준으로 조회되며 하위 도메인은 추적되지 않습니다. [호출당 100포인트]
| Argument | Type | Description |
|---|---|---|
| domain* | string | 검색할 도메인 (예: apick.app) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "검색할 도메인 (예: apick.app)"
}
}
}Convert JSON data into an Excel (XLSX) file. JSON 데이터를 EXCEL(XLSX) 파일로 변환해 반환합니다. data_list 는 객체 배열([{"컬럼":"값", ...}, ...]) 또는 2차원 배열([[...], ...]) 형식을 지원합니다. [호출당 1포인트]
| Argument | Type | Description |
|---|---|---|
| data_list* | array | 변환할 데이터 목록. 객체 배열 또는 2차원 배열 (2차원 배열은 모든 행의 열 개수가 같아야 함) |
| sheet_name | string | 엑셀 시트 이름 |
{
"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": "엑셀 시트 이름"
}
}
}Submit an asynchronous Kling video generation job. Select version and tier; supported modes, durations and prices depend on the selected version. Kling 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, kling_jobs_status Tool로 상태를 조회하고 완료되면 응답의 result_url(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 duration × 초당 410포인트가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다. [기본 버전 기준: 초당 410포인트 × duration(초). 다른 버전은 개발가이드의 버전별 요금표 참고.]
| Argument | Type | Description |
|---|---|---|
| mode | string | 입력 방식 — 'text'(텍스트만) | 'image'(첫 프레임 이미지 지정) | 'reference'(참조 이미지·영상으로 주체 지정). 기본 text |
| tier | string | 품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다. |
| audio | boolean | 오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다. |
| prompt* | string | 영상 생성 프롬프트, 최대 2,000자 |
| version | string | 영상 모델 버전. 생략 시 3.0. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요. |
| duration | integer | 영상 길이(초), 전체 버전 범위 3~15. 허용 값과 기본값은 버전·등급별로 다릅니다. |
| cfg_scale | number | 프롬프트 반영 강도(0~1), 기본 0.5 |
| image_url | string | image 모드에서 사용할 첫 프레임 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB) |
Check the status of a Kling video generation job submitted via kling_jobs_create. Kling 영상 작업의 진행 상태를 조회합니다. 완료되면 응답의 result_url(REST 다운로드 주소)로 안내하며, 결과는 완료 후 7일간 유효합니다. 무료입니다. [무료]
| Argument | Type | Description |
|---|---|---|
| job_id* | string | 작업 ID |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "작업 ID"
}
}
}Look up real estate transaction price records in Korea by region, property type, and year. 시/도·시/군/구, 부동산 유형, 년도를 지정해 부동산 실거래 이력을 조회합니다. addr1 값이 잘못되면 응답의 options 필드로 선택 가능한 지역 목록을 안내합니다. [호출당 100포인트]
| Argument | Type | Description |
|---|---|---|
| type* | string | 유형 코드 A~H 중 하나. A:아파트, B:연립/다세대, C:단독/다가구, D:오피스텔, E:분양/입주권, F:상업/업무용, G:토지, H:공장/창고등 |
| year* | string | 조회 년도 (1950 ~ 현재 년도, 예: 2025) |
| addr1* | string | 도/광역시/특별시 정식 명칭 (예: 서울특별시, 경기도, 부산광역시) |
| addr2* | string | 시/군/구 (예: 금천구) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"addr1",
"addr2",
"type",
"year"
],
"properties": {
"type": {
"type": "string",
"description": "유형 코드 A~H 중 하나. A:아파트, B:연립/다세대, C:단독/다가구, D:오피스텔, E:분양/입주권, F:상업/업무용, G:토지, H:공장/창고등"
},
"year": {
"type": "string",
"description": "조회 년도 (1950 ~ 현재 년도, 예: 2025)"
},
"addr1": {
"type": "string",
"description": "도/광역시/특별시 정식 명칭 (예: 서울특별시, 경기도, 부산광역시)"
},
"addr2": {
"type": "string",
"description": "시/군/구 (예: 금천구)"
}
}
}LinkedIn company page by URL: name, about, industries, company size, headquarters, followers, employees and updates. 링크드인 회사 주소로 회사명·소개·업종·규모·본사·팔로워·임직원 수·특기·최근 소식을 조회합니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| url* | string | 링크드인 회사 주소 (예: https://www.linkedin.com/company/{아이디}) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "링크드인 회사 주소 (예: https://www.linkedin.com/company/{아이디})"
}
}
}LinkedIn job posting by URL: title, company, location, employment type, seniority, industries, description, posted date and applicants. 링크드인 채용공고 주소로 직무·회사·근무지·고용형태·경력수준·산업·공고 본문·게시일·지원자 수를 조회합니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| url* | string | 링크드인 채용공고 주소 (예: https://www.linkedin.com/jobs/view/{번호}) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "링크드인 채용공고 주소 (예: https://www.linkedin.com/jobs/view/{번호})"
}
}
}LinkedIn public profile by URL: name, position, about, experience, education, followers, connections and recent posts. 링크드인 공개 프로필 주소로 이름·직함·소개·경력·학력·팔로워·연결 수·최근 활동을 조회합니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| url* | string | 링크드인 프로필 주소 (예: https://www.linkedin.com/in/{아이디}) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "링크드인 프로필 주소 (예: https://www.linkedin.com/in/{아이디})"
}
}
}Send a chat request to a selected LLM model and receive the assistant reply. 선택한 LLM 모델에 대화를 보내고 assistant 응답을 받습니다. 서버는 대화 히스토리를 보관하지 않는 stateless 방식 — 매 호출마다 전체 히스토리를 messages 로 전송하고, 응답의 compacted_messages 를 다음 턴의 messages 로 그대로 재사용합니다. 사용 가능한 모델은 llm_models Tool로 조회합니다. 한 요청 안에서 쓰인 토큰 사용량(긴 대화의 이전 내용을 정리하는 처리 포함)에 비례해 포인트가 차감됩니다. [모델별 토큰 단가 × 사용량(요청당 기본 5P)]
| Argument | Type | Description |
|---|---|---|
| model* | string | 모델 id (llm_models Tool로 조회 가능, 예: openai/gpt-oss-120b) |
| speed | string | 응답 속도/추론 깊이 — 'fast'(얕게, 빠름) | 'medium' | 'slow'(깊게, 느림). 한글 '빠름'|'중간'|'느림' 허용. 추론 특화 모델에서 효과가 큽니다 |
| system | string | system 프롬프트 (역할·페르소나·정책·배경지식). 미지정 시 기본 한국어 어시스턴트 프롬프트가 적용됩니다 |
| compact | object | 히스토리 압축 옵션 { strategy: 'none'(기본) | 'sliding_window' | 'relevance', window_pairs: 유지할 user/assistant 페어 수 (기본 10, 최소 1) }. relevance 는 최근 대화와 함께 최신 질문에 필요한 이전 대화를 골라 남긴다. 긴 대화의 input 토큰 누적 방지 |
| content | string | 단발 입력 — 사용자 메시지 한 건만 보내는 간편 형태. messages 와 둘 중 하나는 필수 |
| messages | array | OpenAI 형식 [{role, content}] 배열. role 은 'system'|'user'|'assistant'. content 와 둘 중 하나는 필수, 동시 지정 시 messages 우선. 멀티턴 대화는 응답의 compacted_messages 를 다음 턴에 그대로 전송 |
| max_tokens |
List available text-generation LLM models with per-token pricing and max context. 텍스트 생성 모델 카탈로그를 반환합니다. 각 모델의 1M 토큰당 input/output 단가(포인트), 계열·크기·멀티모달 여부·태그·추천 용도(use_cases)·max_context 를 한 응답에 포함합니다. llm_chat Tool의 model 입력값을 찾을 때 사용합니다. 무료입니다. [무료]
| Argument | Type | Description |
|---|---|---|
| tag | string | 특수 태그 필터 — 'reasoning'(추론 특화) | 'coder'(코딩 특화) |
| family | string | 모델 계열 필터 (deepseek, qwen, glm, google, nvidia, llama, mistral, gpt-oss, moonshot, seed, mimo, phi) |
| use_case | string | 추천 용도 필터 — 'general' | 'reasoning' | 'coding' | 'multimodal' | 'economy' |
| multimodal | boolean | 멀티모달(이미지 이해) 지원 여부 필터 (true/false) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"tag": {
"type": "string",
"description": "특수 태그 필터 — 'reasoning'(추론 특화) | 'coder'(코딩 특화)"
},
"family": {
"type": "string",
"description": "모델 계열 필터 (deepseek, qwen, glm, google, nvidia, llama, mistral, gpt-oss, moonshot, seed, mimo, phi)"
},
"use_case": {
"type": "string",
"description": "추천 용도 필터 — 'general' | 'reasoning' | 'coding' | 'multimodal' | 'economy'"
},
"multimodal": {
"type": "boolean",
"description": "멀티모달(이미지 이해) 지원 여부 필터 (true/false)"
}
}
}Look up the geographic location of a domain or IP address. 도메인 또는 IP의 위치(지리 정보)를 조회합니다. 도메인을 입력하면 해당 도메인의 IP를 찾아 위치를 반환합니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| address* | string | 검색할 도메인 또는 IP (예: apick.app) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "검색할 도메인 또는 IP (예: apick.app)"
}
}
}Verify that a Korean name and resident registration number (RRN) match a real registered person. 성명과 주민등록번호의 일치 여부(실명 존재 여부)를 확인합니다. name, rrn1(앞 6자리), rrn2(뒤 7자리)를 모두 입력해야 합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 50포인트]
| Argument | Type | Description |
|---|---|---|
| name* | string | 한글 성명 |
| rrn1* | string | 주민등록번호 앞 6자리 숫자 |
| rrn2* | string | 주민등록번호 뒤 7자리 숫자 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"rrn1",
"rrn2"
],
"properties": {
"name": {
"type": "string",
"description": "한글 성명"
},
"rrn1": {
"type": "string",
"description": "주민등록번호 앞 6자리 숫자"
},
"rrn2": {
"type": "string",
"description": "주민등록번호 뒤 7자리 숫자"
}
}
}Naver brand store product by URL: title, prices, discount, reviews, sellers, product information, tags and images. 네이버 브랜드스토어 상품 주소로 상품명·정가·판매가·할인율·리뷰 수·판매자·상품정보·태그·이미지를 조회합니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| url* | string | 네이버 브랜드스토어 상품 주소 (예: https://brand.naver.com/{스토어}/products/{번호}) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "네이버 브랜드스토어 상품 주소 (예: https://brand.naver.com/{스토어}/products/{번호})"
}
}
}Detect whether an image contains NSFW (violent or sexually explicit) content and return an nsfw_score. 이미지가 NSFW(폭력적·선정적) 콘텐츠인지 탐지해 nsfw_score 를 반환합니다. detail=1 입력 시 세부 판정 결과를 함께 반환합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| detail | string | 세부 판정 결과 포함 여부 (포함: 1, 미포함: 0, 기본값 0) |
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, image/webp, image/bmp) (최대 50MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"image_url"
],
"properties": {
"detail": {
"type": "string",
"description": "세부 판정 결과 포함 여부 (포함: 1, 미포함: 0, 기본값 0)"
},
"image_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: image/jpeg, image/png, image/webp, image/bmp) (최대 50MB)"
}
}
}Resolve a domain name to its currently registered IP addresses (DNS lookup). 도메인에 현재 등록된 IP 주소 목록을 조회합니다. 도메인 형식이 아닌 값은 오류로 응답합니다. [호출당 1포인트]
| Argument | Type | Description |
|---|---|---|
| domain* | string | 검색할 도메인 (예: apick.app) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "검색할 도메인 (예: apick.app)"
}
}
}Extract text from an image file (OCR). 이미지 파일에서 텍스트를 추출해 전체 텍스트(full_text)를 반환합니다. 문서 사진, 스캔 이미지, 캡처 화면 등 범용 이미지에 사용합니다. [호출당 12포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg) (최대 50MB) |
{
"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) (최대 50MB)"
}
}
}Extract key fields from a Korean resident registration card (jumin card) image via OCR. 주민등록증 사진에서 이름, 주민등록번호, 주소, 발급일자 등 주요 정보를 추출해 구조화된 결과와 원문 텍스트(raw_text)를 반환합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 12포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg) (최대 50MB) |
{
"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) (최대 50MB)"
}
}
}Extract key fields from a Korean driver license image via OCR. 운전면허증 사진에서 이름, 면허번호, 생년월일 등 주요 정보를 추출해 구조화된 결과와 원문 텍스트(raw_text)를 반환합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 12포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg) (최대 50MB) |
{
"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) (최대 50MB)"
}
}
}Extract key fields from a passport image via OCR. 여권 사진에서 이름, 여권번호, 발급일자, 만료일자, 생년월일 등 주요 정보를 추출해 구조화된 결과와 원문 텍스트(raw_text)를 반환합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 12포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg) (최대 50MB) |
{
"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) (최대 50MB)"
}
}
}Extract key fields from a Korean certified copy of resident registration (deungbon) image via OCR. 주민등록등본 사진에서 주요 정보를 추출해 구조화된 결과와 원문 텍스트(raw_text)를 반환합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 12포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg) (최대 50MB) |
{
"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) (최대 50MB)"
}
}
}Extract key fields from a Korean alien registration card (residence card) image via OCR. 외국인등록증 사진에서 이름, 외국인등록번호, 발급일자 등 주요 정보를 추출해 구조화된 결과와 원문 텍스트(raw_text)를 반환합니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오. [호출당 12포인트]
| Argument | Type | Description |
|---|---|---|
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg) (최대 50MB) |
{
"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) (최대 50MB)"
}
}
}Track a Korean parcel in real time by carrier code and tracking number. 택배사 코드와 운송장번호를 지정해 실시간 배송현황을 조회합니다. carrier 코드 예: cj(CJ대한통운), hanjin(한진택배), lotte(롯데택배), logen(로젠택배), epost-domestic(우체국택배) 등 — 전체 목록은 /rest/parcel_tracking_carriers(무료)에서 확인할 수 있고, 택배사를 모르면 parcel_tracking_auto Tool로 자동판별 조회하세요. [호출당 5포인트]
| Argument | Type | Description |
|---|---|---|
| carrier* | string | 택배사 코드 (예: cj, hanjin, lotte, logen, epost-domestic) |
| trackingNumber* | string | 운송장번호 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"carrier",
"trackingNumber"
],
"properties": {
"carrier": {
"type": "string",
"description": "택배사 코드 (예: cj, hanjin, lotte, logen, epost-domestic)"
},
"trackingNumber": {
"type": "string",
"description": "운송장번호"
}
}
}Track a Korean parcel in real time with automatic carrier detection from the tracking number alone. 택배사 지정 없이 운송장번호만으로 택배사를 자동 판별해 실시간 배송현황을 조회합니다. 택배사를 이미 아는 경우에는 parcel_tracking Tool이 더 정확합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| trackingNumber* | string | 운송장번호 (택배사 지정 없이 형식만으로 자동 판별) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"trackingNumber"
],
"properties": {
"trackingNumber": {
"type": "string",
"description": "운송장번호 (택배사 지정 없이 형식만으로 자동 판별)"
}
}
}Merge two PDF files into one. 두 개의 PDF 파일을 순서대로 하나의 PDF 파일로 합쳐 반환합니다. PDF 형식의 파일만 허용됩니다. [호출당 2포인트]
| Argument | Type | Description |
|---|---|---|
| pdf_url_1* | string | 다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB) |
| pdf_url_2* | string | 다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB) |
{
"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)"
}
}
}Convert a PDF file to a DOCX (Word) file. PDF 파일을 DOCX 파일로 변환해 반환합니다. PDF 형식의 파일만 허용됩니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| pdf_url* | string | 다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB) |
{
"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)"
}
}
}Convert each page of a PDF file to PNG images, returned as a ZIP archive. PDF 파일의 각 페이지를 PNG 이미지로 변환하고 ZIP 파일로 묶어 반환합니다. PDF 형식의 파일만 허용됩니다. [호출당 2포인트]
| Argument | Type | Description |
|---|---|---|
| pdf_url* | string | 다운로드 가능한 https URL (허용 형식: application/pdf) (최대 25MB) |
{
"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)"
}
}
}View and issue a corporate registry certificate in one call. 법인등록번호로 열람·발급을 끝내고 PDF 를 돌려줍니다(보통 10초 이내). 건당 850P(PDF 전송 포함). 결제 전에 실패하면 차감하지 않습니다. PDF 확보가 늦으면 job_id와 함께 preparing 응답이 오며, 같은 idempotency_key로 다시 호출하면 PDF를 받습니다. [호출당 850포인트]
| Argument | Type | Description |
|---|---|---|
| index | integer | 검색 결과 행 번호(1부터), 기본 1 |
| usage | string | 열람(view)·발급(issue), 기본 view |
| biz_no | string | 사업자등록번호 10자리(corp_reg_no가 없을 때) |
| corp_reg_no | string | 법인등록번호 13자리 |
| idempotency_key | string | 중복 결제 방지 키. 같은 키로 다시 호출하면 기존 작업의 PDF를 받습니다 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"index": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "검색 결과 행 번호(1부터), 기본 1"
},
"usage": {
"enum": [
"view",
"issue"
],
"type": "string",
"description": "열람(view)·발급(issue), 기본 view"
},
"biz_no": {
"type": "string",
"pattern": "^[0-9]{10}$",
"description": "사업자등록번호 10자리(corp_reg_no가 없을 때)"
},
"corp_reg_no": {
"type": "string",
"pattern": "^[0-9]{13}$",
"description": "법인등록번호 13자리"
},
"idempotency_key": {
"type": "string",
"maxLength": 128,
"minLength": 8,
"description": "중복 결제 방지 키. 같은 키로 다시 호출하면 기존 작업의 PDF를 받습니다"
}
}
}Find corporate registry targets in Korea by 13-digit corporate registration number or 10-digit business number. 법인등록번호 또는 사업자등록번호로 법인 등기 대상을 찾습니다. 개인사업자·미등록이면 결과가 없고 0P입니다. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| biz_no | string | 사업자등록번호 10자리(하이픈 제외). corp_reg_no가 없을 때 사용 |
| corp_reg_no | string | 법인등록번호 13자리(하이픈 제외) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"biz_no": {
"type": "string",
"pattern": "^[0-9]{10}$",
"description": "사업자등록번호 10자리(하이픈 제외). corp_reg_no가 없을 때 사용"
},
"corp_reg_no": {
"type": "string",
"pattern": "^[0-9]{13}$",
"description": "법인등록번호 13자리(하이픈 제외)"
}
}
}Verify an issued Korean registration certificate by the verification number printed on it. 증명서에 인쇄된 발급확인번호(12자리)로 발급 사실과 증명서 종류·발급일·등기소를 확인합니다. kind: realestate 부동산(기본), corporate 법인, movable 동산·채권담보. 증명서 원문은 돌려주지 않습니다. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| kind | string | 문서 종류 (기본 realestate) |
| issue_no* | string | 발급확인번호 12자리. 하이픈·공백 표기도 받습니다 (예: 2024-1234-5678) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"issue_no"
],
"properties": {
"kind": {
"enum": [
"realestate",
"corporate",
"movable"
],
"type": "string",
"description": "문서 종류 (기본 realestate)"
},
"issue_no": {
"type": "string",
"description": "발급확인번호 12자리. 하이픈·공백 표기도 받습니다 (예: 2024-1234-5678)"
}
}
}View and issue a real estate registry certificate in one call. 검색 결과의 대상을 지정하면 결제와 PDF 확보를 같은 호출에서 끝내고 PDF 를 돌려줍니다(보통 10초 이내). 건당 850P(PDF 전송 포함). 실패하면 포인트는 차감되지 않습니다. PDF 확보가 늦으면 pdf가 preparing인 JSON과 job_id가 오며, 같은 idempotency_key로 다시 호출하면 추가 과금 없이 PDF를 받습니다. [호출당 850포인트]
| Argument | Type | Description |
|---|---|---|
| pin | string | 부동산고유번호 14자리(선택) |
| index | integer | 검색 결과 행 번호(1부터), 기본 1 |
| query | string | 검색에 사용한 주소 또는 부동산고유번호 |
| usage | string | 열람(view)·발급(issue) 등, 기본 view |
| record_scope | string | 전부(all)·일부(part), 기본 all |
| idempotency_key | string | 중복 결제 방지 키. 같은 키로 다시 호출하면 기존 작업의 PDF를 받습니다 |
| include_cancelled | boolean | 말소사항 포함 여부, 기본 true |
| publish_resident_no | boolean | 주민등록번호 공개 여부, 기본 false |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"pin": {
"type": "string",
"pattern": "^[0-9]{14}$",
"description": "부동산고유번호 14자리(선택)"
},
"index": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "검색 결과 행 번호(1부터), 기본 1"
},
"query": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "검색에 사용한 주소 또는 부동산고유번호"
},
"usage": {
"enum": [
"view",
"issue",
"transfer-gov24",
"transfer-court"
],
"type": "string",
"description": "열람(view)·발급(issue) 등, 기본 view"
},
"record_scope": {
"enum": [
"all",
"part"
],
"type": "string",
"description": "전부(all)·일부(part), 기본 all"
},
"idempotency_key": {
"type": "string",
"maxLength": 128,
"minLength": 8,
"description": "중복 결제 방지 키. 같은 키로 다시 호출하면 기존 작업의 PDF를 받습니다"
},
"include_cancelled": {
"type": "boolean",
"description": "말소사항 포함 여부, 기본 true"
},
"publish_resident_no": {
"type": "boolean",
"description": "주민등록번호 공개 여부, 기본 false"
}
}
}Find real estate registry targets in Korea by road/lot address or 14-digit property number. 주소 또는 부동산고유번호로 등기부등본 열람·발급 대상을 찾습니다. 결과 targets의 index를 registry_realestate_jobs_create에 전달하세요. 결과가 없으면 0P입니다. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| query* | string | 주소(도로명·지번) 또는 부동산고유번호 14자리 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "주소(도로명·지번) 또는 부동산고유번호 14자리"
}
}
}사업자 증빙서류 통합발급을 위한 본인 간편인증을 요청합니다. 승인 한 번으로 담긴 증명 3종을 차례로 발급합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_business_cert_bundle에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [인증 발송 성공 시 20P]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| year* | string | 귀속연도 4자리 (최근 5년, 예: 2025) |
| string | 수령 이메일 (선택, 생략 시 회원정보) | |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| agreed | boolean | 대표자 본인 확인 동의. bind_id 가 없으면 true 여야 접수되며, 빠지면 인증을 보내지 않고 무과금으로 거절 |
| fax_no | string | 팩스번호 (delivery=04 일 때 필수) |
| format | string | 응답 형식 (pdf=PDF base64만·json=PDF를 읽은 값만·both=둘 다, 생략 시 both). 대화형 사용은 응답이 작은 json 을 권장 |
| period | string | 부가가치세 과세표준증명 과세기간 (1=1기·2=2기·all=연간) |
| bind_id | string | 이전 사업자 조회 결과의 bind_id (같은 계정·같은 사업자등록번호, 90일 이내면 agreed 없이 접수) |
현금영수증 소득공제 내역을 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_cash_receipt_deduction에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [인증 발송 성공 시 20P; 조회 범위와 무관]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| incomeYears | integer | 소득공제 조회 연수 (1~3, 생략 시 1) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"incomeYears": {
"type": "integer",
"maximum": 3,
"minimum": 1,
"description": "소득공제 조회 연수 (1~3, 생략 시 1)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
}
}
}운전면허 조회를 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_driving_license에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
}
}
}재직·보험료 확인을 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_employment에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
| insuranceYears | integer | 보험료 조회 연수 (1~3, 생략 시 1) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
},
"insuranceYears": {
"type": "integer",
"maximum": 3,
"minimum": 1,
"description": "보험료 조회 연수 (1~3, 생략 시 1)"
}
}
}국가 건강검진 결과 조회를 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_health_checkup에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
}
}
}소득 증빙서류 통합발급을 위한 본인 간편인증을 요청합니다. 승인 한 번으로 담긴 증명 2종을 차례로 발급합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_income_cert_bundle에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [인증 발송 성공 시 20P]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| year* | string | 귀속연도 4자리 (최근 5년, 예: 2025) |
| string | 수령 이메일 (선택, 생략 시 회원정보) | |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| fax_no | string | 팩스번호 (delivery=04 일 때 필수) |
| format | string | 응답 형식 (pdf=PDF base64만·json=PDF를 읽은 값만·both=둘 다, 생략 시 both). 대화형 사용은 응답이 작은 json 을 권장 |
| delivery* | string | 교부방법 (06 프린터·10 화면·04 팩스·12 전자문서지갑). 문서는 응답으로 받으므로 보통 06 |
| quantity | integer | 발급 희망 수량 (1~5, 생략 시 1) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
국민연금 경력 이력 조회를 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_nps_career_history에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| to | string | 조회 종료 월 (YYYY-MM, 선택) |
| from | string | 조회 시작 월 (YYYY-MM, 선택) |
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"to": {
"type": "string",
"pattern": "^[0-9]{4}-(0[1-9]|1[0-2])$",
"description": "조회 종료 월 (YYYY-MM, 선택)"
},
"from": {
"type": "string",
"pattern": "^[0-9]{4}-(0[1-9]|1[0-2])$",
"description": "조회 시작 월 (YYYY-MM, 선택)"
},
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
}
}
}국민연금 소득공제용 납부확인서를 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_nps_deduction_cert에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [인증 발송 성공 시 20P; 조회 범위와 무관]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| years | integer | 납부확인서 조회 연수 (1~5, 생략 시 1) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"years": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "납부확인서 조회 연수 (1~5, 생략 시 1)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
}
}
}국민연금 가입내역 조회를 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_nps_join_history에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| to | string | 조회 종료 월 (YYYY-MM, 선택) |
| from | string | 조회 시작 월 (YYYY-MM, 선택) |
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"to": {
"type": "string",
"pattern": "^[0-9]{4}-(0[1-9]|1[0-2])$",
"description": "조회 종료 월 (YYYY-MM, 선택)"
},
"from": {
"type": "string",
"pattern": "^[0-9]{4}-(0[1-9]|1[0-2])$",
"description": "조회 시작 월 (YYYY-MM, 선택)"
},
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
}
}
}Request simple authentication (KakaoTalk, Toss, PASS, etc.) to retrieve a Korean Personal Customs Clearance Code (PCCC). 이름, 생년월일, 휴대전화번호와 간편인증 방식을 입력하면 해당 휴대폰으로 인증 요청이 발송되고, 응답을 기다리지 않고 tx_id 를 즉시 반환합니다. 인증 요청이 실제 발송된 접수 시점에 과금되며, 이미 대기 중인 요청을 다시 보내면 재발송 없이 기존 tx_id 를 반환하고 과금되지 않습니다. 사용자가 휴대폰에서 승인한 뒤 get_pccc 에 tx_id 를 넣어 결과를 확인하세요. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| name* | string | 이름 |
| phone* | string | 휴대전화 번호 (본인 명의, 숫자만) |
| birthday* | string | 생년월일 8자리 (YYYYMMDD) |
| provider* | string | 간편인증 방식 (kakao, naver, toss, pass, samsung, kb, shinhan, hana, woori, ibk, nh, kakaobank, banksalad) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthday",
"phone",
"provider"
],
"properties": {
"name": {
"type": "string",
"description": "이름"
},
"phone": {
"type": "string",
"description": "휴대전화 번호 (본인 명의, 숫자만)"
},
"birthday": {
"type": "string",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"provider": {
"type": "string",
"description": "간편인증 방식 (kakao, naver, toss, pass, samsung, kb, shinhan, hana, woori, ibk, nh, kakaobank, banksalad)"
}
}
}금융소득(이자·배당) 조회를 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_personal_income에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| incomeYears | integer | 소득 조회 연수 (1~5, 생략 시 1) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"incomeYears": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "소득 조회 연수 (1~5, 생략 시 1)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
}
}
}국세 신고내역 조회를 위한 본인 간편인증을 요청합니다. 휴대폰 알림 발송과 접수 과금이 발생하므로 사용자 확인 후 호출하세요. transactionId와 status를 반환하면 휴대폰 승인을 안내하고, 승인 후 get_tax_return_history에 transactionId를 전달하세요. 승인 대기 중 인증 요청을 반복하거나 자동 승인하지 마세요. [인증 발송 성공 시 20P; 조회 범위와 무관]
| Argument | Type | Description |
|---|---|---|
| name* | string | 본인 이름 |
| phone* | string | 본인 명의 휴대전화 번호 (숫자만) |
| years | integer | 신고내역 조회 연수 (1~10, 생략 시 1) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"years": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "신고내역 조회 연수 (1~10, 생략 시 1)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
}
}
}Reverse IP lookup: list domains that have been hosted on a given IP address. 특정 IP에 등록된 도메인 이력 정보를 조회합니다. IP 주소 형식만 허용됩니다. [호출당 100포인트]
| Argument | Type | Description |
|---|---|---|
| ip* | string | 검색할 IP 주소 (예: 168.126.63.1) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ip"
],
"properties": {
"ip": {
"type": "string",
"description": "검색할 IP 주소 (예: 168.126.63.1)"
}
}
}Analyze Korean rent transactions into jeonse share, deposit and monthly-rent bands, annual-rent-to-deposit ratio, renewal share, and jeonse ratio against same-complex sale prices. 지역·월별 전월세 실거래를 집계해 전세 비중, 보증금·월세 분포, 보증금 대비 연월세 비율, 갱신 계약 비중을 분석하고 같은 단지 매매가로 전세가율을 계산합니다. 응답은 summary·distribution·complexes·jeonse_ratio·insights 입니다. [호출당 50포인트]
| Argument | Type | Description |
|---|---|---|
| lawdCd* | string | 지역코드 (법정동코드 앞 5자리, 예: 11110) |
| pageNo | integer | 페이지 번호 (기본 1) |
| dealYmd* | string | 계약년월 (YYYYMM, 예: 202601) |
| numOfRows | integer | 페이지당 결과 수 (기본 10, 최대 1000) |
| includeTrade | boolean | 같은 단지 매매가와 비교한 전세가율(jeonse_ratio) 포함 여부 (기본 true) |
| propertyType | string | 부동산 유형 (기본 apt) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"lawdCd",
"dealYmd"
],
"properties": {
"lawdCd": {
"type": "string",
"pattern": "^[0-9]{5}$",
"description": "지역코드 (법정동코드 앞 5자리, 예: 11110)"
},
"pageNo": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "페이지 번호 (기본 1)"
},
"dealYmd": {
"type": "string",
"pattern": "^[0-9]{6}$",
"description": "계약년월 (YYYYMM, 예: 202601)"
},
"numOfRows": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "페이지당 결과 수 (기본 10, 최대 1000)"
},
"includeTrade": {
"type": "boolean",
"description": "같은 단지 매매가와 비교한 전세가율(jeonse_ratio) 포함 여부 (기본 true)"
},
"propertyType": {
"enum": [
"apt",
"rh",
"sh",
"offi"
],
"type": "string",
"description": "부동산 유형 (기본 apt)"
}
}
}Analyze Korean apartment sale transactions into per-complex and per-area price statistics, direct-deal and cancellation shares, and price outliers. 지역·월별 매매 실거래를 단지·면적대·가격대·층별로 집계해 ㎡당 중위가, 거래량, 직거래·해제 비중, 시세 이탈 거래를 분석합니다. 응답은 summary·distribution·complexes·anomalies·insights 이며 거래 원문 목록은 제공하지 않습니다. [호출당 50포인트]
| Argument | Type | Description |
|---|---|---|
| lawdCd* | string | 지역코드 (법정동코드 앞 5자리, 예: 11110) |
| pageNo | integer | 페이지 번호 (기본 1) |
| dealYmd* | string | 계약년월 (YYYYMM, 예: 202601) |
| numOfRows | integer | 페이지당 결과 수 (기본 10, 최대 1000) |
| propertyType | string | 부동산 유형 (기본 apt) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"lawdCd",
"dealYmd"
],
"properties": {
"lawdCd": {
"type": "string",
"pattern": "^[0-9]{5}$",
"description": "지역코드 (법정동코드 앞 5자리, 예: 11110)"
},
"pageNo": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "페이지 번호 (기본 1)"
},
"dealYmd": {
"type": "string",
"pattern": "^[0-9]{6}$",
"description": "계약년월 (YYYYMM, 예: 202601)"
},
"numOfRows": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "페이지당 결과 수 (기본 10, 최대 1000)"
},
"propertyType": {
"enum": [
"apt",
"rh",
"sh",
"offi"
],
"type": "string",
"description": "부동산 유형 (기본 apt)"
}
}
}Search Korean road-name addresses by keyword. 지번 또는 도로명 키워드로 도로명 주소를 검색합니다. 페이지당 10건씩 반환되며 total_count 필드로 전체 검색결과 개수를 확인할 수 있습니다. [호출당 2포인트]
| Argument | Type | Description |
|---|---|---|
| juso* | string | 검색할 주소 키워드 (지번, 도로명. 예: 디지털로) |
| page | string | 검색 결과 조회 페이지 (기본값 1, 페이지당 10건) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"juso"
],
"properties": {
"juso": {
"type": "string",
"description": "검색할 주소 키워드 (지번, 도로명. 예: 디지털로)"
},
"page": {
"type": "string",
"description": "검색 결과 조회 페이지 (기본값 1, 페이지당 10건)"
}
}
}Submit an asynchronous Seedance video generation job. Select version and tier; supported modes, durations and prices depend on the selected version. Seedance 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, seedance_jobs_status Tool로 상태를 조회하고 완료되면 응답의 result_url(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 duration × 초당 포인트(해상도별로 다름, resolution 참고)가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다. [기본 버전 기준: 초당 480p 560P·720p 1,250P·1080p 2,810P × duration(초). 다른 버전은 개발가이드의 버전별 요금표 참고.]
| Argument | Type | Description |
|---|---|---|
| mode | string | 입력 방식 — 'text'(텍스트만) | 'image'(첫 프레임 이미지 지정) | 'reference'(참조 이미지·영상으로 주체 지정). 기본 text |
| seed | integer | 재현성을 위한 시드 값 |
| tier | string | 품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다. |
| audio | boolean | 오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다. |
| prompt* | string | 영상 생성 프롬프트, 최대 2,000자 |
| version | string | 영상 모델 버전. 생략 시 2.5. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요. |
| duration | integer | 영상 길이(초), 전체 버전 범위 2~30. 허용 값과 기본값은 버전·등급별로 다릅니다. |
| image_url | string | image 모드에서 사용할 첫 프레임 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
Check the status of a Seedance video generation job submitted via seedance_jobs_create. Seedance 영상 작업의 진행 상태를 조회합니다. 완료되면 응답의 result_url(REST 다운로드 주소)로 안내하며, 결과는 완료 후 7일간 유효합니다. 무료입니다. [무료]
| Argument | Type | Description |
|---|---|---|
| job_id* | string | 작업 ID |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "작업 ID"
}
}
}Embed an invisible watermark code into an image. 원본 이미지에 보이지 않는 워터마크 코드를 삽입한 PNG 이미지를 반환합니다. 이미지가 일부 변형되어도 높은 확률로 워터마크를 확인할 수 있습니다. PNG, JPEG 등 일반 이미지 포맷을 지원합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| code* | integer | 삽입할 워터마크 코드 (1 ~ 21,767,823,359 사이의 숫자) |
| image_url* | string | 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp, image/bmp) (최대 50MB) |
{
"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)"
}
}
}Convert a speech audio file to text (STT). 음성 파일을 텍스트로 변환합니다. MP3, WAV, WMV 파일을 지원하며, 변환된 텍스트를 JSON으로 반환합니다. [호출당 50포인트]
| 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 재구성. 생략 시 기존과 동일 |
{
"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 재구성. 생략 시 기존과 동일"
}
}
}Polish a text (up to 100,000 characters) by fixing grammar, spelling, and awkward phrasing. 입력 텍스트(최대 10만 자)의 문법 오류, 맞춤법·오타, 어색한 표현, 문장 순서를 의미를 유지한 채 자연스럽게 다듬습니다. 모델·파라미터는 서버가 고정하며 빠른 응답에 최적화되어 있습니다. 요청당 기본 100포인트이며, 사용량 금액(모델별 단가 기준)이 더 크면 그 금액이 차감됩니다. [호출당 100포인트]
| Argument | Type | Description |
|---|---|---|
| text* | string | 다듬을 원문 텍스트 (최대 100,000자) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "다듬을 원문 텍스트 (최대 100,000자)"
}
}
}Summarize a long text (up to 100,000 characters) into a concise Korean summary. 입력 텍스트(최대 10만 자)의 핵심 내용을 간결하고 정확하게 요약합니다. 모델·파라미터는 서버가 고정하며 빠른 응답에 최적화되어 있습니다. 요청당 기본 100포인트이며, 사용량 금액(모델별 단가 기준)이 더 크면 그 금액이 차감됩니다. [호출당 100포인트]
| Argument | Type | Description |
|---|---|---|
| text* | string | 요약할 원문 텍스트 (최대 100,000자) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "요약할 원문 텍스트 (최대 100,000자)"
}
}
}TikTok public profile: followers, likes, videos count, bio and recent popular videos with view and engagement counts. 틱톡 공개 계정의 팔로워·좋아요·영상 수·소개와 최근 인기 영상의 조회수·반응 지표를 조회합니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| url | string | 틱톡 프로필 주소 (예: https://www.tiktok.com/@tiktok) |
| username | string | 틱톡 사용자명 (@ 없이도 가능, username 또는 url 중 하나 필수) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"url": {
"type": "string",
"description": "틱톡 프로필 주소 (예: https://www.tiktok.com/@tiktok)"
},
"username": {
"type": "string",
"description": "틱톡 사용자명 (@ 없이도 가능, username 또는 url 중 하나 필수)"
}
}
}Send a 1 KRW verification deposit to a Korean bank account and return the 4-character verification code printed on the transaction. 대한민국 은행 계좌로 1원을 입금해 적요에 표시되는 인증코드를 반환합니다. 계좌 실소유 확인(1원 인증) 절차에 사용합니다. bank_code 또는 bank_name 중 하나는 입력해야 합니다. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| bank_code | string | 은행 코드 (bank_code Tool로 조회 가능, 예: 004) |
| bank_name | string | 은행명 (예: 국민). bank_code 대신 입력 가능 |
| account_num* | string | 계좌번호 (숫자만, 하이픈 제외) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"account_num"
],
"properties": {
"bank_code": {
"type": "string",
"description": "은행 코드 (bank_code Tool로 조회 가능, 예: 004)"
},
"bank_name": {
"type": "string",
"description": "은행명 (예: 국민). bank_code 대신 입력 가능"
},
"account_num": {
"type": "string",
"description": "계좌번호 (숫자만, 하이픈 제외)"
}
}
}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 |
공개 기본·확장 목소리, 성별·공식 음색, 검증 시각을 조회합니다. 연령은 별도 검수된 경우에만 표시합니다. [무료]
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}waiting 또는 processing TTS 작업에 취소를 요청합니다. 이미 수행한 유료 처리분은 정산하고 미사용 예약금은 해제합니다. 연결 종료만으로는 취소되지 않습니다. [추가 과금 없음]
| Argument | Type | Description |
|---|---|---|
| job_id* | string | 취소할 32자리 ID |
{
"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를 접수합니다. 기본 정규화 스킬이 발음을 다듬으며 추가 요금이 합산됩니다. 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 |
Download the completed MP3 result once as base64. 완료된 TTS MP3 결과를 base64로 한 번 내려받습니다. 호출이 시작되면 서버 원본이 소모되므로 재실행할 수 없습니다. [추가 과금 없음]
| Argument | Type | Description |
|---|---|---|
| job_id* | string | completed 상태인 32자리 ID |
{
"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"
}
}
}Get the public status and result availability of a TTS job. TTS 작업의 waiting, processing, completed, cancelled, failed 상태와 MP3·ASS 자막 준비 여부를 조회합니다. [무료]
| Argument | Type | Description |
|---|---|---|
| job_id* | string | 작업 접수에서 받은 32자리 ID |
{
"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"
}
}
}Download the completed ASS subtitles once as base64. 완료된 TTS의 발화 타이밍 ASS 자막을 base64로 한 번 내려받습니다. 호출이 시작되면 자막 원본이 소모되므로 재실행할 수 없습니다. [추가 과금 없음]
| Argument | Type | Description |
|---|---|---|
| job_id* | string | completed 상태인 32자리 ID |
{
"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"
}
}
}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 |
ChatGPT TTS에서 사용할 수 있는 목소리와 음색 특성을 조회합니다. [무료]
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Gemini·ChatGPT의 표현 옵션과 화자 수 제한을 조회합니다. 수치 입력이 정밀한 음향 조절을 보장하지는 않습니다. [무료]
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}합성·정규화 예상 요금과 최대 예약금을 조회합니다. 실제 정산액은 완료된 작업의 billing을 확인하세요. [무료]
| 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 |
Fetch a web page and return its rendered HTML source. 입력한 URL의 페이지를 열어 HTML을 추출해 반환합니다. [호출당 5포인트]
| Argument | Type | Description |
|---|---|---|
| url* | string | 페이지 URL (예: https://apick.app) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "페이지 URL (예: https://apick.app)"
}
}
}Capture a screenshot of a web page and return it as a JPEG image. 입력한 URL의 화면을 캡처해 JPEG 이미지로 반환합니다. [호출당 5포인트]
| Argument | Type | Description |
|---|---|---|
| url* | string | 페이지 URL (예: https://www.naver.com/) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "페이지 URL (예: https://www.naver.com/)"
}
}
}Compare two web pages and judge how similar they are. 입력한 두 사이트 페이지의 유사 여부를 분석해 유사도 결과를 반환합니다. 피싱·복제 사이트 판별 등에 활용할 수 있습니다. [호출당 5포인트]
| Argument | Type | Description |
|---|---|---|
| url1* | string | 비교할 첫 번째 페이지 URL |
| url2* | string | 비교할 두 번째 페이지 URL |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url1",
"url2"
],
"properties": {
"url1": {
"type": "string",
"description": "비교할 첫 번째 페이지 URL"
},
"url2": {
"type": "string",
"description": "비교할 두 번째 페이지 URL"
}
}
}Look up Korean vehicle emission certification details by emission certification number. 배출가스인증번호로 인증일·차명·제조사·제작국가·연료·배출가스차종·배기량·엔진출력·변속기·공차중량·총중량과 인증 이력을 조회합니다. 입력은 차량번호가 아니라 배출가스인증번호이며, 배출가스 등급은 제공하지 않습니다. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| cert_no* | string | 배출가스인증번호. 예: KMY-SY-13-24 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"cert_no"
],
"properties": {
"cert_no": {
"type": "string",
"description": "배출가스인증번호. 예: KMY-SY-13-24"
}
}
}Look up specifications of a Korean-market vehicle model (passenger cars and motorcycles/scooters) by brand, model name, model year and trim. 브랜드·차명·연식·등급으로 해당 차종(승용차와 오토바이·스쿠터 같은 이륜차)의 제원(배기량·연비·치수·타이어·소모품 규격 등), 사양, 등급 후보를 조회합니다. 차명 없이 부르면 브랜드·차종 목록을 돌려줍니다. 차명·등급 표기가 달라도 가장 비슷한 차종을 찾아 주며, 확신이 높으면 그 차종의 제원과 함께 추천(추천.자동선택, 추천.대안)을 알려주고 확신이 낮으면 제원 없이 후보만 알려줍니다. 제원 값은 표준 표기로만 내려갑니다(연료: 가솔린·디젤·LPG·전기·수소·하이브리드, 차체형상: 세단·SUV·MPV·스쿠터·네이키드 등, 구동방식: 전륜·후륜·2WD·AWD, 변속기: 자동 8단·DCT 7단·CVT, 에너지효율등급: 1~5등급, 여러 값은 "+"로 연결). [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| trim | string | 등급·트림. 예: 프레스티지 |
| maker | string | 브랜드. 예: 현대, 기아, BMW, 렉서스 |
| model | string | 차명 또는 자유문 검색어. 예: 파나메라 gts 4인승 19년식, PANAMERA GTS 19년, 더 뉴 K5. 차명·연식·등급·승차인원을 비교하며 적합한 제원이 없으면 미과금. 비우면 차종 목록 |
| modelYear | string | 연식. 예: 2024, 24년식. model에 포함 가능하며 별도 값과 다르면 입력 오류 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"trim": {
"type": "string",
"description": "등급·트림. 예: 프레스티지"
},
"maker": {
"type": "string",
"description": "브랜드. 예: 현대, 기아, BMW, 렉서스"
},
"model": {
"type": "string",
"description": "차명 또는 자유문 검색어. 예: 파나메라 gts 4인승 19년식, PANAMERA GTS 19년, 더 뉴 K5. 차명·연식·등급·승차인원을 비교하며 적합한 제원이 없으면 미과금. 비우면 차종 목록"
},
"modelYear": {
"type": "string",
"description": "연식. 예: 2024, 24년식. model에 포함 가능하며 별도 값과 다르면 입력 오류"
}
}
}Check whether a Korean vehicle is subject to recalls or free repair campaigns by plate number or VIN. 차량번호 또는 차대번호(VIN) 중 하나로 리콜·무상점검수리 대상 여부와 건수, 리콜별 내용·시정 기간을 조회합니다. 리콜 대상이 아니면(recall_target=false) 과금되지 않습니다. car_no 와 vin 은 둘 중 하나만 보냅니다. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| vin | string | 차대번호 17자리. 예: KMHXX00XXXX000000 (car_no 와 함께 보내지 않는다) |
| car_no | string | 차량번호. 예: 12가3456, 서울12가3456 (vin 과 함께 보내지 않는다) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"vin": {
"type": "string",
"description": "차대번호 17자리. 예: KMHXX00XXXX000000 (car_no 와 함께 보내지 않는다)"
},
"car_no": {
"type": "string",
"description": "차량번호. 예: 12가3456, 서울12가3456 (vin 과 함께 보내지 않는다)"
}
}
}Calculate the annual Korean automobile tax for a non-commercial passenger car from engine displacement and vehicle age. 비영업용 승용자동차의 배기량(cc)과 차령으로 연간 자동차세·지방교육세·합계를 계산합니다. 차령 3년차부터 매년 5%씩 최대 50%까지 경감합니다. 연납 공제·감면·영업용 차량은 계산하지 않습니다. [호출당 60포인트]
| Argument | Type | Description |
|---|---|---|
| cc* | integer | 배기량(cc), 50~10000 |
| year | integer | 과세연도(YYYY), 2011년부터 올해까지. 생략하면 올해 |
| car_age_years | integer | 차령(년), 0~40. 생략하면 0 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"cc"
],
"properties": {
"cc": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "배기량(cc), 50~10000"
},
"year": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "과세연도(YYYY), 2011년부터 올해까지. 생략하면 올해"
},
"car_age_years": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "차령(년), 0~40. 생략하면 0"
}
}
}Look up venture company information of a Korean business, including financial statements and investment data. 벤처기업을 대상으로 사업자 정보, 대차대조표, 손익계산서, 투자정보, 벤처기업확인정보를 조회합니다. [호출당 40포인트]
| Argument | Type | Description |
|---|---|---|
| biz_no* | string | 사업자등록번호 (숫자 10자리, 하이픈 제외) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"biz_no"
],
"properties": {
"biz_no": {
"type": "string",
"description": "사업자등록번호 (숫자 10자리, 하이픈 제외)"
}
}
}Submit an asynchronous Veo video generation job. Select version and tier; supported modes, durations and prices depend on the selected version. Veo 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, veo_jobs_status Tool로 상태를 조회하고 완료되면 응답의 result_url(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 duration × 초당 900포인트가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다. [기본 버전 기준: 초당 900포인트 × duration(초). 다른 버전은 개발가이드의 버전별 요금표 참고.]
| Argument | Type | Description |
|---|---|---|
| mode | string | 입력 방식 — 'text'(텍스트만) | 'image'(첫 프레임 이미지 지정) | 'reference'(참조 이미지·영상으로 주체 지정). 기본 text |
| seed | integer | 재현성을 위한 시드 값 |
| tier | string | 품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다. |
| audio | boolean | 오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다. |
| prompt* | string | 영상 생성 프롬프트, 최대 2,000자 |
| version | string | 영상 모델 버전. 생략 시 3.1. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요. |
| duration | integer | 영상 길이(초), 전체 버전 범위 4~8. 허용 값과 기본값은 버전·등급별로 다릅니다. |
| image_url | string | image 모드에서 사용할 첫 프레임 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
Check the status of a Veo video generation job submitted via veo_jobs_create. Veo 영상 작업의 진행 상태를 조회합니다. 완료되면 응답의 result_url(REST 다운로드 주소)로 안내하며, 결과는 완료 후 7일간 유효합니다. 무료입니다. [무료]
| Argument | Type | Description |
|---|---|---|
| job_id* | string | 작업 ID |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "작업 ID"
}
}
}Extract the audio track of a video file as an MP3 file. 동영상 파일에서 오디오를 추출해 MP3 파일로 반환합니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| video_url* | string | 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/x-msvideo, video/webm, video/x-matroska) (최대 200MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"video_url"
],
"properties": {
"video_url": {
"type": "string",
"description": "다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/x-msvideo, video/webm, video/x-matroska) (최대 200MB)"
}
}
}Modulate the voice in a video or audio file to a lower or higher pitch. 동영상 또는 오디오 파일의 음성을 저음 또는 고음으로 변조합니다. MP3, WAV 등 오디오와 MP4, MOV 등 동영상 포맷을 지원하며, 변조된 파일을 반환합니다. [호출당 10포인트]
| 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) |
{
"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)"
}
}
}WHOIS lookup for a domain or IP address, returning registration and ownership information. 특정 도메인 또는 IP의 WHOIS(등록·소유) 정보를 조회합니다. .kr/.한국 도메인, 국내 IP, AS번호(예: AS9318)도 조회할 수 있습니다. [호출당 100포인트]
| Argument | Type | Description |
|---|---|---|
| address* | string | 검색할 도메인 또는 IP (예: apick.app) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "검색할 도메인 또는 IP (예: apick.app)"
}
}
}Generate a word cloud image (JPEG) from input text, sizing each word by frequency. 입력 텍스트를 구성하는 단어의 중요도(빈도수)에 따라 서로 다른 크기의 단어로 이루어진 워드클라우드 이미지(JPEG)를 생성해 반환합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| text* | string | 워드클라우드를 생성할 텍스트 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "워드클라우드를 생성할 텍스트"
}
}
}X (Twitter) post by URL: text, time, likes, reposts, replies, views, hashtags and media URLs. X 게시물 주소로 본문·작성 시각·좋아요·리포스트·답글·조회수·해시태그·미디어 주소를 조회합니다. [호출당 10포인트]
| Argument | Type | Description |
|---|---|---|
| url* | string | X 게시물 주소 (예: https://x.com/NASA/status/1234567890) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "X 게시물 주소 (예: https://x.com/NASA/status/1234567890)"
}
}
}X (Twitter) public profile: followers, following, posts count, bio, verification and recent posts with engagement. X 공개 계정의 팔로워·팔로잉·게시물 수·소개·인증 여부와 최근 게시물 반응 지표를 조회합니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| url | string | X 프로필 주소 (예: https://x.com/NASA) |
| username | string | X 사용자명 (@ 없이도 가능, username 또는 url 중 하나 필수) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"url": {
"type": "string",
"description": "X 프로필 주소 (예: https://x.com/NASA)"
},
"username": {
"type": "string",
"description": "X 사용자명 (@ 없이도 가능, username 또는 url 중 하나 필수)"
}
}
}Look up a YouTube channel (name, handle, subscribers, description) and list items of its videos, shorts, live or playlists tab. 유튜브 채널의 이름·핸들·구독자 수·소개와 영상·쇼츠·라이브·재생목록 탭의 목록을 조회합니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| tab | string | 목록 탭 (기본 videos) |
| count | integer | 받을 항목 수 1~100 (기본 30) |
| channel* | string | 채널 URL, 핸들(@이름) 또는 채널 ID(UC...) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"channel"
],
"properties": {
"tab": {
"enum": [
"videos",
"shorts",
"streams",
"playlists"
],
"type": "string",
"description": "목록 탭 (기본 videos)"
},
"count": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "받을 항목 수 1~100 (기본 30)"
},
"channel": {
"type": "string",
"description": "채널 URL, 핸들(@이름) 또는 채널 ID(UC...)"
}
}
}List comments of a public YouTube video sorted by top or newest, with author, text, likes, pinned/hearted flags and optional replies. 유튜브 공개 영상의 댓글을 인기순 또는 최신순으로 조회합니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| url* | string | 유튜브 영상 URL 또는 11자리 영상 ID |
| sort | string | top(인기순, 기본)·new(최신순) |
| count | integer | 받을 댓글 수 1~200 (기본 20, 답글 포함) |
| replies | boolean | true면 댓글마다 답글을 최대 5개까지 함께 받습니다 (기본 false) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "유튜브 영상 URL 또는 11자리 영상 ID"
},
"sort": {
"enum": [
"top",
"new"
],
"type": "string",
"description": "top(인기순, 기본)·new(최신순)"
},
"count": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "받을 댓글 수 1~200 (기본 20, 답글 포함)"
},
"replies": {
"type": "boolean",
"description": "true면 댓글마다 답글을 최대 5개까지 함께 받습니다 (기본 false)"
}
}
}List videos on a YouTube hashtag page. 유튜브 해시태그 페이지에 올라온 영상 목록을 조회합니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| count | integer | 받을 영상 수 1~100 (기본 30) |
| hashtag* | string | 해시태그 (# 생략 가능, 예: kpop) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"hashtag"
],
"properties": {
"count": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "받을 영상 수 1~100 (기본 30)"
},
"hashtag": {
"type": "string",
"description": "해시태그 (# 생략 가능, 예: kpop)"
}
}
}Look up metadata of a public YouTube video: title, channel, duration, views, likes, upload date, description, tags, chapters and thumbnails. 유튜브 공개 영상의 제목·채널·길이·조회수·좋아요·업로드일·설명·태그·챕터·썸네일 목록을 조회합니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| url* | string | 유튜브 영상 URL 또는 11자리 영상 ID (예: https://www.youtube.com/watch?v=..., https://youtu.be/..., /shorts/...) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "유튜브 영상 URL 또는 11자리 영상 ID (예: https://www.youtube.com/watch?v=..., https://youtu.be/..., /shorts/...)"
}
}
}Look up a public YouTube playlist: title, channel, video count and the list of videos in it. 유튜브 공개 재생목록의 제목·채널·영상 수와 수록 영상 목록을 조회합니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| url* | string | 재생목록 URL(list= 포함) 또는 재생목록 ID (예: PL...) |
| count | integer | 받을 영상 수 1~200 (기본 50) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "재생목록 URL(list= 포함) 또는 재생목록 ID (예: PL...)"
},
"count": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "받을 영상 수 1~200 (기본 50)"
}
}
}Search YouTube by keyword and list videos, shorts, channels or playlists with title, channel, duration, views and thumbnail. Supports sort (relevance, date, views, rating) and filters (upload date, type, duration). 키워드로 유튜브 영상·쇼츠·채널·재생목록을 검색합니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| sort | string | 정렬: relevance(관련도, 기본)·date(업로드일)·views(조회수)·rating(평점) |
| type | string | 결과 종류 (기본 any) |
| count | integer | 결과 수 1~50 (기본 10) |
| query* | string | 검색어 (1~200자) |
| duration | string | 길이: short(4분 미만)·medium(4~20분)·long(20분 초과) |
| upload_date | string | 업로드 시기 (기본 any) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"sort": {
"enum": [
"relevance",
"date",
"views",
"rating"
],
"type": "string",
"description": "정렬: relevance(관련도, 기본)·date(업로드일)·views(조회수)·rating(평점)"
},
"type": {
"enum": [
"any",
"video",
"channel",
"playlist",
"movie"
],
"type": "string",
"description": "결과 종류 (기본 any)"
},
"count": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "결과 수 1~50 (기본 10)"
},
"query": {
"type": "string",
"description": "검색어 (1~200자)"
},
"duration": {
"enum": [
"any",
"short",
"medium",
"long"
],
"type": "string",
"description": "길이: short(4분 미만)·medium(4~20분)·long(20분 초과)"
},
"upload_date": {
"enum": [
"any",
"hour",
"today",
"week",
"month",
"year"
],
"type": "string",
"description": "업로드 시기 (기본 any)"
}
}
}Download the subtitles of a public YouTube video in one language as VTT, SRT or plain text. 유튜브 공개 영상의 자막을 언어별로 VTT·SRT·텍스트 파일로 내려받습니다. 제공 언어는 youtube_subtitle_list로 확인합니다. [호출당 30포인트]
| Argument | Type | Description |
|---|---|---|
| url* | string | 유튜브 영상 URL 또는 11자리 영상 ID |
| lang* | string | 자막 언어 코드 (예: ko, en, en-US, en-orig). 자막 목록 조회 결과의 lang 값. 자동 번역 자막(translated=true)은 실패할 수 있어 원어 자막을 권장 |
| type | string | 자막 종류 any(기본: 수동 자막 우선, 없으면 자동 생성)·manual·auto |
| format | string | 파일 형식 vtt(기본)·srt·txt. txt는 시간 정보를 뺀 본문만 반환합니다. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url",
"lang"
],
"properties": {
"url": {
"type": "string",
"description": "유튜브 영상 URL 또는 11자리 영상 ID"
},
"lang": {
"type": "string",
"description": "자막 언어 코드 (예: ko, en, en-US, en-orig). 자막 목록 조회 결과의 lang 값. 자동 번역 자막(translated=true)은 실패할 수 있어 원어 자막을 권장"
},
"type": {
"type": "string",
"description": "자막 종류 any(기본: 수동 자막 우선, 없으면 자동 생성)·manual·auto"
},
"format": {
"type": "string",
"description": "파일 형식 vtt(기본)·srt·txt. txt는 시간 정보를 뺀 본문만 반환합니다."
}
}
}List the manual and auto-generated subtitle languages available for a public YouTube video. 유튜브 공개 영상에서 제공하는 수동 자막과 자동 생성 자막의 언어 목록을 조회합니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| url* | string | 유튜브 영상 URL 또는 11자리 영상 ID |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "유튜브 영상 URL 또는 11자리 영상 ID"
}
}
}Download the largest thumbnail of a public YouTube video as a JPG image. 유튜브 공개 영상의 가장 큰 썸네일 이미지를 JPG 파일로 내려받습니다. [호출당 20포인트]
| Argument | Type | Description |
|---|---|---|
| url* | string | 유튜브 영상 URL 또는 11자리 영상 ID |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "유튜브 영상 URL 또는 11자리 영상 ID"
}
}
}| platGbCd | string | 0 대지(기본), 1 산. 대지·산·임야 표기도 받습니다. |
| numOfRows | integer | 한 쪽 건수 (기본 20, 최대 100) |
| sigunguCd | string | 시군구코드 5자리 (pnu 가 없을 때) |
| startDate | string | 대장 생성일 범위 시작. title·recap 전용. 2024 / 2024-06 / 20240101 |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ji": {
"type": "string",
"description": "부번 (기본 0000)"
},
"bun": {
"type": "string",
"description": "본번. 숫자만 보내면 4자리로 채웁니다."
},
"pnu": {
"type": "string",
"pattern": "^[0-9]{19}$",
"description": "필지고유번호 19자리. 주면 번지 항목은 무시합니다."
},
"hoNm": {
"type": "string",
"description": "호 이름. floor·expos·area·price 전용"
},
"type": {
"enum": [
"title",
"recap",
"basis",
"floor",
"expos",
"area",
"price",
"wclf",
"jibun",
"district"
],
"type": "string",
"description": "대장 종류 (기본 title)"
},
"flrNo": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "층 번호. area 전용. 지하는 음수"
},
"dongNm": {
"type": "string",
"description": "동 이름. floor·expos·area·price 전용"
},
"pageNo": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "쪽 번호 (기본 1)"
},
"endDate": {
"type": "string",
"description": "대장 생성일 범위 끝. title·recap 전용. 연·월만 보내면 그 달 마지막 날로 맞춥니다."
},
"bjdongCd": {
"type": "string",
"pattern": "^[0-9]{5}$",
"description": "법정동코드 5자리 (pnu 가 없을 때)"
},
"platGbCd": {
"enum": [
"0",
"1"
],
"type": "string",
"description": "0 대지(기본), 1 산. 대지·산·임야 표기도 받습니다."
},
"numOfRows": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "한 쪽 건수 (기본 20, 최대 100)"
},
"sigunguCd": {
"type": "string",
"pattern": "^[0-9]{5}$",
"description": "시군구코드 5자리 (pnu 가 없을 때)"
},
"startDate": {
"type": "string",
"description": "대장 생성일 범위 시작. title·recap 전용. 2024 / 2024-06 / 20240101"
}
}
}{
"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)"
}
}
}| licen_no1* |
| string |
| 면허번호 2구획 (예: 19) |
| licen_no2* | string | 면허번호 3구획 (예: 174133) |
| licen_no3* | string | 면허번호 4구획 (예: 01) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"birth_y",
"birth_m",
"birth_d",
"name",
"licen_no0",
"licen_no1",
"licen_no2",
"licen_no3"
],
"properties": {
"name": {
"type": "string",
"description": "성명"
},
"rrn1": {
"type": "string",
"description": "주민등록번호 앞 6자리 (선택)"
},
"rrn2": {
"type": "string",
"description": "주민등록번호 뒤 7자리 (선택)"
},
"birth_d": {
"type": "string",
"description": "생년월일 - 일 (예: 01)"
},
"birth_m": {
"type": "string",
"description": "생년월일 - 월 (예: 01)"
},
"birth_y": {
"type": "string",
"description": "생년월일 - 년 (예: 2000)"
},
"ghost_num": {
"type": "string",
"description": "식별번호 (선택, 생략·빈값 허용, 전달값은 판정에 사용하지 않음)"
},
"licen_no0": {
"type": "string",
"description": "면허번호 1구획 (예: 21)"
},
"licen_no1": {
"type": "string",
"description": "면허번호 2구획 (예: 19)"
},
"licen_no2": {
"type": "string",
"description": "면허번호 3구획 (예: 174133)"
},
"licen_no3": {
"type": "string",
"description": "면허번호 4구획 (예: 01)"
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"mode",
"prompt",
"image_count"
],
"properties": {
"mode": {
"enum": [
"generate",
"edit"
],
"type": "string",
"description": "작업 방식"
},
"size": {
"enum": [
"1024x1024",
"1536x1024",
"1024x1536",
"1152x864",
"864x1152"
],
"type": "string",
"description": "표준 출력 크기, 기본 1024x1024"
},
"prompt": {
"type": "string",
"maxLength": 28000,
"description": "생성 또는 편집 지시, 최대 28,000자"
},
"quality": {
"enum": [
"basic",
"advanced",
"premium"
],
"type": "string",
"description": "이미지 품질. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P(장당). 기본 basic"
},
"image_url": {
"type": "string",
"description": "편집 모드에서 변경할 원본 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"background": {
"enum": [
"auto",
"opaque",
"transparent"
],
"type": "string",
"description": "배경 방식"
},
"image_count": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "만들 이미지 장수, 1~50"
},
"output_format": {
"enum": [
"png",
"jpeg",
"webp"
],
"type": "string",
"description": "출력 포맷"
},
"reference_image_url": {
"type": "string",
"description": "생성 모드에서 사용할 참고 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
}
}
}| resolution | string | 출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다. |
| aspect_ratio | string | 출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요. |
| last_image_url | string | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB) |
| idempotency_key | string | 같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키 |
| negative_prompt | string | 제외할 요소를 설명하는 텍스트 |
| reference_image_url | string | reference 모드에서 주체를 지정할 참조 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB) |
| reference_video_url | string | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB) |
| reference_image_url_2 | string | reference 모드 참조 이미지 URL(2번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB) |
| reference_image_url_3 | string | reference 모드 참조 이미지 URL(3번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB) |
| reference_image_url_4 | string | 참조 이미지 URL(4번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB) |
| reference_image_url_5 | string | 참조 이미지 URL(5번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB) |
| reference_image_url_6 | string | 참조 이미지 URL(6번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB) |
| reference_image_url_7 | string | 참조 이미지 URL(7번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB) |
| reference_video_url_2 | string | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB) |
| reference_video_url_3 | string | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB) |
| reference_video_url_4 | string | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"prompt"
],
"properties": {
"mode": {
"enum": [
"text",
"image",
"reference"
],
"type": "string",
"description": "입력 방식 — 'text'(텍스트만) | 'image'(첫 프레임 이미지 지정) | 'reference'(참조 이미지·영상으로 주체 지정). 기본 text"
},
"tier": {
"enum": [
"std",
"pro",
"turbo",
"4k",
"standard"
],
"type": "string",
"description": "품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다."
},
"audio": {
"type": "boolean",
"description": "오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다."
},
"prompt": {
"type": "string",
"maxLength": 2000,
"description": "영상 생성 프롬프트, 최대 2,000자"
},
"version": {
"enum": [
"3.0",
"o3",
"o1"
],
"type": "string",
"description": "영상 모델 버전. 생략 시 3.0. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요."
},
"duration": {
"type": "integer",
"maximum": 15,
"minimum": 3,
"description": "영상 길이(초), 전체 버전 범위 3~15. 허용 값과 기본값은 버전·등급별로 다릅니다."
},
"cfg_scale": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "프롬프트 반영 강도(0~1), 기본 0.5"
},
"image_url": {
"type": "string",
"description": "image 모드에서 사용할 첫 프레임 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"resolution": {
"enum": [
"720p",
"1080p",
"720P",
"1080P-SR",
"1440P-SR",
"1080P"
],
"type": "string",
"description": "출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다."
},
"aspect_ratio": {
"enum": [
"16:9",
"9:16",
"1:1"
],
"type": "string",
"description": "출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요."
},
"last_image_url": {
"type": "string",
"description": "image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 128,
"minLength": 8,
"description": "같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키"
},
"negative_prompt": {
"type": "string",
"maxLength": 1000,
"description": "제외할 요소를 설명하는 텍스트"
},
"reference_image_url": {
"type": "string",
"description": "reference 모드에서 주체를 지정할 참조 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"reference_video_url": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_image_url_2": {
"type": "string",
"description": "reference 모드 참조 이미지 URL(2번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"reference_image_url_3": {
"type": "string",
"description": "reference 모드 참조 이미지 URL(3번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"reference_image_url_4": {
"type": "string",
"description": "참조 이미지 URL(4번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"reference_image_url_5": {
"type": "string",
"description": "참조 이미지 URL(5번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"reference_image_url_6": {
"type": "string",
"description": "참조 이미지 URL(6번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"reference_image_url_7": {
"type": "string",
"description": "참조 이미지 URL(7번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 10MB)"
},
"reference_video_url_2": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_3": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_4": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
}
}
}| integer |
| 응답 최대 토큰. 미지정 시 모델 컨텍스트 기반 안전 상한으로 자동 설정, 명시한 값은 클램프 없이 그대로 적용 |
| temperature | number | 출력 다양성 0.0~2.0. 낮을수록 재현성, 높을수록 창의성 (미지정 시 모델 기본값) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"model"
],
"properties": {
"model": {
"type": "string",
"description": "모델 id (llm_models Tool로 조회 가능, 예: openai/gpt-oss-120b)"
},
"speed": {
"type": "string",
"description": "응답 속도/추론 깊이 — 'fast'(얕게, 빠름) | 'medium' | 'slow'(깊게, 느림). 한글 '빠름'|'중간'|'느림' 허용. 추론 특화 모델에서 효과가 큽니다"
},
"system": {
"type": "string",
"description": "system 프롬프트 (역할·페르소나·정책·배경지식). 미지정 시 기본 한국어 어시스턴트 프롬프트가 적용됩니다"
},
"compact": {
"type": "object",
"description": "히스토리 압축 옵션 { strategy: 'none'(기본) | 'sliding_window' | 'relevance', window_pairs: 유지할 user/assistant 페어 수 (기본 10, 최소 1) }. relevance 는 최근 대화와 함께 최신 질문에 필요한 이전 대화를 골라 남긴다. 긴 대화의 input 토큰 누적 방지",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"content": {
"type": "string",
"description": "단발 입력 — 사용자 메시지 한 건만 보내는 간편 형태. messages 와 둘 중 하나는 필수"
},
"messages": {
"type": "array",
"items": {},
"description": "OpenAI 형식 [{role, content}] 배열. role 은 'system'|'user'|'assistant'. content 와 둘 중 하나는 필수, 동시 지정 시 messages 우선. 멀티턴 대화는 응답의 compacted_messages 를 다음 턴에 그대로 전송"
},
"max_tokens": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "응답 최대 토큰. 미지정 시 모델 컨텍스트 기반 안전 상한으로 자동 설정, 명시한 값은 클램프 없이 그대로 적용"
},
"temperature": {
"type": "number",
"description": "출력 다양성 0.0~2.0. 낮을수록 재현성, 높을수록 창의성 (미지정 시 모델 기본값)"
}
}
}| engl_yn |
| string |
| 영문 증명 여부 (Y/N, 생략 시 N) |
| delivery* | string | 교부방법 (06 프린터·10 화면·04 팩스·12 전자문서지갑). 문서는 응답으로 받으므로 보통 06 |
| quantity | integer | 발급 희망 수량 (1~5, 생략 시 1) |
| birthDate* | string | 생년월일 8자리 (YYYYMMDD) |
| submit_to* | string | 제출처 코드 2자리 (예: 99 기타) |
| business_no* | string | 사업자등록번호 10자리 (숫자만) |
| use_purpose* | string | 사용용도 코드 2자리 (예: 99 기타) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
| wallet_address | string | 전자문서지갑 주소 (delivery=12 일 때 필수) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider",
"business_no",
"year",
"use_purpose",
"submit_to",
"delivery"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"year": {
"type": "string",
"pattern": "^[0-9]{4}$",
"description": "귀속연도 4자리 (최근 5년, 예: 2025)"
},
"email": {
"type": "string",
"description": "수령 이메일 (선택, 생략 시 회원정보)"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"agreed": {
"type": "boolean",
"description": "대표자 본인 확인 동의. bind_id 가 없으면 true 여야 접수되며, 빠지면 인증을 보내지 않고 무과금으로 거절"
},
"fax_no": {
"type": "string",
"pattern": "^[0-9]{9,11}$",
"description": "팩스번호 (delivery=04 일 때 필수)"
},
"format": {
"enum": [
"pdf",
"json",
"both"
],
"type": "string",
"description": "응답 형식 (pdf=PDF base64만·json=PDF를 읽은 값만·both=둘 다, 생략 시 both). 대화형 사용은 응답이 작은 json 을 권장"
},
"period": {
"enum": [
"1",
"2",
"all"
],
"type": "string",
"description": "부가가치세 과세표준증명 과세기간 (1=1기·2=2기·all=연간)"
},
"bind_id": {
"type": "string",
"description": "이전 사업자 조회 결과의 bind_id (같은 계정·같은 사업자등록번호, 90일 이내면 agreed 없이 접수)"
},
"engl_yn": {
"enum": [
"Y",
"N"
],
"type": "string",
"description": "영문 증명 여부 (Y/N, 생략 시 N)"
},
"delivery": {
"enum": [
"10",
"12",
"06",
"04"
],
"type": "string",
"description": "교부방법 (06 프린터·10 화면·04 팩스·12 전자문서지갑). 문서는 응답으로 받으므로 보통 06"
},
"quantity": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "발급 희망 수량 (1~5, 생략 시 1)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"submit_to": {
"type": "string",
"pattern": "^[0-9]{2}$",
"description": "제출처 코드 2자리 (예: 99 기타)"
},
"business_no": {
"type": "string",
"pattern": "^[0-9]{10}$",
"description": "사업자등록번호 10자리 (숫자만)"
},
"use_purpose": {
"type": "string",
"pattern": "^[0-9]{2}$",
"description": "사용용도 코드 2자리 (예: 99 기타)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
},
"wallet_address": {
"type": "string",
"description": "전자문서지갑 주소 (delivery=12 일 때 필수)"
}
}
}| submit_to* | string | 제출처 코드 2자리 (예: 99 기타) |
| use_purpose* | string | 사용용도 코드 2자리 (예: 99 기타) |
| authProvider* | string | 휴대폰에서 승인할 간편인증 방식 |
| resno_open_yn | string | 주민등록번호 공개 여부 (Y/N) |
| amount_open_yn | string | 소득금액증명 금액 공개 여부 (Y/N) |
| wallet_address | string | 전자문서지갑 주소 (delivery=12 일 때 필수) |
| address_open_yn | string | 주소 공개 여부 (Y/N) |
| income_source_open_yn | string | 소득금액증명 소득발생처 공개 여부 (Y/N) |
| withholding_all_print_yn | string | 소득금액증명 원천징수의무자 전체 표시 (Y/N) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"birthDate",
"phone",
"authProvider",
"year",
"use_purpose",
"submit_to",
"delivery"
],
"properties": {
"name": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "본인 이름"
},
"year": {
"type": "string",
"pattern": "^[0-9]{4}$",
"description": "귀속연도 4자리 (최근 5년, 예: 2025)"
},
"email": {
"type": "string",
"description": "수령 이메일 (선택, 생략 시 회원정보)"
},
"phone": {
"type": "string",
"pattern": "^01[0-9]{8,9}$",
"description": "본인 명의 휴대전화 번호 (숫자만)"
},
"fax_no": {
"type": "string",
"pattern": "^[0-9]{9,11}$",
"description": "팩스번호 (delivery=04 일 때 필수)"
},
"format": {
"enum": [
"pdf",
"json",
"both"
],
"type": "string",
"description": "응답 형식 (pdf=PDF base64만·json=PDF를 읽은 값만·both=둘 다, 생략 시 both). 대화형 사용은 응답이 작은 json 을 권장"
},
"delivery": {
"enum": [
"10",
"12",
"06",
"04"
],
"type": "string",
"description": "교부방법 (06 프린터·10 화면·04 팩스·12 전자문서지갑). 문서는 응답으로 받으므로 보통 06"
},
"quantity": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "발급 희망 수량 (1~5, 생략 시 1)"
},
"birthDate": {
"type": "string",
"pattern": "^[0-9]{8}$",
"description": "생년월일 8자리 (YYYYMMDD)"
},
"submit_to": {
"type": "string",
"pattern": "^[0-9]{2}$",
"description": "제출처 코드 2자리 (예: 99 기타)"
},
"use_purpose": {
"type": "string",
"pattern": "^[0-9]{2}$",
"description": "사용용도 코드 2자리 (예: 99 기타)"
},
"authProvider": {
"enum": [
"kakao",
"naver",
"toss",
"pass",
"samsung",
"kb",
"shinhan",
"hana",
"woori",
"ibk",
"nh",
"kakaobank",
"banksalad"
],
"type": "string",
"description": "휴대폰에서 승인할 간편인증 방식"
},
"resno_open_yn": {
"enum": [
"Y",
"N"
],
"type": "string",
"description": "주민등록번호 공개 여부 (Y/N)"
},
"amount_open_yn": {
"enum": [
"Y",
"N"
],
"type": "string",
"description": "소득금액증명 금액 공개 여부 (Y/N)"
},
"wallet_address": {
"type": "string",
"description": "전자문서지갑 주소 (delivery=12 일 때 필수)"
},
"address_open_yn": {
"enum": [
"Y",
"N"
],
"type": "string",
"description": "주소 공개 여부 (Y/N)"
},
"income_source_open_yn": {
"enum": [
"Y",
"N"
],
"type": "string",
"description": "소득금액증명 소득발생처 공개 여부 (Y/N)"
},
"withholding_all_print_yn": {
"enum": [
"Y",
"N"
],
"type": "string",
"description": "소득금액증명 원천징수의무자 전체 표시 (Y/N)"
}
}
}| resolution | string | 출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다. |
| aspect_ratio | string | 출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요. |
| last_image_url | string | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| idempotency_key | string | 같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키 |
| reference_audio_url | string | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB) |
| reference_image_url | string | reference 모드에서 주체를 지정할 참조 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_video_url | string | reference 모드에서 동작을 참조할 영상 URL — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 50MB) |
| reference_audio_url_2 | string | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB) |
| reference_audio_url_3 | string | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB) |
| reference_audio_url_4 | string | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB) |
| reference_audio_url_5 | string | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB) |
| reference_audio_url_6 | string | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB) |
| reference_audio_url_7 | string | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB) |
| reference_audio_url_8 | string | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB) |
| reference_audio_url_9 | string | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB) |
| reference_image_url_2 | string | reference 모드 참조 이미지 URL(2번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_3 | string | reference 모드 참조 이미지 URL(3번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_4 | string | 참조 이미지 URL(4번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_5 | string | 참조 이미지 URL(5번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_6 | string | 참조 이미지 URL(6번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_7 | string | 참조 이미지 URL(7번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_8 | string | 참조 이미지 URL(8번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_9 | string | 참조 이미지 URL(9번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_video_url_2 | string | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB) |
| reference_video_url_3 | string | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB) |
| reference_video_url_4 | string | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB) |
| reference_video_url_5 | string | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB) |
| reference_video_url_6 | string | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB) |
| reference_video_url_7 | string | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB) |
| reference_video_url_8 | string | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB) |
| reference_video_url_9 | string | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB) |
| reference_audio_url_10 | string | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB) |
| reference_image_url_10 | string | 참조 이미지 URL(10번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_11 | string | 참조 이미지 URL(11번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_12 | string | 참조 이미지 URL(12번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_13 | string | 참조 이미지 URL(13번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_14 | string | 참조 이미지 URL(14번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_15 | string | 참조 이미지 URL(15번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_16 | string | 참조 이미지 URL(16번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_17 | string | 참조 이미지 URL(17번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_18 | string | 참조 이미지 URL(18번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_19 | string | 참조 이미지 URL(19번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_20 | string | 참조 이미지 URL(20번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_21 | string | 참조 이미지 URL(21번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_22 | string | 참조 이미지 URL(22번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_23 | string | 참조 이미지 URL(23번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_24 | string | 참조 이미지 URL(24번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_25 | string | 참조 이미지 URL(25번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_26 | string | 참조 이미지 URL(26번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_27 | string | 참조 이미지 URL(27번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_28 | string | 참조 이미지 URL(28번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_29 | string | 참조 이미지 URL(29번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_30 | string | 참조 이미지 URL(30번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_video_url_10 | string | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"prompt"
],
"properties": {
"mode": {
"enum": [
"text",
"image",
"reference"
],
"type": "string",
"description": "입력 방식 — 'text'(텍스트만) | 'image'(첫 프레임 이미지 지정) | 'reference'(참조 이미지·영상으로 주체 지정). 기본 text"
},
"seed": {
"type": "integer",
"maximum": 2147483647,
"minimum": 0,
"description": "재현성을 위한 시드 값"
},
"tier": {
"enum": [
"standard",
"fast",
"mini",
"pro"
],
"type": "string",
"description": "품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다."
},
"audio": {
"type": "boolean",
"description": "오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다."
},
"prompt": {
"type": "string",
"maxLength": 2000,
"description": "영상 생성 프롬프트, 최대 2,000자"
},
"version": {
"enum": [
"2.5",
"2.0",
"1.5",
"1.0"
],
"type": "string",
"description": "영상 모델 버전. 생략 시 2.5. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요."
},
"duration": {
"type": "integer",
"maximum": 30,
"minimum": 2,
"description": "영상 길이(초), 전체 버전 범위 2~30. 허용 값과 기본값은 버전·등급별로 다릅니다."
},
"image_url": {
"type": "string",
"description": "image 모드에서 사용할 첫 프레임 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"resolution": {
"enum": [
"480p",
"720p",
"1080p"
],
"type": "string",
"description": "출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다."
},
"aspect_ratio": {
"enum": [
"16:9",
"4:3",
"1:1",
"3:4",
"9:16",
"21:9",
"adaptive"
],
"type": "string",
"description": "출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요."
},
"last_image_url": {
"type": "string",
"description": "image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 128,
"minLength": 8,
"description": "같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키"
},
"reference_audio_url": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_image_url": {
"type": "string",
"description": "reference 모드에서 주체를 지정할 참조 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_video_url": {
"type": "string",
"description": "reference 모드에서 동작을 참조할 영상 URL — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 50MB)"
},
"reference_audio_url_2": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_3": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_4": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_5": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_6": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_7": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_8": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_audio_url_9": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_image_url_2": {
"type": "string",
"description": "reference 모드 참조 이미지 URL(2번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_3": {
"type": "string",
"description": "reference 모드 참조 이미지 URL(3번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_4": {
"type": "string",
"description": "참조 이미지 URL(4번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_5": {
"type": "string",
"description": "참조 이미지 URL(5번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_6": {
"type": "string",
"description": "참조 이미지 URL(6번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_7": {
"type": "string",
"description": "참조 이미지 URL(7번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_8": {
"type": "string",
"description": "참조 이미지 URL(8번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_9": {
"type": "string",
"description": "참조 이미지 URL(9번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_video_url_2": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_3": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_4": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_5": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_6": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_7": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_8": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_video_url_9": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
},
"reference_audio_url_10": {
"type": "string",
"description": "참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: audio/mpeg, audio/wav, audio/x-wav) (최대 15MB)"
},
"reference_image_url_10": {
"type": "string",
"description": "참조 이미지 URL(10번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_11": {
"type": "string",
"description": "참조 이미지 URL(11번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_12": {
"type": "string",
"description": "참조 이미지 URL(12번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_13": {
"type": "string",
"description": "참조 이미지 URL(13번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_14": {
"type": "string",
"description": "참조 이미지 URL(14번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_15": {
"type": "string",
"description": "참조 이미지 URL(15번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_16": {
"type": "string",
"description": "참조 이미지 URL(16번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_17": {
"type": "string",
"description": "참조 이미지 URL(17번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_18": {
"type": "string",
"description": "참조 이미지 URL(18번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_19": {
"type": "string",
"description": "참조 이미지 URL(19번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_20": {
"type": "string",
"description": "참조 이미지 URL(20번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_21": {
"type": "string",
"description": "참조 이미지 URL(21번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_22": {
"type": "string",
"description": "참조 이미지 URL(22번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_23": {
"type": "string",
"description": "참조 이미지 URL(23번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_24": {
"type": "string",
"description": "참조 이미지 URL(24번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_25": {
"type": "string",
"description": "참조 이미지 URL(25번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_26": {
"type": "string",
"description": "참조 이미지 URL(26번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_27": {
"type": "string",
"description": "참조 이미지 URL(27번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_28": {
"type": "string",
"description": "참조 이미지 URL(28번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_29": {
"type": "string",
"description": "참조 이미지 URL(29번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_30": {
"type": "string",
"description": "참조 이미지 URL(30번째). 버전별 최대 개수를 확인하세요. — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_video_url_10": {
"type": "string",
"description": "참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. — 다운로드 가능한 https URL (허용 형식: video/mp4, video/quicktime, video/webm) (최대 100MB)"
}
}
}| boolean |
| 멀티화자. Gemini는 화자 2명까지 한 호출, ChatGPT는 발화별 목소리 대화 |
| normalize_text | boolean | 기본 true, 정규화 추가 과금 |
| volume_gain_db | number | 음량 보정 -12~12 dB. 0이 기본 |
| idempotency_key | string | 같은 요청의 재접수 키 |
{
"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": "같은 요청의 재접수 키"
}
}
}| boolean |
| 멀티화자. Gemini는 화자 2명까지 한 호출, ChatGPT는 발화별 목소리 대화 |
| normalize_text | boolean | 기본 true. 정규화 스킬 비용 합산, false는 실행·과금 생략 |
| volume_gain_db | number | 음량 보정 -12~12 dB. 0이 기본 |
| idempotency_key | string | 접수 응답 유실 시 같은 요청에 재사용할 키 |
{
"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": "접수 응답 유실 시 같은 요청에 재사용할 키"
}
}
}| boolean |
| 멀티화자. Gemini는 화자 2명까지 한 호출, ChatGPT는 발화별 목소리 대화 |
| normalize_text | boolean | 기본 true, 정규화 추가 과금 |
| volume_gain_db | number | 음량 보정 -12~12 dB. 0이 기본 |
| idempotency_key | string | 같은 요청의 재접수 키 |
{
"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": "같은 요청의 재접수 키"
}
}
}| 발화 목록 |
| multi_speaker | boolean | 멀티화자. Gemini는 화자 2명까지 한 호출, ChatGPT는 발화별 목소리 대화 |
| normalize_text | boolean | 기본 true |
| volume_gain_db | number | 음량 보정 -12~12 dB. 0이 기본 |
{
"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이 기본"
}
}
}| resolution | string | 출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다. |
| aspect_ratio | string | 출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요. |
| last_image_url | string | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| idempotency_key | string | 같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키 |
| negative_prompt | string | 제외할 요소를 설명하는 텍스트 |
| reference_image_url | string | reference 모드에서 주체를 지정할 참조 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_2 | string | reference 모드 참조 이미지 URL(2번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
| reference_image_url_3 | string | reference 모드 참조 이미지 URL(3번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"prompt"
],
"properties": {
"mode": {
"enum": [
"text",
"image",
"reference"
],
"type": "string",
"description": "입력 방식 — 'text'(텍스트만) | 'image'(첫 프레임 이미지 지정) | 'reference'(참조 이미지·영상으로 주체 지정). 기본 text"
},
"seed": {
"type": "integer",
"maximum": 2147483647,
"minimum": 0,
"description": "재현성을 위한 시드 값"
},
"tier": {
"enum": [
"standard",
"fast",
"lite"
],
"type": "string",
"description": "품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다."
},
"audio": {
"type": "boolean",
"description": "오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다."
},
"prompt": {
"type": "string",
"maxLength": 2000,
"description": "영상 생성 프롬프트, 최대 2,000자"
},
"version": {
"enum": [
"3.1"
],
"type": "string",
"description": "영상 모델 버전. 생략 시 3.1. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요."
},
"duration": {
"type": "integer",
"maximum": 8,
"minimum": 4,
"description": "영상 길이(초), 전체 버전 범위 4~8. 허용 값과 기본값은 버전·등급별로 다릅니다."
},
"image_url": {
"type": "string",
"description": "image 모드에서 사용할 첫 프레임 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"resolution": {
"enum": [
"720p",
"1080p",
"4k"
],
"type": "string",
"description": "출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다."
},
"aspect_ratio": {
"enum": [
"16:9",
"9:16"
],
"type": "string",
"description": "출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요."
},
"last_image_url": {
"type": "string",
"description": "image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 128,
"minLength": 8,
"description": "같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키"
},
"negative_prompt": {
"type": "string",
"maxLength": 1000,
"description": "제외할 요소를 설명하는 텍스트"
},
"reference_image_url": {
"type": "string",
"description": "reference 모드에서 주체를 지정할 참조 이미지 URL — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_2": {
"type": "string",
"description": "reference 모드 참조 이미지 URL(2번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
},
"reference_image_url_3": {
"type": "string",
"description": "reference 모드 참조 이미지 URL(3번째) — 다운로드 가능한 https URL (허용 형식: image/png, image/jpeg, image/webp) (최대 50MB)"
}
}
}