リクエストとレスポンスの例
これらの例を使って統合の実装とデバッグを行ってください
HTTP リクエスト例
POST https://{your-api-domain}/cleanup
ヘッダー:
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を使用することで、これまで以上に簡単になりました。わずか数行のコードで、この技術をアプリケーションに組み込むことができます。
1
パッケージを購入
API専用のパッケージを購入
2
API メールを受信
購入完了から 2 時間以内に、専用の API ドメインと AppCode が記載されたメールが届きます。
3
コードサンプルを使用
以下のコードサンプルを使用してすぐに始める
4
パラメータを調整
パラメータリファレンスに戻ってリクエストを調整
認証
専用の API ドメインとアカウントごとの Bearer トークンを使用してリクエストを認証します。API パッケージを購入後、専用の API ドメインとトークンをメールでお送りします。セキュリティ上の理由から、API トークンを公開しないでください。
API エンドポイント
POST https://{your-api-domain}/cleanup
{your-api-domain} を、購入後にメールでお送りする API ドメインに置き換えてください。各開発者には専用のドメインとトークンが割り当てられます。
ヘッダー
認証:
Bearer {YOUR_API_TOKEN}
{YOUR_API_TOKEN} を、メールでお送りする Bearer トークンに置き換えてください。秘密として安全に保管し、公開リポジトリにはコミットしないでください。
コンテンツタイプ:
application/json; charset=UTF-8
コード例
コードサンプルで素早く始める
#!/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"リクエストパラメータ
これらのパラメータでAPIリクエストを設定
| パラメータ | タイプ | 説明 |
|---|---|---|
| media_id | string | 画像のBase64エンコード値、最長辺が4000pxを超えないこと；プレフィックス data:image/png;base64 を削除 |
| keep_distortion | boolean | false – 歪みを自動補正、true – 補正を無効化 |
| keep_ori | boolean | false – 画像は正しい向きに回転されます、true – アップロード時の向きを保持 |
エラーコード
API応答コードのリファレンス
| エラーコード | エラーメッセージ | 説明 |
|---|---|---|
| 0 | success | 成功 |
| 1000 | body error | リクエストボディエラー |
| 1001 | param error | リクエストパラメータエラー |
| 1002 | content type error | Content-Typeエラー |
| 1003 | image not exists | 画像ファイルが見つかりません |
| 1004 | image size error | 画像サイズエラー |
| 1005 | image format error | 画像形式エラー |
| 1006 | invalid signature | 無効な署名 |
| 1007 | body size error | ボディサイズエラー |
| 1008 | no authorization | 認証失敗 |
| 2000 | server unknown error | サーバー不明エラー |
| 2001 | server timeout | サーバータイムアウト |
| 2003 | no content recognition | コンテンツが認識されませんでした |
| 2004 | validate data error | 検証データエラー |
| 3000 | remote server error | リモートサーバーエラー |
| 4000 | base server error | ベースサーバーエラー |
API料金プラン
以下のプランはAPI専用です
スターター
$99$0.198 / クレジット
500クレジット
3ヶ月有効
- ほとんどの画像形式をサポート
- 文書の補正と強化
- 文書からの手書き削除
- 画像のモアレパターン除去
最も人気
人気
$349$0.07 / クレジット
5,000クレジット
6ヶ月有効
- ほとんどの画像形式をサポート
- 文書の補正と強化
- 文書からの手書き削除
- 画像のモアレパターン除去
ビジネス
$749$0.05 / クレジット
15,000クレジット
1年有効
- ほとんどの画像形式をサポート
- 文書の補正と強化
- 文書からの手書き削除
- 画像のモアレパターン除去
専用
エンタープライズ
$1999$0.04 / クレジット
50,000クレジット
1年有効
- ほとんどの画像形式をサポート
- 文書の補正と強化
- 文書からの手書き削除
- 画像のモアレパターン除去