Ultra Model do złożonych stron. Lepsze czyszczenie dla trudniejszych dokumentów.

Usuwanie ręcznego pisma
API

Usuń ręczne pismo z dowolnego obrazu za pomocą 1 wywołania API

Dokumentacja API

Przejdź do szczegółów integracji lub sprawdź publiczny schemat OpenAPI.

OpenAPI JSON

Przykłady żądań i odpowiedzi

Użyj tych przykładów do budowania i debugowania integracji

Przykładowe żądanie HTTP

POST https://{your-api-domain}/cleanup
Nagłówki:
  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
}

Przykładowe odpowiedzi

Pomyślna odpowiedź

Gdy żądanie jest prawidłowe i obraz został pomyślnie przetworzony, API zwraca code = 0 i przetworzony obraz zakodowany w Base64.

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8

{
  "code": 0,
  "data": {
    "data": {
      "mediaId": "<BASE64_PROCESSED_IMAGE>"
    }
  },
  "message": "Success"
}

Odpowiedź błędu biznesowego

Gdy usługa upstream zgłasza błąd biznesowy, API zwraca error = "API_ERROR" i kod różny od zera. Możesz zmapować ten kod za pomocą tabeli kodów błędów poniżej.

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."
}

Wprowadzenie do API

Technologia sztucznej inteligencji specjalizująca się w usuwaniu ręcznego pisma została ułatwiona bardziej niż kiedykolwiek dzięki API RemoveHandwriting.com. Za pomocą zaledwie kilku linii kodu możesz wprowadzić tę technologię do swojej aplikacji.

1

Kup pakiet

Kup pakiet dedykowany dla API

2

Otrzymaj e-mail z API

W ciągu 2 godzin od zakupu otrzymasz e-mail z dedykowaną domeną API i AppCode.

3

Użyj przykładów kodu

Użyj następujących przykładów kodu, aby szybko zacząć

4

Dostosuj parametry

Wróć do referencji parametrów, aby dostosować żądanie

Uwierzytelnianie

Uwierzytelniamy żądania za pomocą dedykowanej domeny API i tokenu Bearer na konto. Po zakupie pakietu API wyślemy Ci e-mailem unikalną domenę API i token. Ze względów bezpieczeństwa proszę nie publikować tokenu API.

Punkt końcowy API

POST https://{your-api-domain}/cleanup

Zastąp {your-api-domain} domeną API, którą wyślemy Ci e-mailem po zakupie. Każdy deweloper ma dedykowaną domenę i token.

Nagłówki

Autoryzacja:
Bearer {YOUR_API_TOKEN}
Zastąp {YOUR_API_TOKEN} tokenem Bearer, który wyślemy Ci e-mailem. Trzymaj go w tajemnicy i nigdy nie commituj do publicznych repozytoriów.
Typ treści:
application/json; charset=UTF-8

Przykłady kodu

Szybko zacznij z naszymi przykładami kodu

#!/usr/bin/env bash

set -euo pipefail

# Domain and token for the image processing proxy
API_DOMAIN="https://{your-api-domain}"
API_PATH="/cleanup"
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"

Parametry żądania

Skonfiguruj żądania API za pomocą tych parametrów

ParametrTypOpis
media_idstringWartość obrazu zakodowana w Base64, z najdłuższym bokiem nie przekraczającym 4000px; usuń prefiks data:image/png;base64
keep_distortionbooleanfalse – automatycznie koryguje zniekształcenia, true – wyłącza korekcję
keep_oribooleanfalse – obraz zostanie obrócony do prawidłowej orientacji, true – zachowuje orientację przy przesłaniu

Kody błędów

Referencja dla kodów odpowiedzi API

Kod błęduKomunikat błęduOpis
0successSukces
1000body errorBłąd treści żądania
1001param errorBłąd parametru żądania
1002content type errorBłąd Content-Type
1003image not existsNie znaleziono pliku obrazu
1004image size errorBłąd rozmiaru obrazu
1005image format errorBłąd formatu obrazu
1006invalid signatureNieprawidłowy podpis
1007body size errorBłąd rozmiaru treści
1008no authorizationAutoryzacja nie powiodła się
2000server unknown errorNieznany błąd serwera
2001server timeoutPrzekroczono limit czasu serwera
2003no content recognitionNie rozpoznano treści
2004validate data errorBłąd danych walidacji
3000remote server errorBłąd serwera zdalnego
4000base server errorBłąd serwera bazowego

Plany cenowe API

Następujące plany są wyłączne dla API

Startowy

$99$0.198 / Kredit
500 kredytów
3-miesięczna ważność
  • Obsługuje większość formatów obrazów
  • Korekta i ulepszanie dokumentów
  • Usuwanie ręcznego pisma z dokumentów
  • Usuwanie wzoru moiré z obrazów
Najpopularniejszy

Popularny

$349$0.07 / Kredit
5,000 kredytów
6-miesięczna ważność
  • Obsługuje większość formatów obrazów
  • Korekta i ulepszanie dokumentów
  • Usuwanie ręcznego pisma z dokumentów
  • Usuwanie wzoru moiré z obrazów

Biznesowy

$749$0.05 / Kredit
15,000 kredytów
1-roczna ważność
  • Obsługuje większość formatów obrazów
  • Korekta i ulepszanie dokumentów
  • Usuwanie ręcznego pisma z dokumentów
  • Usuwanie wzoru moiré z obrazów
Ekskluzywny

Korporacyjny

$1999$0.04 / Kredit
50,000 kredytów
1-roczna ważność
  • Obsługuje większość formatów obrazów
  • Korekta i ulepszanie dokumentów
  • Usuwanie ręcznego pisma z dokumentów
  • Usuwanie wzoru moiré z obrazów

Dlaczego deweloperzy ufają naszemu API

Zbudowane dla obciążeń produkcyjnych, nasze API do usuwania ręcznego pisma równoważy jakość, wydajność i koszty, dzięki czemu możesz na nim polegać w rzeczywistych aplikacjach.

Niezawodność gotowa do produkcji

Wysoka dostępność i stabilna wydajność dostosowana do rzeczywistego ruchu.

Zoptymalizowane pod kątem ręcznego pisma

Modele skupione na dokumentach, notatkach i formularzach z ręcznie pisanym tekstem dla bardziej spójnych wyników.

Przewidywalna, wyłącznie API cena

Dedykowane plany API z jasnymi kosztami na kredyt dla długoterminowych integracji.

Wsparcie, gdy go potrzebujesz

Wsparcie e-mailowe, aby pomóc w diagnozowaniu problemów i poprawie integracji w czasie.