リクエストとレスポンスの例
これらの例を使って統合の実装とデバッグを行ってください
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を使用することで、これまで以上に簡単になりました。わずか数行のコードで、この技術をアプリケーションに組み込むことができます。
1
パッケージを購入
API専用のパッケージを購入
2
API メールを受信
購入完了から 2 時間以内に、専用の API ドメインと AppCode が記載されたメールが届きます。
3
コードサンプルを使用
以下のコードサンプルを使用してすぐに始める
4
パラメータを調整
パラメータリファレンスに戻ってリクエストを調整
認証
専用の API ドメインとアカウントごとの Bearer トークンを使用してリクエストを認証します。API パッケージを購入後、専用の API ドメインとトークンをメールでお送りします。セキュリティ上の理由から、API トークンを公開しないでください。
APIエンドポイント
POST https://{your-api-domain}/sjccup
{your-api-domain} を、購入後にメールでお送りする API ドメインに置き換えてください。各開発者には専用のドメインとトークンが割り当てられます。
ヘッダー
Authorization:
Bearer {YOUR_API_TOKEN}
{YOUR_API_TOKEN} を、メールでお送りする Bearer トークンに置き換えてください。秘密として安全に保管し、公開リポジトリにはコミットしないでください。
Content-Type:
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="/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専用です
スターター
$99$0.198 / クレジット
500クレジット
3ヶ月有効
- ほとんどの画像形式をサポート
- 文書の補正と強化
- 文書からの手書き削除
- 画像のモアレパターン除去
- 処理速度 約2秒
最も人気
人気
$349$0.07 / クレジット
5,000クレジット
6ヶ月有効
- ほとんどの画像形式をサポート
- 文書の補正と強化
- 文書からの手書き削除
- 画像のモアレパターン除去
- 処理速度 約2秒
ビジネス
$749$0.05 / クレジット
15,000クレジット
1年有効
- ほとんどの画像形式をサポート
- 文書の補正と強化
- 文書からの手書き削除
- 画像のモアレパターン除去
- 処理速度 約2秒
Exclusive
エンタープライズ
$1999$0.04 / クレジット
50,000クレジット
1年有効
- ほとんどの画像形式をサポート
- 文書の補正と強化
- 文書からの手書き削除
- 画像のモアレパターン除去
- 処理速度 約2秒