API 개발가이드 – 인증키 발급부터 첫 호출까지

계정 정보로 연결 확인

POST/rest/info

Bearer 인증
추가 폼 항목 없음
JSON 응답

요청 예제

printf '%s\r\n' '--apick-empty--' | curl --fail-with-body --request POST 'https://apick.app/rest/info' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --header 'Content-Type: multipart/form-data; boundary=apick-empty' \
  --data-binary @-

printf '%s\r\n' '--apick-empty--' | curl --fail-with-body --request POST 'https://apick.app/rest/info' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --connect-timeout 10 --max-time 120 \
  --header 'Content-Type: multipart/form-data; boundary=apick-empty' \
  --data-binary @-

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

const form = new FormData();
const response = await fetch("https://apick.app/rest/info", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);

const form = new FormData();
const response = await fetch("https://apick.app/rest/info", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
if (result.error || result.data?.error || result.result?.error || result.success === false || result.api?.success === false) {
  throw new Error(JSON.stringify(result));
}
console.log(result);

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

import os
import requests
response = requests.request("POST", "https://apick.app/rest/info",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"], "Content-Type": "multipart/form-data; boundary=apick-empty"},
    data=b"--apick-empty--\r\n",
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)

import os
import requests
response = requests.request("POST", "https://apick.app/rest/info",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"], "Content-Type": "multipart/form-data; boundary=apick-empty"},
    data=b"--apick-empty--\r\n",
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
if result.get("error") or (isinstance(result.get("data"), dict) and result["data"].get("error")) or (isinstance(result.get("result"), dict) and result["result"].get("error")) or result.get("success") is False or (result.get("api") or {}).get("success") is False:
    raise RuntimeError(result)
print(result)

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

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$headers[] = "Content-Type: multipart/form-data; boundary=apick-empty";
$form = "--apick-empty--\r\n";
$curl = curl_init('https://apick.app/rest/info');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$headers[] = "Content-Type: multipart/form-data; boundary=apick-empty";
$form = "--apick-empty--\r\n";
$curl = curl_init('https://apick.app/rest/info');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
if (!empty($result["error"]) || !empty($result["data"]["error"]) || !empty($result["result"]["error"]) || ($result["success"] ?? true) === false || ($result["api"]["success"] ?? true) === false) {
    throw new RuntimeException($body);
}
print_r($result);

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

응답 예시200

{
  "data": {
    "email": "developer@example.com",
    "point": 0,
    "last_login": "2026-01-01T09:00:00+09:00",
    "is_active": true,
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 0,
    "ms": 10,
    "pl_id": 0
  }
}

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

공통 주소 https://apick.app에 요청합니다. 추가 폼 항목 없이 Bearer 키로 계정 정보를 조회합니다.

이 요청은 무료 연결 확인용이라 마이페이지 시작하기 탭의 첫 성공 표시에는 나타나지 않습니다. 데이터를 받는 첫 호출은 사업자 정보 조회처럼 서비스 API로 확인하세요.

헤더

값

Authorization

Bearer $APICK_API_KEY

응답에 개인정보·계정 정보가 포함될 수 있으므로 서버 로그에 전체 응답을 남기지 마세요. 계정 정보 응답 명세 보기 →

응답을 읽는 순서

HTTP 상태전송·인증·입력 오류
api.successAPI 처리 여부
data서비스별 업무 결과
api.cost이번 요청의 과금

응답 형식은 서비스에 따라 JSON 또는 파일이며, 지원하는 AI 서비스에서는 스트리밍도 사용할 수 있습니다.

요청 본문은 multipart/form-data로 전송합니다. 응답은 서비스에 따라 JSON 또는 파일이며, AI 대화는 SSE 응답도 지원합니다. 첨부 파일과 생성 결과의 보관·다운로드 조건은 서비스마다 다릅니다. 각 문서의 결과 보관 기간과 재다운로드 조건을 확인하세요. 에이픽 API 서비스 중 일부는 최초 1회 이상 결제시 사용 가능합니다. 해당 목록은 아래 표를 통해 확인할 수 있습니다. 가입 포인트로 OCR 3회, 음성 합성(TTS) 1회(300자 이하)를 체험할 수 있습니다. 그 뒤에는 최초 1회 결제 후 이용하세요.

시작하기

시작 전 준비

3단계로 첫 호출

첫 요청 보내기

계정 정보로 연결 확인

응답을 읽는 순서

요청·인증 규칙

공통 오류

인증·포인트 오류 result.error 문구

폼 입력 오류 error.code

필요한 API 찾기

요금·공통 정책

최소 1회 이상 결제시 사용 가능한 API 목록(무료 포인트로 사용 불가능)

공통 API 주소

공통 인증 방식

Header

파일을 돌려주는 API

Response Header

자주 묻는 질문

개발가이드 검색

AI•LLM

전체상품

API 체험하기

요금정책

고객지원

개발가이드