Skip to main content
このガイドでは、画像に不可視 watermark を埋め込む手順を説明します — 注文の作成から、watermark が埋め込まれた結果のダウンロードまでです。 この API のすべてのエンドポイントは純粋な HTTPS と JSON で動作するため、サーバーからでもブラウザからでも同じように呼び出せます。各ステップには React タブが含まれており、そのままコピーして使える完全なコンポーネントはページ下部にあります。

事前準備

  • BIZ MORI API キー(こちらから発行
  • 不可視 watermark を埋め込むファイル(jpegjpgpngwebptiffbmp、または pdf

ステップ1: 注文の作成

watermark テキストを指定して、不可視 watermark 埋め込み注文を作成します。
レスポンス:

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

ステップ1のレスポンスの uploadUrl にファイルを PUT アップロードします。Authorization ヘッダーは不要です — S3 への直接アップロードです。
別途、確認(confirm)ステップは必要ありません。 Anti-AI や AI Detection サービスとは異なり、不可視 watermark の埋め込みはファイルのアップロードが完了すると自動的に処理が開始されます。アップロード後はそのまま注文ステータスを確認してください。
プリサインド URL は 1時間 後に失効します。失効した場合は、URL の再発行 エンドポイントを使用して新しい URL を取得してください。

ステップ3: 注文ステータスの確認と結果のダウンロード

注文ステータスをポーリングするか、Webhook を設定して処理完了の通知を受け取ります。
レスポンス:
ステータスが complete になったら、ダウンロード URL を取得します:
レスポンス:
url7日間 有効なプリサインド S3 URL です。 不可視 watermark 埋め込み API でサポートされているオプションの詳細については、API リファレンスを参照してください。

React 完全なサンプル

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

エラー処理

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

次のステップ

Anti-AI

画像を AI 学習および生成から保護します。

不可視 watermark の抽出

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

AI Detection

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

Webhook

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