Official zero-dependency Node.js client for APICK data, AI, and image APIs. 에이픽 데이터·AI·이미지 API 공식 Node.js SDK.
에이픽 데이터·AI·이미지 API를 API 키 하나로 호출하는 공식 Node.js SDK
Official zero-dependency Node.js SDK for APICK data, AI, and image APIs
한국어 가이드 · English guide · APICK · API 문서
본문이 있는 요청은 multipart/form-data로 전송됩니다. 배열·객체도 개별 폼 항목으로 전달하고 SDK가 boundary를 자동 설정합니다. 기존 메서드와 JSON·파일 응답 형식은 유지됩니다.
Requests with a body use multipart/form-data, including indexed fields for nested values. The SDK sets the boundary automatically; method signatures and JSON/file results remain unchanged.
npm install apick-api
ES modules:
import { ApickClient } from 'apick-api';
const apick = new ApickClient(process.env.APICK_API_KEY);
const { data, meta } = await apick.businessDetails('439-87-00761');
console.log(data);
console.log(`사용 포인트: ${meta.cost}`);
CommonJS:
const { ApickClient } = require('apick-api');
const apick = new ApickClient(process.env.APICK_API_KEY);
const result = await apick.trackParcelAuto('123456789012');
console.log(result.data);
인증키는 apick.app 가입 후 마이페이지에서 발급할 수 있습니다. Get an API key from your account page after signing up at apick.app.
마이페이지의 허용 IP가 공란이면 제한 없이 호출할 수 있습니다. 제한하려면 APICK에 도착하는 공인 IPv4를 단일 주소 또는 CIDR(/32 등)로 등록하세요. 저장 즉시 반영되며 별도 동기화는 필요하지 않습니다.
Leave the allowed-IP list blank for unrestricted access. To restrict access, register the public IPv4 address seen by APICK as an exact address or CIDR such as /32. Changes apply immediately with no separate synchronization.
| Method | APICK service | Result |
|---|---|---|
businessDetails(businessNumber) | 사업자 정보 조회 / Business details | JSON |
ventureBusiness(businessNumber) | 벤처기업 정보 / Venture business data | JSON |
trackParcel(carrier, trackingNumber) | 택배 배송조회 / Parcel tracking | JSON |
trackParcelAuto(trackingNumber) | 택배사 자동판별 배송조회 / Auto carrier tracking | JSON |
validateEmail(email) | 이메일 유효성 / Email validation | JSON |
validatePhone(number) | 전화번호 유효성 / Phone validation | JSON |
holidays(year, month) | 대한민국 공휴일 / Korean holidays | JSON |
searchAddress(query, options) | 도로명주소 검색 / Road address search | JSON |
vehicleModelInfo(options) | 차종별 차량정보 조회 / Vehicle model specifications for cars and motorcycles/scooters (승용차·이륜차 / 표기가 달라도 가장 비슷한 차종 / closest match when spelled differently · 값은 표준 표기 / standard notation values) | JSON |
ocr(image, options) | 이미지 OCR / Image OCR | JSON |
dnsLookup(domain) | DNS 조회 / DNS lookup | JSON |
geolocate(address) | 도메인·IP 위치 / Domain and IP location | JSON |
whois(address) | WHOIS 조회 / WHOIS lookup | JSON |
googleSearch(keyword, options) | 웹 검색 / Web search | JSON |
googleImageSearch(keyword, options) | 이미지 검색(page 1~5) / Image search (pages 1-5) | JSON |
googleNewsSearch(keyword, options) | 구글 뉴스 검색 / Google News search | JSON |
googleShoppingSearch(keyword, options) | 구글 쇼핑 검색 / Google Shopping search | JSON |
googleMapsSearch(keyword) | 구글 지도 장소 검색 / Google Maps place search | JSON |
googleRankCheck(keyword, domain) | 구글 검색 순위 확인(1~100위) / Google rank check (top 100) | JSON |
screenshot(url) | 웹페이지 화면캡처 / Web screenshot | Binary |
youtubeMetadata(url) | 유튜브 영상 정보 / YouTube video metadata | JSON |
youtubeThumbnail(url) | 유튜브 썸네일 / YouTube thumbnail | JPG |
youtubeSubtitleList(url) | 유튜브 자막 언어 목록 / YouTube subtitle languages | JSON |
youtubeSubtitle(url, lang, options) | 유튜브 자막 다운로드(원어 자막 권장) / YouTube subtitles (prefer original-language tracks) | VTT·SRT·TXT |
youtubeSearch(query, options) | 유튜브 검색(정렬·필터) / YouTube search with sort and filters | JSON |
youtubeChannel(channel, options) | 유튜브 채널 정보·탭 목록 / YouTube channel and tab items | JSON |
youtubePlaylist(url, options) | 유튜브 재생목록 / YouTube playlist | JSON |
youtubeHashtag(hashtag, options) | 유튜브 해시태그 영상 / YouTube hashtag videos | JSON |
youtubeComments(url, options) | 유튜브 댓글 / YouTube comments | JSON |
instagramProfile(usernameOrUrl) | 인스타그램 공개 프로필 / Instagram public profile | JSON |
instagramPost(url) | 인스타그램 게시물·릴스 / Instagram post or reel | JSON |
tiktokProfile(usernameOrUrl) | 틱톡 공개 프로필 / TikTok public profile | JSON |
amazonProduct(urlOrAsin) | 아마존 상품 정보 / Amazon product | JSON |
xProfile(usernameOrUrl) | X 공개 프로필·최근 게시물 / X public profile and recent posts | JSON |
xPost(url) | X 게시물 / X post | JSON |
coupangProduct(urlOrProductId) | 쿠팡 상품 정보 / Coupang product | JSON |
naverShoppingProduct(url) | 네이버 브랜드스토어 상품 정보 / Naver brand store product | JSON |
linkedinProfile(url) | 링크드인 프로필 / LinkedIn profile | JSON |
linkedinCompany(url) | 링크드인 회사 정보 / LinkedIn company | JSON |
linkedinJob(url) | 링크드인 채용공고 / LinkedIn job posting | JSON |
courtAuction(caseNo, court) | 법원 경매사건 조회 / Court auction case | JSON |
bidNotice(options) | 입찰 공고 분석 / Bid notice analytics | JSON |
bidAward(options) | 낙찰 경쟁 분석 / Bid award analytics | JSON |
rtmsTrade(lawdCd, dealYmd, options) | 매매 시장 분석 / Sale market analytics | JSON |
rtmsRent(lawdCd, dealYmd, options) | 전월세 시장 분석 / Rent market analytics | JSON |
registryDocVerify(issueNo, options) | 등기·증명서 발급확인 / Registry certificate verification | JSON |
corpFinance(crno, options) | 기업 재무정보 / Corporate financial statements | JSON |
buildingRegister(options) | 건축물대장 / Building register | JSON |
registryRealestateSearch(query) | 부동산 등기 검색 / Real-estate registry search | JSON |
| `registryCorporateSearch({ corpRegNo | bizNo })` | 법인 등기 검색 / Corporate registry search |
createRegistryRealestateJob(options) / createRegistryCorporateJob(options) | 등기 열람·발급 접수 / Registry view or issue job | JSON |
getRegistryJob(jobId) / downloadRegistryPdf(jobId) | 등기 작업 상태·PDF / Registry job status and PDF | JSON·PDF |
vehicleEmission(certNo) | 배출가스 인증정보 / Emission certification | JSON |
| `vehicleRecall({ carNo | vin })` | 자동차 리콜 대상 여부(대상 아니면 0P) / Vehicle recall check (0P when none) |
hipassUnpaid(carNo) | 하이패스 미납 여부(미납 없으면 0P) / Unpaid expressway toll check (0P when none) | JSON |
vehicleTaxCalc(cc, options) | 자동차세 계산 / Annual automobile tax | JSON |
appReviews(appId, options) | 앱스토어 리뷰 / App Store reviews | JSON |
geoStandardize(input) · geoBatchGeocode(addresses) · geoReverse(input) · geoAdminCode(input) | 주소 표준화·대량 좌표 변환·좌표→주소·행정코드 / Address standardisation, batch geocoding, reverse geocoding, admin codes | JSON |
geoAddressSearch(query) · geoAddressAutocomplete(query) · geoPlaceSearch(query) · geoCompareAddress(a, b) · geoAddressQuality(addresses) | 주소 검색·자동완성·장소 검색·주소 동일성·주소 품질 / Address search, autocomplete, place search, address matching, address quality | JSON |
geoMeasure(coordinates) · geoGeojsonAnalyze(geojson) · geoDistrictBoundary(query) · geoNeighborhood(input) | 거리·면적 측량·GeoJSON 분석·행정구역 경계·주변 생활시설 / Distance and area, GeoJSON analysis, district boundaries, nearby facilities | JSON |
createTtsJob(text, options) | 한국어 내레이션 작업 접수 / Create TTS job | JSON |
getTtsJob(jobId) | TTS 작업 상태 / TTS job status | JSON |
cancelTtsJob(jobId) | 대기·생성 중 TTS 작업 취소 / Cancel waiting or processing TTS job | JSON |
downloadTtsResult(jobId) | TTS 결과 1회 다운로드 / One-time TTS result | MP3 |
downloadTtsSubtitles(jobId) | TTS 자막 1회 다운로드 / One-time TTS subtitles | ASS |
getTtsQuality(jobId) | 폐기됨 / Retired | HTTP 409 |
retryTtsJob(jobId, utteranceIds, idempotencyKey) | 폐기됨 / Retired | HTTP 409 |
downloadTtsCandidate(jobId, candidateId) | 폐기됨 / Retired | HTTP 409 |
htmlToPdf(html, options) | HTML→PDF | Binary |
jsonToExcel(data, options) | JSON→Excel | Binary |
summarize(text) | 텍스트 요약 / Text summarization | JSON |
polish(text) | 텍스트 다듬기 / Text polishing | JSON |
generateImages(prompt, options) | 이미지 생성 / Image generation | JSON |
editImages(image, prompt, options) | 이미지 편집 / Image editing | JSON |
createImageGenerationJob(prompt, options) | 대량 이미지 생성 작업 / Batch generation job | JSON |
createImageEditJob(image, prompt, options) | 대량 이미지 편집 작업 / Batch edit job | JSON |
getImageJob(jobId) | 이미지 작업 상태 조회 / Job status | JSON |
downloadImageJobImage(jobId, index) | 개별 결과 / Individual result | Binary |
downloadImageJobArchive(jobId) | ZIP 결과 / ZIP archive | Binary |
requestEmployment(input) / getEmployment(transactionId) | 재직·보험료 확인 / Employment & insurance premium check | JSON |
requestPersonalIncome(input) / getPersonalIncome(transactionId) | 금융소득(이자·배당) 조회 / Financial income (interest/dividend) | JSON |
requestNpsJoinHistory(input) / getNpsJoinHistory(transactionId) | 국민연금 가입내역조회 / National Pension join history | JSON |
requestNpsDeductionCert(input) / getNpsDeductionCert(transactionId) | 국민연금 소득공제용 납부확인서 / National Pension payment certificate for income deduction | JSON |
requestNpsCareerHistory(input) / getNpsCareerHistory(transactionId) | 국민연금 경력 이력 조회 / National Pension career history | JSON |
requestDrivingLicense(input) / getDrivingLicense(transactionId) | 운전면허 조회 / Driver's license check | JSON |
requestHealthCheckup(input) / getHealthCheckup(transactionId) | 국가 건강검진 결과 조회 / National health checkup results | JSON |
requestCashReceiptDeduction(input) / getCashReceiptDeduction(transactionId) | 현금영수증 소득공제 내역 / Cash receipt income deductions | JSON |
requestTaxReturnHistory(input) / getTaxReturnHistory(transactionId) | 국세 신고내역 조회 / National tax return history | JSON |
requestResidentRegistration(input) / getResidentRegistration(transactionId) | 주민등록표등본 발급 / Resident registration certificate | JSON |
requestResidentRegistrationCho(input) / getResidentRegistrationCho(transactionId) | 주민등록표초본 발급 / Resident registration certificate (cho) | JSON |
requestGov24Bundle(input) / getGov24Bundle(transactionId) | 민원서류 통합 조회 / Selectable civil-document bundle | JSON |
requestIncomeAmountCert(input) / getIncomeAmountCert(transactionId) | 소득금액증명 발급 / Income amount certificate | PDF·JSON |
requestPensionCreditCert(input) / getPensionCreditCert(transactionId) | 연금보험료등 소득세액 공제확인서 발급 / Pension credit certificate | PDF·JSON |
requestFactCert(input) / getFactCert(transactionId) | 납부내역증명(납세사실증명) 발급 / Tax payment fact certificate | PDF·JSON |
requestTaxClearanceCert(input) / getTaxClearanceCert(transactionId) | 납세증명서 발급 / Tax clearance certificate | PDF·JSON |
requestIncomeCertBundle(input) / getIncomeCertBundle(transactionId) | 소득 증빙서류 통합발급 / Income certificate bundle | PDF·JSON |
requestBusinessCertBundle(input) / getBusinessCertBundle(transactionId) | 사업자 증빙서류 통합발급 / Business certificate bundle | PDF·JSON |
requestBusinessRegistrationCert(input) / getBusinessRegistrationCert(transactionId) | 사업자등록증명 발급 / Business registration certificate | PDF·JSON |
requestVatTaxBaseCert(input) / getVatTaxBaseCert(transactionId) | 부가가치세 과세표준증명 발급 / VAT tax base certificate | PDF·JSON |
requestFinancialStatementCert(input) / getFinancialStatementCert(transactionId) | 표준재무제표증명 발급 / Financial statements certificate | PDF·JSON |
requestClosureCert(input) / getClosureCert(transactionId) | 폐업사실증명 발급 / Business closure certificate | PDF·JSON |
searchSkills(options) / getSkill(skillId) | Skill 검색·상세 / Search and inspect Skills | JSON |
getSkillPerformance() | 시험 방법·표본 수·기계 검사·품질 점수 / Measured results and methods | JSON |
quoteSkill(skillId, input, options) | Skill 견적(무료) / Quote a run (free) | JSON |
runSkill(skillId, input, options) | Skill 실행 / Run a Skill | JSON |
getSkillRun(runId) / getSkillRunResult(runId) / cancelSkillRun(runId) | 실행 조회·결과·취소 / Read, fetch result, cancel | JSON |
skillUsage(options) | 내 Skill 실행 내역 / My Skill runs | JSON |
검수를 거친 Skill 을 검색하고 실행합니다. 결과가 약속한 형식으로 반환된 실행만 포인트가 차감되고, 실패·시간초과·취소는 차감되지 않습니다. 생성형 AI 를 쓰는 Skill 은 실행마다 실제 사용량만큼 금액이 달라지므로, 실행 전에 quoteSkill() 로 예상 금액(estimated_points)과 최대 금액(max_points)을 확인하세요. 1회 이상 결제한 계정에서 실행할 수 있습니다.
Search and run reviewed Skills. Points are charged only when a result in the promised format is returned; failures, timeouts and cancellations are not charged. For Skills that use generative AI the amount varies per run with actual usage, so call quoteSkill() first to get the estimated (estimated_points) and maximum (max_points) amount. Running requires an account with at least one payment.
import { randomUUID } from 'node:crypto';
const found = await apick.searchSkills({ query: '상품명', limit: 5 });
const skillId = found.data.items[0].skill_id;
const detail = await apick.getSkill(skillId); // input_schema, output_schema, price_points, estimated_points
const input = { product_name: '튼튼한 접이식 우산' };
const quote = (await apick.quoteSkill(skillId, input)).data; // 무료 / free: estimated_points, max_points
const idempotencyKey = randomUUID(); // 재시도할 때 같은 값을 다시 씁니다 / reuse on retry
let run = (await apick.runSkill(skillId, input, { idempotencyKey, quoteId: quote.quote_id, maxCostPoints: quote.max_points })).data;
while (!['succeeded', 'failed', 'timed_out', 'cancelled'].includes(run.status)) {
await new Promise(resolve => setTimeout(resolve, 2000));
run = (await apick.getSkillRun(run.run_id)).data;
}
console.log(run.status, run.billing, run.result);
검증 결과는 스킬 성능표 또는 const { data } = await apick.getSkillPerformance()로 확인합니다. 표본 수·시험일·방법·기계 검사 통과율과 모델 평가 점수를 함께 읽으세요. 미검증 값은 null이며, 과거의 다른 조건에서 얻은 점수는 legacy로 구분합니다. 모델 점수는 객관적 정확도나 판매 성과 보장이 아닙니다.
See the Skill performance report or call const { data } = await apick.getSkillPerformance(). Read sample sizes, dates, methods, machine checks and model scores together. Unmeasured values are null; historical results under different conditions are in legacy. Model scores are not objective accuracy or sales guarantees.
searchSkills({ sort }) 로 추천(recommended)·인기(popular)·많이 사용(used)·좋아요순(likes)·평점순(rating)·최신(new) 순서를 고르고, 검색·상세 응답의 usage_label(사용 건수 구간)·like_count·review_count·rating_average 로 Skill 을 비교할 수 있습니다.
Pick an order with searchSkills({ sort }) (recommended, popular, used, likes, rating, new) and compare Skills with usage_label (a usage tier), like_count, review_count and rating_average in search and detail responses.
searchSkills({ sort }) 로 추천(recommended)·인기(popular)·많이 사용(used)·좋아요순(likes)·평점순(rating)·최신(new) 순서를 고르고, 검색·상세 응답의 usage_label(사용 건수 구간)·like_count·review_count·rating_average 로 Skill 을 비교할 수 있습니다.
Pick an order with searchSkills({ sort }) (recommended, popular, used, likes, rating, new) and compare Skills with usage_label (a usage tier), like_count, review_count and rating_average in search and detail responses.
Skills 응답은 다른 API 와 달리 봉투 없이 그대로 data 에 담깁니다. 과금 상태는 data.billing(reserved·captured·released…)에서 확인하며 meta.cost 는 채워지지 않습니다. 응답을 받지 못했을 때는 같은 idempotencyKey 로 다시 호출하세요. 포인트는 한 번만 차감됩니다. 같은 키에 다른 입력을 보내면 IDEMPOTENCY_CONFLICT 로 거부됩니다.
Skills responses are returned as-is in data. Read the charge from data.billing; meta.cost is not populated. If a response is lost, call again with the same idempotencyKey — points are charged once. The same key with a different input is rejected with IDEMPOTENCY_CONFLICT.
접수 전에 거절된 요청은 ApickApiError 로 던져지며 serviceCode 에 INVALID_INPUT·INSUFFICIENT_POINTS·PRICE_EXCEEDS_LIMIT·RATE_LIMITED 같은 코드가, details 에 부가 정보가 담깁니다. 접수된 뒤 실패한 실행은 예외가 아니라 status 와 failure_code 로 확인합니다.
Requests rejected before acceptance throw ApickApiError with the code in serviceCode and extra information in details. A run that fails after acceptance is reported through status and failure_code, not an exception.
JSON API는 실제 응답과 과금 메타데이터를 분리해 반환합니다. JSON APIs separate the service result from billing metadata.
const result = await apick.searchAddress('가산디지털로', { page: 1 });
console.log(result.data);
console.log(result.meta);
// { cost: number | null, durationMs: number | null }
품질(quality)별 장당 고정가입니다. basic(기본) 40P, advanced(고급) 350P, premium(최고급) 1,400P이며 크기와 관계없이 같습니다. 같은 요청을 다시 보내도 결과를 재사용하지 않고 매번 새로 생성·과금합니다. 동기는 1~4장, 작업형 API는 최대 50장까지 지원합니다. 요청이 접수되면 전체 금액을 먼저 차감하고, 생성에 실패한 이미지가 있으면 해당 장수만큼 즉시 환급합니다. 접수된 작업은 취소할 수 없으며 결과는 완료 후 24시간 동안 반복 다운로드할 수 있습니다.
Images use a fixed per-image price by quality: basic (default) 40 points, advanced 350 points and premium 1,400 points, regardless of size. Repeated requests are never reused; each request is generated and charged again. Synchronous calls support 1–4 images and job calls support up to 50. The full amount is deducted when a request is accepted, and failed images are refunded immediately. Accepted jobs cannot be cancelled. Completed results remain downloadable for 24 hours.
const made = await apick.generateImages("따뜻한 조명의 미니멀 제품 사진", {
imageCount: 2, size: "1024x1024", outputFormat: "webp", quality: "advanced"
});
const referenced = await apick.generateImages("구도와 제품 형태는 유지하고 여름 해변 분위기로", {
referenceImage: "./reference.png",
referenceFilename: "reference.png",
referenceContentType: "image/png"
});
const edited = await apick.editImages("./source.png", "컵 색상을 파란색으로 변경", {
outputFormat: "png"
});
const queued = await apick.createImageGenerationJob("여행 포스터 시안", { imageCount: 20 });
const job = await apick.getImageJob(queued.data.job_id);
const image = await apick.downloadImageJobImage(job.data.job_id, 0);
await image.save("./result.png");
PNG·JPEG·WebP 출력, 투명 배경 미리보기(PNG/WebP), 5개 표준 크기(1024x1024, 1536x1024, 1024x1536, 1152x864, 864x1152)를 지원합니다. 입력 프롬프트는 최대 28,000자입니다. idempotencyKey는 네트워크 재전송 때 중복 생성과 중복 과금을 막는 8~128자의 요청 식별자이며, 같은 작업을 다시 보낼 때 같은 값을 사용합니다. 자동 재시도는 하지 않습니다.
PNG, JPEG, and WebP outputs, transparent-background previews for PNG/WebP, and five standard sizes are supported. Prompts are limited to 28,000 characters. idempotencyKey identifies the same request during network retransmission to prevent duplicate generation and billing. Requests are never retried automatically.
OCR은 PNG/JPEG 파일 경로, Blob, ArrayBuffer, Uint8Array를 받습니다. 최대 크기는 50MB입니다.
OCR accepts a PNG/JPEG file path, Blob, ArrayBuffer, or Uint8Array, up to 50MB.
const result = await apick.ocr('./receipt.jpg');
console.log(result.data.result.full_text);
브라우저 또는 메모리 데이터:
const result = await apick.ocr(imageBytes, {
filename: 'receipt.png',
contentType: 'image/png'
});
파일을 반환하는 메서드는 ApickBinaryResult를 반환합니다.
Methods producing files return an ApickBinaryResult.
const pdf = await apick.htmlToPdf('<h1>월간 보고서</h1>', {
pagination: true
});
console.log(pdf.contentType, pdf.size, pdf.meta.cost);
await pdf.save('./report.pdf');
const excel = await apick.jsonToExcel(
[{ name: 'Kim', score: 95 }, { name: 'Lee', score: 88 }],
{ sheetName: 'Scores' }
);
await excel.save('./scores.xlsx');
ApickBinaryResult provides bytes, size, filename, contentType, meta, toArrayBuffer(), toBlob(), and save(path).
공간정보 13종(geo*)은 JSON 본문으로 보내므로 주소 목록·좌표 배열·GeoJSON 객체를 그대로 넘깁니다. 좌표는 WGS84 경위도이며 x가 경도, y가 위도입니다. GeoJSON 요청 본문은 1MB 이하여야 합니다.
The 13 geo methods (geo*) send a JSON body, so address lists, coordinate arrays and GeoJSON objects are passed as-is. Coordinates are WGS84 longitude (x) and latitude (y). GeoJSON request bodies must be 1 MB or smaller.
const { data } = await client.geoStandardize('서울특별시 강남구 역삼동 808');
const batch = await client.geoBatchGeocode(['서울특별시 강남구 역삼동 808', '서울특별시 강남구 테헤란로 152']);
const nearby = await client.geoNeighborhood({ address: '서울특별시 강남구 역삼동 808', categories: ['편의점', '약국'], radius: 500 });
vehicleRecall({ carNo })·vehicleRecall({ vin })는 둘 중 하나만 받습니다. 리콜 대상이 아니면(recall_target: false), hipassUnpaid(carNo)는 미납이 없으면(unpaid_target: false) 과금되지 않습니다. vehicleTaxCalc(cc, { carAgeYears })는 비영업용 승용차의 연간 자동차세·지방교육세를 계산합니다.
vehicleRecall takes exactly one of carNo or vin. It is free when the vehicle has no recall (recall_target: false), and hipassUnpaid(carNo) is free when nothing is unpaid (unpaid_target: false). vehicleTaxCalc(cc, { carAgeYears }) calculates the annual tax for a non-commercial passenger car.
등기 열람·발급은 작업형입니다. 검색(registryRealestateSearch·registryCorporateSearch)으로 대상을 확인하고, createRegistry*Job으로 접수한 뒤 getRegistryJob(jobId)으로 상태를 확인하고, 완료되면 downloadRegistryPdf(jobId)로 PDF를 받습니다. 같은 접수를 다시 보낼 때는 같은 idempotencyKey를 넣으세요. 상태 조회는 무료이며 과금·환급 조건은 개발가이드를 따릅니다.
Registry view and issue requests are jobs: confirm the target with a search, submit with createRegistry*Job, poll getRegistryJob(jobId) and download the PDF with downloadRegistryPdf(jobId) once completed. Reuse the same idempotencyKey when resubmitting. Status checks are free; see the developer guide for charges and refunds.
const found = await client.registryRealestateSearch('서울특별시 가상구 가상로 1');
const { data: job } = await client.createRegistryRealestateJob({ query: '서울특별시 가상구 가상로 1', index: 1, idempotencyKey: 'order-1001' });
let state = await client.getRegistryJob(job.job_id);
while (!['completed', 'failed', 'cancelled'].includes(state.data.status)) { await new Promise(r => setTimeout(r, 5000)); state = await client.getRegistryJob(job.job_id); }
if (state.data.status === 'completed') await (await client.downloadRegistryPdf(job.job_id)).save('registry.pdf');
기존 동기 TTS는 종료되었습니다. 한국어 내레이션은 작업을 접수하고 completed가 될 때까지 2~5초 간격으로 상태를 확인한 뒤 MP3 결과를 한 번만 내려받습니다.
The legacy synchronous TTS API has retired. Create a Korean narration job, poll every 2–5 seconds until it is completed, then download the MP3 result once.
Query listGeminiTtsVoices() and listOpenAiTtsVoices() for current voices; legacy TTS_VOICE_IDS are retired.
const created = await apick.createTtsJob('오늘의 이야기를 시작합니다.', {
voiceId: 'Kore'
});
const jobId = created.data.job_id;
let job;
do {
await new Promise(resolve => setTimeout(resolve, 3000));
job = await apick.getTtsJob(jobId);
} while (job.data.status === 'waiting' || job.data.status === 'processing');
if (job.data.status === 'completed') {
const result = await apick.downloadTtsResult(jobId);
await result.save(`./${jobId}.mp3`);
const subtitles = await apick.downloadTtsSubtitles(jobId);
await subtitles.save(`./${jobId}.ass`);
}
접수 시 최대 요금을 예약하고 완료 후 실제 금액을 확정합니다. 연결 종료는 정상 과금하며 명시 취소는 이미 수행한 유료 처리분을 정산합니다. MP3와 ASS 자막은 각각 한 번 완료 다운로드할 수 있고, 전송 중단 시 다시 시도할 수 있습니다.
Submission reserves an upper bound; successful completion settles actual charges. Disconnects do not cancel billing. Explicit cancellation settles work already performed. MP3 and ASS each allow one completed download; interrupted downloads can be retried.
정규화는 기본 켜짐이며 발음을 다듬는 스킬 요금이 추가됩니다. normalize_text: false(SDK normalizeText: false)로 실행과 요금을 끕니다. 스킬 최종가는 기본요금(판매자 금액·기본 수수료) + 실제 AI 사용료입니다. 정규화 실패는 제작을 중단하며, 서버의 최종 제작 실패는 정규화까지 전액 환불합니다. ASS에는 원문을 표시합니다.
Normalization is on by default and adds a skill charge. Set normalize_text: false (SDK normalizeText: false) to skip execution and billing. The skill price is its base fee (seller amount and base commission) plus the actual AI usage fee. Normalization failure stops synthesis; final server/provider failures refund normalization as well. ASS preserves the original spelling.
const resident = await apick.maskResidentNumber('./id-card.jpg', { type: 3 });
await resident.save('./masked.png');
const passport = await apick.maskPassport('./passport.jpg');
console.log(passport.data.result.fields);
maskResidenceCard, maskPassport, maskIdCard, maskDriverLicense는 JSON 결과를 반환합니다. maskResidentNumber는 PNG 바이너리를 반환하며 type은 1, 2, 3, 4 중 하나이며 4는 주민등록번호와 주소를 함께 가립니다.
The four document-specific methods return JSON. maskResidentNumber returns PNG bytes and requires type 1, 2, 3, or 4 (number and address).
maskResidenceCard는 외국인등록증·영주증·외국국적동포 국내거소신고증의 앞면 한 장을 지원합니다. 영주증과 외국국적동포 국내거소신고증 지원은 개인정보 마스킹에만 적용되며 외국인등록증 진위확인 범위는 변경되지 않습니다.
maskResidenceCard accepts one front-side image of a residence card, permanent resident card, or overseas Korean resident card. Permanent and overseas Korean card support is limited to PII masking and does not expand the alien registration card authenticity-check scope.
본인 간편인증이 필요한 조회 상품(재직·소득·연금·면허·건강검진·현금영수증·국세 신고내역·주민등록표 발급·민원서류 통합 조회·세무 민원증명)은 접수(request*)와 결과 조회(get*)가 분리되어 있습니다. 접수 응답의 transactionId로 결과를 폴링하세요.
Products that require the user's own simple-auth verification (employment, income, pension, driver's license, health checkup, cash receipts, tax returns, resident registration certificates, and the Government24 bundle) split the call into a request*() acceptance and a get*() poll. Use the transactionId from the accepted response to poll for the result.
아래 함수는 7종 모두에 공통으로 사용합니다. 같은 transactionId로 순차 조회하며 5→10→20→30초 간격으로 늘린 뒤 30초를 유지합니다. resultAvailable === true이면 즉시 결과를 반환합니다. SUCCESS는 전체 성공, PARTIAL_SUCCESS는 부분 성공이므로 sources에서 누락·실패 항목을 확인하세요. AUTH_REJECTED·AUTH_EXPIRED·FAILED는 실패 종료이며, errorCode: 'RESULT_EXPIRED'는 결과 보관 기간 만료입니다. 실패·만료 시 자동으로 재접수하지 않습니다.
Use this helper for all seven products. Poll sequentially with the same transactionId, waiting 5→10→20→30 seconds and then keeping the 30-second interval. Return the result immediately when resultAvailable === true. SUCCESS means full success; PARTIAL_SUCCESS means partial success, so inspect sources for missing or failed items. AUTH_REJECTED, AUTH_EXPIRED, and FAILED are terminal failures; errorCode: 'RESULT_EXPIRED' means the retained result has expired. Never resubmit automatically after failure or expiry.
async function pollDataResult(getResult, accepted, { timeoutMs = 600_000 } = {}) {
const pending = new Set([
'AUTH_REQUESTED', 'AUTH_WAITING', 'AUTH_COMPLETED', 'COLLECTING', 'COLLECTED'
]);
const failed = new Set(['AUTH_REJECTED', 'AUTH_EXPIRED', 'FAILED']);
const completed = new Set(['SUCCESS', 'PARTIAL_SUCCESS']);
const delays = [5_000, 10_000, 20_000, 30_000];
const deadline = Date.now() + timeoutMs;
const transactionId = accepted.data.transactionId;
const stop = code => { throw Object.assign(new Error(code), { code }); };
let response = accepted;
let attempt = 0;
for (;;) {
const data = response.data;
if (data.errorCode === 'RESULT_EXPIRED') stop('RESULT_EXPIRED');
if (failed.has(data.status)) stop(data.errorCode || data.status);
if (data.resultAvailable === true) {
if (data.result == null) stop('INVALID_RESULT');
return response;
}
if (completed.has(data.status)) stop('RESULT_NOT_AVAILABLE');
if (!pending.has(data.status)) stop('UNKNOWN_STATUS');
const awaitingApproval = ['AUTH_REQUESTED', 'AUTH_WAITING'].includes(data.status);
const authDeadline = Date.parse(data.expiresAt || accepted.data.expiresAt);
const limit = awaitingApproval && Number.isFinite(authDeadline)
? Math.min(deadline, authDeadline) : deadline;
const timeoutCode = awaitingApproval && limit === authDeadline
? 'AUTH_WAIT_TIMEOUT' : 'CLIENT_POLL_TIMEOUT';
const remaining = limit - Date.now();
if (remaining <= 0) stop(timeoutCode);
await new Promise(resolve => setTimeout(resolve,
Math.min(delays[Math.min(attempt++, delays.length - 1)], remaining)));
if (Date.now() >= limit) stop(timeoutCode);
response = await getResult(transactionId);
}
}
AUTH_REQUESTED·AUTH_WAITING은 사용자 승인을 기다리고, AUTH_COMPLETED·COLLECTING·COLLECTED는 결과가 준비될 때까지 계속 조회합니다. 과금 여부(charged, success)는 완료 기준이 아닙니다. 인증 대기에만 expiresAt을 적용하고 승인 후에는 전체 대기 한도를 적용합니다. 예제의 10분 한도는 클라이언트 정책이며, 진행 중인 호출의 제한 시간은 SDK의 timeoutMs로 별도 설정하세요. AUTH_WAIT_TIMEOUT·CLIENT_POLL_TIMEOUT·RESULT_NOT_AVAILABLE·INVALID_RESULT·UNKNOWN_STATUS는 예제에서 만드는 로컬 오류로, 응답 모순이나 알 수 없는 상태에서 무한 반복하지 않습니다. 통신 오류도 재시도 없이 호출자에게 전달합니다.
AUTH_REQUESTED and AUTH_WAITING wait for the user's approval; AUTH_COMPLETED, COLLECTING, and COLLECTED keep polling until a result is available. Billing fields (charged, success) do not indicate completion. Apply expiresAt only while awaiting approval, then use the overall waiting limit. The example's 10-minute limit is a client policy; configure the SDK's timeoutMs separately to bound each in-flight call. AUTH_WAIT_TIMEOUT, CLIENT_POLL_TIMEOUT, RESULT_NOT_AVAILABLE, INVALID_RESULT, and UNKNOWN_STATUS are local example errors that prevent endless polling on inconsistent responses or unknown states. Transport errors propagate without retries.
const accepted = await apick.requestEmployment({
name: '홍길동',
birthDate: '19900101',
phone: '01011112222',
authProvider: 'kakao',
insuranceYears: 3
});
try {
const result = await pollDataResult(id => apick.getEmployment(id), accepted);
if (result.data.status === 'PARTIAL_SUCCESS') console.warn(result.data.sources);
console.log(result.data.result);
} catch (error) {
if ((error.serviceCode || error.code) === 'RESULT_EXPIRED') {
console.error('결과 보관 기간 만료: 사용자 확인 후 새 인증을 요청하세요.');
} else {
throw error;
}
}
const bundle = await apick.requestGov24Bundle({
name: '홍길동',
birthDate: '19900101',
phone: '01011112222',
authProvider: 'kakao',
// 고른 상품만 인증·조회합니다. 등본 80P, 초본 80P로 선택한 상품 단가를 합산합니다.
products: ['resident_registration', 'resident_registration_cho'],
sido: '서울특별시',
sigungu: '구로구'
});
const issued = await pollDataResult(id => apick.getGov24Bundle(id), bundle);
const pdfBase64 = issued.data.result.residentRegistration['발급문서'];
GOV24_BUNDLE_PRODUCTS lists the 13 selectable product keys. Selecting only driving_license (or any non-resident product) does not require sido/sigungu. / GOV24_BUNDLE_PRODUCTS lists the 13 selectable keys; the address is required only when a resident registration certificate is selected.
근거: APICK 개발가이드 · MCP 3.5.0 상태 계약
지원 간편인증 방식(authProvider) 13종은 AUTH_PROVIDERS로 제공됩니다: kakao, naver, toss, pass, samsung, kb, shinhan, hana, woori, ibk, nh, kakaobank, banksalad.
The 13 supported authProvider values are exported as AUTH_PROVIDERS: kakao, naver, toss, pass, samsung, kb, shinhan, hana, woori, ibk, nh, kakaobank, banksalad.
접수 시 정액 과금되고, 결과는 최초 반환에서만 과금되며 재조회는 무료입니다. 결과는 resultExpiresAt까지만 재조회할 수 있고, 그 이후에는 errorCode: 'RESULT_EXPIRED'가 오며 접수부터 다시 시작해야 합니다.
Acceptance is billed at a flat rate; the result is billed only on its first successful return and free to re-poll afterward. The result can be re-fetched until resultExpiresAt; after that errorCode is 'RESULT_EXPIRED' and you must request again from the start.
| 상품 / Product | Request / Get | 선택 입력 / Optional input |
|---|---|---|
| 재직·보험료 확인 / Employment & insurance premium | requestEmployment / getEmployment | insuranceYears (1–3) |
| 금융소득 조회 / Financial income | requestPersonalIncome / getPersonalIncome | incomeYears (1–5) |
| 국민연금 가입내역 / NPS join history | requestNpsJoinHistory / getNpsJoinHistory | from, to (YYYY-MM) |
| 국민연금 소득공제용 납부확인서 / NPS payment certificate | requestNpsDeductionCert / getNpsDeductionCert | years (1–5) |
| 국민연금 경력 이력 / NPS career history | requestNpsCareerHistory / getNpsCareerHistory | from, to (YYYY-MM) |
| 운전면허 조회 / Driver's license | requestDrivingLicense / getDrivingLicense | — |
| 국가 건강검진 결과 / Health checkup | requestHealthCheckup / getHealthCheckup | — |
| 현금영수증 소득공제 내역 / Cash receipt deductions | requestCashReceiptDeduction / getCashReceiptDeduction | incomeYears (1–3) |
| 국세 신고내역 조회 / Tax return history | requestTaxReturnHistory / getTaxReturnHistory | years (1–10) |
| 주민등록표등본 발급 / Resident registration certificate | requestResidentRegistration / getResidentRegistration | sido, sigungu (필수 / required), purposeCd, submitTarget, includeAddressHistory, includeHousehold |
| 주민등록표초본 발급 / Resident registration certificate (cho) | requestResidentRegistrationCho / getResidentRegistrationCho | sido, sigungu (필수 / required), purposeCd, submitTarget, includeAddressHistory, includeHousehold |
| 민원서류 통합 조회 / Selectable civil-document bundle | requestGov24Bundle / getGov24Bundle | products (필수 / required), 등본·초본 선택 시 sido·sigungu (필수 / required when either resident certificate is selected) |
| 소득금액증명 발급 / Income amount certificate | requestIncomeAmountCert / getIncomeAmountCert | year, use_purpose, submit_to, delivery (필수 / required), format, engl_yn, quantity, email, fax_no, wallet_address |
| 연금보험료등 소득세액 공제확인서 발급 / Pension credit certificate | requestPensionCreditCert / getPensionCreditCert | year, use_purpose, submit_to, delivery (필수 / required), format, address_open_yn, resno_open_yn, quantity, email, fax_no, wallet_address |
| 납부내역증명(납세사실증명) 발급 / Tax payment fact certificate | requestFactCert / getFactCert | use_purpose, submit_to, delivery, itrf_cd (필수 / required), year, start_month, end_month, issuance, engl_yn, format |
| 납세증명서 발급 / Tax clearance certificate | requestTaxClearanceCert / getTaxClearanceCert | cert_type(B0006 납세증명서·B0010 해외이주용), use_purpose, submit_to, delivery, itrf_cd (필수 / required), year, start_month, end_month, issuance, format |
| 소득 증빙서류 통합발급 / Income certificate bundle | requestIncomeCertBundle / getIncomeCertBundle | year, use_purpose, submit_to, delivery (필수 / required), format, amount_open_yn, income_source_open_yn, withholding_all_print_yn, address_open_yn, resno_open_yn, quantity, email, fax_no, wallet_address |
| 사업자 증빙서류 통합발급 / Business certificate bundle | requestBusinessCertBundle / getBusinessCertBundle | business_no, year, use_purpose, submit_to, delivery (필수 / required), agreed: true 또는 bind_id (둘 중 하나 필수 / one required), period, engl_yn, format, quantity, email, fax_no, wallet_address |
| 사업자등록증명 발급 / Business registration certificate | requestBusinessRegistrationCert / getBusinessRegistrationCert | business_no, use_purpose, submit_to, delivery (필수 / required), engl_yn, format, quantity, email, fax_no, wallet_address |
| 부가가치세 과세표준증명 발급 / VAT tax base certificate | requestVatTaxBaseCert / getVatTaxBaseCert | business_no, year, use_purpose, submit_to, delivery (필수 / required), period(1·2·all), engl_yn, format |
| 표준재무제표증명 발급 / Financial statements certificate | requestFinancialStatementCert / getFinancialStatementCert | business_no, year, use_purpose, submit_to, delivery (필수 / required), engl_yn, format |
| 폐업사실증명 발급 / Business closure certificate | requestClosureCert / getClosureCert | business_no, use_purpose, submit_to, delivery (필수 / required), engl_yn, format |
세무 민원증명은 발급 1건 60P 정액이고 format 으로 응답을 고릅니다(pdf·json·both, 기본 both). json·both 이면 발급된 PDF를 파싱한 PDF데이터.필드 가 함께 오며, 표 구조에 따라 필드가 비어 있을 수 있습니다. 구조화 값의 정본은 결과 본문(문서확인번호·귀속연도 등)입니다.
Hometax certificates cost a flat 60P per issuance. format selects the response (pdf, json, or both; default both). With json/both the parsed PDF fields arrive in PDF데이터.필드; some fields may be empty depending on the table layout. The structured values in the result body (문서확인번호, 귀속연도, …) are authoritative.
법원 경매사건 조회는 동기 상품입니다. 사건번호는 법원별로 관리되므로 courtAuction(caseNo, court) 처럼 법원(이름 서울중앙지방법원 또는 코드 B000210)을 함께 넘깁니다. 응답에는 사건 기본정보·매각물건·매각기일·배당요구종기가 담기고, 입찰대행·입찰서 작성은 제공하지 않습니다.
Court auction lookup is synchronous. A case number belongs to one court, so pass the court (name such as 서울중앙지방법원 or code such as B000210) together: courtAuction(caseNo, court). The result contains case details, sale items, sale schedule and the dividend claim deadline; bidding assistance and bid form preparation are not provided.
등기·증명서 발급확인 registryDocVerify(issueNo, options) 는 증명서에 인쇄된 발급확인번호 12자리(하이픈·공백 허용)와 문서 종류 options.kind(realestate 기본, corporate, movable)를 받습니다. 응답은 verified·status·message·document·issued_date·registry_office 이며 증명서 원문은 포함되지 않습니다. 발급일로부터 3개월 이내 발급분만 확인됩니다.
registryDocVerify(issueNo, options) verifies the 12-character verification number printed on an issued registration certificate (hyphens and spaces are accepted); options.kind selects realestate (default), corporate or movable. The result carries verified, status, message, document, issued_date and registry_office — never the certificate itself — and only certificates issued within the last three months can be verified.
입찰·부동산 4종은 원본 목록이 아니라 분석 결과를 돌려줍니다. bidNotice(options)·bidAward(options) 는 업무구분·기간·공고번호를 받고 summary·distribution·insights 를, 낙찰은 여기에 competitors·low_rate 를 더합니다. rtmsTrade(lawdCd, dealYmd, options) 는 ㎡당 중위가와 면적·가격·층 분포, 단지별 시세, 직거래·해제 비중, 시세 이탈 거래를, rtmsRent 는 전세 비중, 보증금·월세 분포, 보증금 대비 연월세 비율, 갱신 비중과 같은 단지 매매 대비 전세가율을 계산합니다. items·totalCount 같은 원본 목록은 제공하지 않습니다.
The four bid and real-estate methods return analytics, not raw lists. bidNotice(options) and bidAward(options) take a business type, period or notice number and return summary, distribution and insights; awards add competitors and low_rate. rtmsTrade(lawdCd, dealYmd, options) returns median price per square metre, area/price/floor bands, per-complex medians, direct-deal and cancellation shares and price outliers, while rtmsRent computes jeonse share, deposit and monthly-rent bands, annual rent to deposit ratio, renewal share and the jeonse ratio against same-complex sale prices. Raw lists such as items and totalCount are not returned.
증빙서류 묶음 2종은 휴대폰 승인 한 번으로 담긴 증명을 함께 발급합니다. 소득 묶음은 소득금액증명·연금보험료등 소득세액 공제확인서(결과 result.incomeAmountCert·result.pensionCreditCert), 사업자 묶음은 사업자등록증명·부가가치세 과세표준증명·표준재무제표증명(결과 result.businessRegistrationCert·result.vatTaxBaseCert·result.financialStatementCert)입니다. 접수 20P, 최초 결과는 84P·126P로 개별 발급 합계보다 30% 쌉니다. 사업자 묶음은 대표자 본인 확인을 받으므로 agreed: true 또는 이전 응답의 bind_id(같은 계정·같은 사업자등록번호, 90일)를 보내야 하며, 빠지면 SDK가 호출 전에 TypeError 를 던집니다. 일부 증명만 발급되면 status 가 PARTIAL_SUCCESS 이고 결과 단가는 그대로 청구됩니다.
The two certificate bundles issue every included certificate after a single phone approval. Acceptance is 20P and the first result is 84P (income) or 126P (business), 30% below issuing each certificate separately. The business bundle requires representative consent: send agreed: true or a bind_id from a previous response (same account and business number, valid for 90 days); the SDK throws a TypeError before calling the server when both are missing. If only some certificates are issued, status is PARTIAL_SUCCESS and the bundle result price still applies.
const bundle = await client.requestBusinessCertBundle({
name: '홍길동', birthDate: '19900101', phone: '01011112222', authProvider: 'kakao',
business_no: '1234567890', year: '2025', period: 'all',
use_purpose: '99', submit_to: '99', delivery: '06', format: 'json', agreed: true
});
const issued = await pollDataResult(id => client.getBusinessCertBundle(id), bundle);
const { businessRegistrationCert, vatTaxBaseCert, financialStatementCert } = issued.data.result;
import { ApickApiError } from 'apick-api';
try {
await apick.whois('invalid value');
} catch (error) {
if (error instanceof ApickApiError) {
console.error(error.code, error.serviceCode, error.status, error.message);
}
}
오류 코드는 APICK_AUTH_ERROR, APICK_TIMEOUT, APICK_NETWORK_ERROR, APICK_INVALID_RESPONSE, APICK_API_ERROR 중 하나입니다.
Error codes are one of APICK_AUTH_ERROR, APICK_TIMEOUT, APICK_NETWORK_ERROR, APICK_INVALID_RESPONSE, and APICK_API_ERROR.
신분증 서비스의 상세 오류 코드는 선택적 serviceCode에 보존됩니다. Identity-specific service errors are exposed through optional serviceCode.
APICK_API_KEY 사용을 권장합니다.MIT — see LICENSE. Use of the APICK service is governed by the APICK terms.
Omitting version preserves Seedance 2.5, Veo 3.1 and Kling 3.0. Set version and tier explicitly to select a generation; jobs are never silently switched to another version. Submission and status responses include version.
Available generations: Seedance 1.0/1.5/2.0/2.5, including Seedance 2.0 Standard/Fast/Mini; Veo 3.1 (Standard/Fast/Lite); Kling 1.6/2.0/2.1/2.5/2.6/3.0/O1/O3. Veo 3.0 is unavailable. Modes, tiers, resolutions, durations, audio, file limits and prices vary by combination. See the Seedance, Veo and Kling version tables. Unsupported combinations are rejected before submission.
Seedance reference mode accepts referenceImages, referenceVideos, and referenceAudios (MP3/WAV) when supported by the selected version.
version을 생략하면 Seedance 2.5, Veo 3.1, Kling 3.0을 사용합니다. 버전과 등급을 명시하면 해당 조합으로 생성하며 다른 모델로 자동 대체하지 않습니다. 생성과 상태 응답의 version으로 확인할 수 있습니다.
| 제품 | 제공 버전 | 제약과 요금 |
|---|---|---|
| Seedance | 2.5, 2.0(Standard·Fast·Mini), 1.5, 1.0 | 버전별 지원표 |
| Veo | 3.1 (Standard, Fast, Lite) | 버전별 지원표 |
| Kling | 3.0, O3, O1, 2.6, 2.5, 2.1, 2.0, 1.6 | 버전별 지원표 |
등급·해상도·길이·오디오·파일 개수와 초당 포인트는 선택 조합별로 다릅니다. Seedance 2.0은 Standard·Fast·Mini를 제공하며 Mini는 480p·720p와 4~15초를 지원합니다. 무음 전용 모델은 audio=false, 오디오 필수 모델은 audio=true만 허용합니다. Veo 3.0은 현재 제공하지 않습니다. 지원하지 않는 조합은 접수 전에 거절됩니다.
Seedance 참조 소재 모드는 지원 버전에서 referenceImages, referenceVideos, referenceAudios(MP3·WAV)를 함께 사용할 수 있습니다.
const job = await client.createVideoJob("kling", "A boat crossing the sea", {
version: "1.6", tier: "std", mode: "text", duration: 5, audio: false,
idempotencyKey: "boat-video-0001"
});
const status = await client.getVideoJob("kling", job.data.job_id);
if (status.data.status === "completed") {
await (await client.downloadVideoResult("kling", job.data.job_id)).save("boat.mp4");
}
getSkillArtifact(runId, fileId) returns authenticated binary artifacts. 가격·시간·호출 수 범위와 다운로드 예제: 스킬 파일 가이드 / guide.
설치형 apick-agent 상품은 apick-subagent 스킬 패키지와 전용 REST·MCP를 사용합니다. 설치비·도입비·구독료 없이 성공한 작업만 사용량대로 정산(소수점 올림, 2026-11-06부터 AI 사용 작업 기본 5P), 승인된 동일 결과 캐시 1P, 충전 잔액 외 상품 한도 없음. 연동 가이드.
The installed apick-agent product uses the apick-subagent skill package and dedicated REST/MCP interfaces. No installation, setup or subscription fee. Successful work is billed by actual usage (fractions rounded up, 5-point base fee for AI jobs from 2026-11-06); approved identical cache reuse costs 1 point, with no product quota beyond prepaid balance. Integration guide.
npx -y apick-mcp --server subagent
# Local workspace collection / 로컬 파일 수집
npm install -g apick-subagent
apick-subagent install
Set APICK_API_KEY in the environment. 원격 MCP는 업로드된 자료를 처리합니다. The remote MCP processes uploaded content; the installed bridge collects local files.
TTS: Gemini·ChatGPT·정규화 / engines and normalization. createOpenAiTtsJob, listOpenAiTtsVoices, getTtsOptions를 포함한 최신 계약입니다.
차명에 등급·연식·좌석을 함께 넣을 수 있습니다(파나메라 gts 4인승 19년식, PANAMERA GTS 19년). 입력한 연식·등급을 우선하며 좌석 수는 확인 가능한 차량 사양과 일치해야 합니다. 근접 연식을 선택하면 반환 연식과 안내를 확인하세요. 지정 등급을 찾지 못하거나 확신이 낮으면 제원 없이 무료 후보만 반환하며, 유사 차량이 전혀 없으면 없음 오류로 응답하고 과금하지 않습니다. 별도 연식·등급과 문장 조건이 충돌하면 입력 오류입니다.
Put the model, trim, year and seat count in model (for example, PANAMERA GTS 19년). Matching prioritizes the supplied year and trim, and the seat count must be identifiable and consistent with the available specification. Check the returned year and notice when a nearby year is selected. Unmatched trims and low-confidence matches return suggestions without specifications or charges; no similar vehicle returns a no-result error without charging. Conflicting explicit and free-text constraints are rejected.
await client.vehicleModelInfo({ model: "파나메라 gts 4인승 19년식" });
차량정보는 공백·대소문자가 다른 동일 등급을 우선해 찾으며 연식·사양이 다른 차량은 구분합니다. 기존 안내에서 연식·사양 대체, 사양 충돌, 국내 출시 여부 확인 보류, 일부 제원의 추가 검증 상태를 확인할 수 있습니다. 국내 미출시가 확인된 차량은 해외 자료 기준이며 100% 정확성을 보장하지 않는다는 안내가 추가됩니다. 반환된 연식·등급과 안내를 확인하세요. 입력·응답 구조와 과금 방식은 유지됩니다.
Vehicle information prioritizes the same trim across spacing and case variations while distinguishing model years and specifications. The existing 안내 notice can describe year/specification substitutions, conflicting specifications, unverified Korean-market availability, or specifications still under review. Confirmed non-Korean-market vehicles receive an additional notice that overseas data does not guarantee 100% accuracy. Check the returned year, trim and notices. Request/response shapes and billing behavior remain unchanged.
FAQs
Official zero-dependency Node.js client for APICK data, AI, and image APIs. 에이픽 데이터·AI·이미지 API 공식 Node.js SDK.
The npm package apick-api receives a total of 368 weekly downloads. As such, apick-api popularity was classified as not popular.
We found that apick-api demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Threat Research
/Security News
Socket uncovered secret-stealing workflows that ran in LiteLLM’s GitHub repository 11 days before the supply chain attack on PyPI and Docker.
Security News
Cloudflare introduces tsrs, a Rust port of TypeScript’s compiler promising faster checks and lower memory use, with the TypeScript team’s help.
Security News
The PHP Foundation says Chainguard broke a security embargo ahead of critical RCE patches, as leaks disrupted the coordinated release.