요청 및 응답 예제
이 예제들을 사용해 통합을 구현하고 디버깅하세요
HTTP 요청 예제
POST https://{your-api-domain}/sjccup
헤더:
Authorization: Bearer {YOUR_API_TOKEN}
Content-Type: application/json; charset=UTF-8
Body:
{
"media_id": "<BASE64_IMAGE_WITHOUT_PREFIX>",
"keep_distortion": false,
"keep_ori": true
}응답 예제
성공 응답
요청이 유효하고 이미지가 성공적으로 처리된 경우, API 는 code = 0 과 Base64 로 인코딩된 처리된 이미지를 반환합니다.
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{
"code": 0,
"data": {
"data": {
"mediaId": "<BASE64_PROCESSED_IMAGE>"
}
},
"message": "Success"
}비즈니스 오류 응답
업스트림 서비스에서 비즈니스 오류를 보고하는 경우, API 는 error = "API_ERROR" 와 0이 아닌 code 를 반환합니다. 아래 오류 코드 표를 사용해 이 코드를 매핑할 수 있습니다.
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=UTF-8
{
"error": "API_ERROR",
"code": 1004,
"message": "Image size error. Please ensure the image is less than 5MB and the longest side is less than 4000px."
}API 소개
손글씨 제거에 특화된 인공지능 기술이 RemoveHandwriting.com API를 사용하여 그 어느 때보다 쉬워졌습니다. 몇 줄의 코드만으로 이 기술을 애플리케이션에 통합할 수 있습니다.
패키지 구매
API 전용 패키지 구매
API 이메일 수신
구매 완료 후 2시간 이내에 전용 API 도메인과 AppCode가 포함된 이메일을 받게 됩니다.
코드 샘플 사용
다음 코드 샘플을 사용하여 빠르게 시작하기
매개변수 조정
매개변수 참조로 돌아가서 요청 조정
인증
전용 API 도메인과 계정별 Bearer 토큰을 사용해 요청을 인증합니다. API 패키지 구매 후, 전용 API 도메인과 토큰을 이메일로 보내드립니다. 보안상의 이유로 API 토큰을 공개하지 마세요.
API 엔드포인트
{your-api-domain} 값을 구매 후 이메일로 전달되는 API 도메인으로 교체하세요. 각 개발자는 전용 도메인과 토큰을 부여받습니다.
헤더
코드 예제
코드 샘플로 빠르게 시작하기
#!/usr/bin/env bash
set -euo pipefail
# Domain and token for the image processing proxy
API_DOMAIN="https://{your-api-domain}"
API_PATH="/sjccup"
API_TOKEN="{YOUR_API_TOKEN}"
# Image file passed as first argument (default: testpaper.jpg)
IMAGE_FILE="${1:-testpaper.jpg}"
if [ ! -f "$IMAGE_FILE" ]; then
echo "Image file not found: $IMAGE_FILE" >&2
echo "Usage: $0 path/to/image.jpg" >&2
exit 1
fi
echo "Encoding image to Base64: $IMAGE_FILE"
# Encode image to Base64 and remove newlines (use -i for BSD base64 on macOS)
BASE64_IMAGE=$(base64 -i "$IMAGE_FILE" | tr -d '
')
echo "Building JSON body..."
read -r -d '' JSON_BODY <<EOF || true
{
"media_id": "$BASE64_IMAGE",
"keep_distortion": false,
"keep_ori": true
}
EOF
echo "Calling proxy API..."
curl -X POST "${API_DOMAIN}${API_PATH}" \
-H "Authorization: Bearer ${API_TOKEN}" \
-H "Content-Type: application/json; charset=UTF-8" \
-d "$JSON_BODY" \
-o response.json \
-s -w "\nHTTP status: %{http_code}\n"
echo "Response saved to response.json"요청 매개변수
이 매개변수로 API 요청 구성
| 매개변수 | 유형 | 설명 |
|---|---|---|
| media_id | string | 이미지의 Base64 인코딩 값, 가장 긴 변이 4000px를 초과하지 않음; 접두사 data:image/png;base64 제거 |
| keep_distortion | boolean | false – 왜곡 자동 보정, true – 보정 비활성화 |
| keep_ori | boolean | false – 이미지가 올바른 방향으로 회전됨, true – 업로드 시 방향 유지 |
오류 코드
API 응답 코드 참조
| 오류 코드 | 오류 메시지 | 설명 |
|---|---|---|
| 0 | success | Success |
| 1000 | body error | Request body error |
| 1001 | param error | Request parameter error |
| 1002 | content type error | Content-Type error |
| 1003 | image not exists | Image file not found |
| 1004 | image size error | Image size error |
| 1005 | image format error | Image format error |
| 1006 | invalid signature | Invalid signature |
| 1007 | body size error | Body size error |
| 1008 | no authorization | Authorization failed |
| 2000 | server unknown error | Server unknown error |
| 2001 | server timeout | Server timeout |
| 2003 | no content recognition | No content recognized |
| 2004 | validate data error | Validation data error |
| 3000 | remote server error | Remote server error |
| 4000 | base server error | Base server error |
API 가격 플랜
다음 플랜은 API 전용입니다
스타터
- 대부분의 이미지 형식 지원
- 문서 보정 및 향상
- 문서 손글씨 제거
- 이미지 모아레 패턴 제거
- 처리 속도 약 2초
인기
- 대부분의 이미지 형식 지원
- 문서 보정 및 향상
- 문서 손글씨 제거
- 이미지 모아레 패턴 제거
- 처리 속도 약 2초
비즈니스
- 대부분의 이미지 형식 지원
- 문서 보정 및 향상
- 문서 손글씨 제거
- 이미지 모아레 패턴 제거
- 처리 속도 약 2초
엔터프라이즈
- 대부분의 이미지 형식 지원
- 문서 보정 및 향상
- 문서 손글씨 제거
- 이미지 모아레 패턴 제거
- 처리 속도 약 2초
개발자가 우리 API를 신뢰하는 이유
프로덕션 워크로드를 위해 구축된 손글씨 제거 API로, 품질, 성능 및 비용의 균형을 맞춰 실제 앱에서 안심하고 사용할 수 있습니다.
프로덕션 준비 완료된 안정성
실제 트래픽에 맞춰 조정된 높은 가용성과 안정적인 성능.
손글씨에 최적화
손으로 쓴 텍스트가 포함된 문서, 메모 및 양식에 초점을 맞춘 모델로 더 일관된 결과 제공.
예측 가능한 API 전용 가격
장기 통합을 위한 명확한 크레딧당 비용이 있는 전용 API 플랜.
필요할 때 받는 지원
문제를 진단하고 시간이 지남에 따라 통합을 개선하는 데 도움이 되는 이메일 지원.