リクエストとレスポンスの例
これらの例を使用して統合を構築およびデバッグ
サンプルHTTPリクエスト
POST https://{your-api-domain}/forgery_detection
ヘッダー:
Authorization: Bearer {YOUR_API_TOKEN}
Content-Type: application/json; charset=UTF-8
Body:
{
"image": "<BASE64_IMAGE_WITHOUT_PREFIX>",
"return_heatmap": "false",
"detect_proportion": "false",
"restrict_probability": "0.8"
}サンプルレスポンス
成功レスポンス
リクエストが有効で画像の処理に成功すると、API は detection_result を返し、画像が改ざん済み（fake）か真正（real）かを示します。必要に応じて改ざん信頼度、ヒートマップ、位置座標も返します。
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{
"code": 0,
"data": {
"detection_result": "fake",
"tampered_proportion": 0.000587,
"heatmap": "<BASE64_HEATMAP_IMAGE>",
"tampered_location": [
{
"left": 100,
"top": 200,
"width": 150,
"height": 100,
"probability": 0.95
}
]
},
"message": "Success"
}ビジネスエラーレスポンス
アップストリームサービスがビジネスエラーを報告すると、APIはエラー = "API_ERROR"とゼロ以外のコードを返します。以下のエラーコードテーブルを使用してこのコードをマッピングできます。
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 紹介
偽造検出に特化した人工知能技術は、ImgAuth.com APIを使用することで、これまで以上に簡単になりました。わずか数行のコードで、この技術をアプリケーションに組み込むことができます。
API クレジットを選択
統合量に合った API クレジットパッケージを選択します
API アクセスを取得
購入後、アカウントダッシュボードで API キーとエンドポイントを確認できます
コードサンプルを使用
以下のコードサンプルを使用して迅速に開始
本番運用へ移行
使用量を監視し、リクエストパラメータを調整して本番運用を開始します
認証
アカウントの API エンドポイントと Bearer トークンでリクエストを認証します。API クレジット購入後、ダッシュボードでエンドポイントとトークンを確認できます。トークンは秘密にし、公開リポジトリにコミットしないでください。
APIエンドポイント
{your-api-domain} をアカウントダッシュボードに表示される API エンドポイントに置き換えてください。
ヘッダー
コード例
コードサンプルで迅速に開始
#!/usr/bin/env bash
set -euo pipefail
API_DOMAIN="https://{your-api-domain}"
API_PATH="/forgery_detection"
API_TOKEN="{YOUR_API_TOKEN}"
IMAGE_FILE="${1:-testpaper.jpg}"
BASE64_IMAGE=$(base64 -i "$IMAGE_FILE" | tr -d '
')
read -r -d '' JSON_BODY <<EOF || true
{
"image": "$BASE64_IMAGE",
"return_heatmap": "false",
"detect_proportion": "false",
"restrict_probability": "0.8"
}
EOF
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"リクエストパラメータ
これらのパラメータでAPIリクエストを設定
| パラメータ | タイプ | 説明 |
|---|---|---|
| image | string | Base64 エンコードされた画像データを URL エンコードして渡します。最大 10 MB。短辺は 512 px 以上、長辺は 8192 px 以下。jpg/jpeg/png/bmp をサポート。image または url のいずれかを指定してください。 |
| url | string | 完全な画像 URL。長さは 1024 バイト以下。エンコード後の画像サイズは 10 MB 以内。短辺は 512 px 以上、長辺は 8192 px 以下。jpg/jpeg/png/bmp をサポート。image または url のいずれかを指定し、ホットリンク保護は無効にしてください。 |
| return_heatmap | string | 改ざんヒートマップを返すかどうか。デフォルトは false。true で Base64 ヒートマップを返し、false で返しません。 |
| detect_proportion | string | 改ざん信頼度を返すかどうか。デフォルトは false。true で信頼度を返し、false で返しません。 |
| restrict_probability | string | 改ざん座標を返すしきい値。範囲は 0.1 から 1、少数 1 桁、デフォルトは 0.8。probability がしきい値以上の場合のみ tampered_location を返します。 |
レスポンスパラメータ
API レスポンス項目のリファレンス
| パラメータ | 型 | 説明 |
|---|---|---|
| detection_result | string | 改ざん判定結果。"fake" は改ざんを検出、"real" は改ざんなしを示します。 |
| tampered_proportion | float | 改ざん信頼度スコア。detect_proportion = true の場合に返されます。 |
| heatmap | string | 改ざん領域の Base64 ヒートマップ。return_heatmap = true の場合に返されます。 |
| tampered_location | array | probability が restrict_probability 以上の場合に返される可疑領域座標の配列。各項目には left、top、width、height、probability が含まれます。 |
| left | uint32 | 可疑領域の左上頂点の水平座標。 |
| top | uint32 | 可疑領域の左上頂点の垂直座標。 |
| width | uint32 | 可疑領域の幅。 |
| height | uint32 | 可疑領域の高さ。 |
| probability | float | この可疑領域の信頼度スコア。 |
エラーコード
APIレスポンスコードのリファレンス
| エラーコード | エラーメッセージ |
|---|---|
| 0 | success |
| 1000 | body error |
| 1001 | param error |
| 1002 | content type error |
| 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 message は本番レスポンスと一致するよう、上流の生の値をそのまま表示しています。
API料金プラン
単発クレジットより割安です。継続利用ではサブスクリプションが最も低コストです。
Developer
評価と初期統合に最適
- Bearer トークン認証
- 改ざん判定、信頼度、ヒートマップ、領域座標を返却
- 文書や画像の改ざんレビュー向けワークフローに対応
- 購入後にダッシュボードで API エンドポイントとトークンを確認可能
Growth
本番パイロットと安定した利用に最適
- Bearer トークン認証
- 改ざん判定、信頼度、ヒートマップ、領域座標を返却
- 文書や画像の改ざんレビュー向けワークフローに対応
- 購入後にダッシュボードで API エンドポイントとトークンを確認可能
Scale
バッチ処理や複数プロジェクトのチームに最適
- Bearer トークン認証
- 改ざん判定、信頼度、ヒートマップ、領域座標を返却
- 文書や画像の改ざんレビュー向けワークフローに対応
- 購入後にダッシュボードで API エンドポイントとトークンを確認可能
Business
長期的な本番ワークロードに最適
- Bearer トークン認証
- 改ざん判定、信頼度、ヒートマップ、領域座標を返却
- 文書や画像の改ざんレビュー向けワークフローに対応
- 購入後にダッシュボードで API エンドポイントとトークンを確認可能
開発者が当社のAPIを信頼する理由
本番環境のワークロード向けに構築された、当社の偽造検出APIは、品質、パフォーマンス、コストのバランスを取り、実際のアプリケーションで信頼できるようになっています。
本番環境対応の信頼性
実際のトラフィックに最適化された高可用性と安定したパフォーマンス。
偽造検出に最適化
より一貫した結果を得るために、改ざん検出機能を備えた文書、証明書、請求書に焦点を当てたモデル。
予測可能な、API専用の料金
長期的な統合のための明確なクレジットあたりのコストを持つ専用APIプラン。
必要な時にサポート
問題の診断と統合の改善を支援するメールサポート。
1 API クレジット = 1 API リクエスト。API 価格は単発クレジットパックより低く、継続利用ではサブスクリプションが最もお得です。