API 요청
/rest/nsfw_detection요청 파라미터 2개 · 필수 1
imagedetail응답 필드 9개
datadata.nsfw_scoredata.successdata.detailapiapi.successapi.costapi.msapi.pl_id이미지 한 장이 선정적·폭력적인(NSFW) 이미지일 가능성을 0~1 점수로 돌려줍니다.
https://apick.app/rest/nsfw_detection왜 선정적인 컨텐츠(NSFW) 탐지인가
유해 이미지가 한 번 노출되면 앱 마켓 경고와 이용자 이탈이 동시에 옵니다. 업로드된 이미지가 선정적·폭력적인지 판별해 검수 인력이 밤새 지켜보지 않아도 걸러내게 합니다.
REQUEST_TOO_LARGE 오류가 반환되며 과금되지 않습니다.
게시판·리뷰·프로필 사진처럼 사용자가 올리는 이미지를 게시 전에 걸러낼 때 사용합니다. PNG·JPEG·WEBP·BMP 이미지를 받습니다.
점수를 어디서 끊을지는 서비스 성격에 맞춰 정하세요. 예를 들어 0.8 이상은 자동 차단, 0.4~0.8은 관리자 검토, 그 미만은 게시처럼 구간을 나누면 오탐을 줄일 수 있습니다. 실제 운영 이미지 몇십 장으로 점수 분포를 먼저 확인한 뒤 기준을 정하는 것을 권장합니다.
성공한 건당 10P입니다. 실패·시간 초과 응답은 과금되지 않습니다.
/rest/nsfw_detectionimagedetaildatadata.nsfw_scoredata.successdata.detailapiapi.successapi.costapi.msapi.pl_idPOST https://apick.app/rest/nsfw_detectionAuthorization: Bearer 내 계정의 API 인증키multipart/form-data상황별로 보내는 값과 응답에서 확인할 값을 모았습니다. 언어 탭에서 그대로 복사해 쓸 수 있습니다.
게시 전에 점수만 받아 자동 차단·검토·게시를 나눕니다.
/rest/nsfw_detectioncurl --fail-with-body --request POST 'https://apick.app/rest/nsfw_detection' \
--header "Authorization: Bearer $APICK_API_KEY" \
--form 'image=@./upload.jpg'import { readFile } from "node:fs/promises";
const form = new FormData();
form.append("image", new Blob([await readFile("./upload.jpg")]), "upload.jpg");
const response = await fetch("https://apick.app/rest/nsfw_detection", {
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);import os
import requests
parts = [
("image", ("upload.jpg", open("./upload.jpg", "rb"))),
]
response = requests.request("POST", "https://apick.app/rest/nsfw_detection",
headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
files=parts,
timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
'image' => new CURLFile('./upload.jpg'),
];
$curl = curl_init('https://apick.app/rest/nsfw_detection');
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);data.nsfw_score가 정한 기준 이상이면 차단하거나 관리자 검토로 보내세요(예: 0.8 이상 차단, 0.4~0.8 검토).검토 화면에 근거를 함께 보여 주려면 detail=1을 보냅니다.
/rest/nsfw_detectioncurl --fail-with-body --request POST 'https://apick.app/rest/nsfw_detection' \
--header "Authorization: Bearer $APICK_API_KEY" \
--form 'image=@./upload.jpg' \
--form-string 'detail=1'import { readFile } from "node:fs/promises";
const form = new FormData();
form.append("image", new Blob([await readFile("./upload.jpg")]), "upload.jpg");
form.append("detail", "1");
const response = await fetch("https://apick.app/rest/nsfw_detection", {
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);import os
import requests
parts = [
("image", ("upload.jpg", open("./upload.jpg", "rb"))),
("detail", (None, "1")),
]
response = requests.request("POST", "https://apick.app/rest/nsfw_detection",
headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]},
files=parts,
timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$form = [
'image' => new CURLFile('./upload.jpg'),
'detail' => '1',
];
$curl = curl_init('https://apick.app/rest/nsfw_detection');
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);data.detail에 세부 판정 값이 담깁니다. 차단 기준은 data.nsfw_score로 판단하세요.HTTP 성공과 업무 결과를 구분하세요. 경로별 응답 필드와 예시는 위 요청과 응답에 함께 있습니다.
{
"data": {
"nsfw_score": 0.128645,
"success": 1
},
"api": {
"success": true,
"cost": 10,
"ms": 60,
"pl_id": 25759686
}
}0~1. 1에 가까울수록 선정적·폭력적일 가능성이 높습니다.detail=1로 요청했을 때만 포함되는 세부 판정 값입니다. nsfw_score도 함께 들어 있습니다. 판정에는 nsfw_score를 기준으로 쓰세요.1: 성공(과금), 0: 실패, 3: 시간 초과(과금 없음).응답을 아래 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.
data.error(사유 문구)와 data.success=0을 돌려줍니다. HTTP 상태는 사유에 따라 400·404·408·424 중 하나입니다.api.cost는 0이며 과금되지 않습니다. data.error 문구를 그대로 기록하고 사용자에게 보여 주세요.{
"data": {
"error": "입력값을 확인해 주세요.",
"success": 0
},
"api": {
"success": true,
"cost": 0,
"ms": 5
}
}실패하면 data.error에 문구가 담기고 api.cost는 0입니다.
image로 보냈는지 확인하세요.data.success가 3입니다. 잠시 후 다시 요청하세요.FORM_DATA_INVALIDFORM_DATA_FIELD_CONFLICTMULTIPART_LIMIT_OR_PARSE_ERROR실제 차감 금액은 응답의 api.cost로 확인하세요. 상세 요금은 요금정책에서 볼 수 있습니다.
같은 요청을 JavaScript와 Python으로 옮긴 예시입니다. 키는 환경변수 APICK_API_KEY 에서 읽습니다.