Skip to main content
このガイドでは、Anti-AI 保護注文を作成する手順を説明します — 画像のアップロードから保護された結果のダウンロードまでです。 このドキュメントのすべてのエンドポイントは純粋な HTTPS と JSON 通信であるため、サーバーだけでなくブラウザからも同じように呼び出せます。各ステップには React タブが含まれており、コピー&ペーストしてそのまま使える完全なコンポーネントはページ下部で確認できます。

事前準備

  • BIZ MORI API キー(こちらから発行
  • 保護する画像ファイル(jpegjpgpngwebptiff、または bmp

ステップ1: 注文の作成

注文を作成し、S3 にファイルをアップロードするためのプリサインド URL を受け取ります。
ファイルをアップロードする代わりに、画像 URL を直接指定することもできます。URL モードの詳細については、Anti-AI 注文作成 API を参照してください。
レスポンス:

ステップ2: ファイルのアップロード

ステップ1のレスポンスの uploadUrl にファイルを PUT アップロードします。Authorization ヘッダーは不要です — S3 への直接アップロードです。
プリサインド URL は 1時間 後に失効します。失効した場合は、URL の再発行 エンドポイントを使用して新しい URL を取得してください。

ステップ3: 注文の確認

すべてのファイルのアップロードが完了したら、処理を開始するために注文を確認します:

ステップ4: 注文ステータスの確認

注文ステータスをポーリングするか、Webhook を設定して処理完了の通知を受け取ります。
レスポンス:
注文ステータスの流れ:

ステップ5: 結果のダウンロード

ステータスが complete になったら、ダウンロード URL を取得します:
レスポンス:
url7日間 有効なプリサインド S3 URL です。この URL から保護されたファイルを直接ダウンロードしてください。 Anti-AI API でサポートされているオプションの詳細については、API リファレンスを参照してください。

React 完全なサンプル

上記すべてを1つのコンポーネントにまとめました:複数ファイルのアップロード、ファイルごとのアップロード進捗、バックオフ付きポーリング、ダウンロードリンクまでを含みます。React 以外の依存関係はありません。
AntiAiUploader.jsx
import.meta.env.VITE_MORI_API_TOKEN は Vite の構文です。Next.js では process.env.NEXT_PUBLIC_MORI_API_TOKEN を使用するか、使用中のバンドラーがクライアントコードに公開する方式に従ってください。crypto.randomUUID() はセキュアコンテキストでのみ動作します。HTTPS と localhost では問題ありませんが、通常の HTTP の LAN アドレスでは使用できません。

エラー処理

エラーコードの一覧は、エラーコード ページを参照してください。

次のステップ

不可視 watermark の埋め込み

画像に不可視 watermark を埋め込みます。

不可視 watermark の抽出

画像から不可視 watermark を検出・抽出します。

AI Detection

AI 生成画像を確率スコアで検出します。

Webhook

処理完了時に通知を受け取るために Webhook を設定します。