Add Watermark
Apply a text or image watermark to a single image.
POST /api/free/watermarkAdd Watermarkをオンラインで使用
API キーなしでアップロード、設定、プレビュー、ダウンロードできます。
ログイン・API キー不要
1. アップロードと設定
API キーなしで利用できます。ファイルは実行時にのみ送信されます。
Source image *
Watermark image
Watermark text
Position
Opacity
Font size
Text color
必須項目を入力すると実行できます。POST /api/free-online/watermark
2. プレビューとダウンロード
結果はここに表示されます
プレビュー、サイズ変化、ダウンロード操作を表示します
API で連携
API キーが必要なのはプログラムからの呼び出しだけです。パラメータ、レスポンス、エラーを以下にまとめています。
API エンドポイント
POST /api/free/watermarkオンライン利用はキー不要です。プログラムからの呼び出しには APIAny キーが必要です。
仕組み
- Provide watermarkImage for image watermark or text for text watermark.
- Returns a PNG image response.
レスポンス
成功時は、このページに記載した Content-Type の image レスポンスを返します。
主なエラー
- 400
- ファイルやパラメータが不足、不正、または制限外です。
- 401
- プログラム呼び出しのキーがない、無効、または停止済みです。
- 429
- オンラインまたは認証済みの共有上限に達しました。
パラメータと制限
| パラメータ | 要件 | 既定値 | 利用可能な値 |
|---|---|---|---|
imageSource image | 必須 | — | file |
watermarkImageWatermark image | 任意 | — | file |
textWatermark text | 任意 | — | text |
positionPosition | 任意 | bottom-right | top-left, top-right, bottom-left, bottom-right, center |
opacityOpacity | 任意 | 0.5 | number |
fontSizeFont size | 任意 | 32 | number |
colorText color | 任意 | #ffffff | text |
API の例
以下はコード用の認証例です。上の Playground は API キーを要求・表示しません。
curl -X POST "https://apiany.ai/api/free/watermark" \ -H "Authorization: Bearer $API_KEY" \ -F "image=@input.png" \ -F "text=APIAny" \ -F "position=bottom-right" \ --output watermarked.png
よくある質問
Add Watermark に API キーは必要ですか?
オンライン Playground では不要です。プログラムからは Authorization: Bearer または X-API-Key を使います。
Add Watermark の制限は?
オンラインは毎分 3 回、1 日 30 回です。認証済み無料アカウントは 5 RPM、有料アカウントは全無料 API 合計で 500 RPM です。
Add Watermark が受け付ける入力は?
パラメータ表の必須・任意項目を使用してください。未対応形式や範囲外の値は拒否されます。
Add Watermark は何を返しますか?
成功時は image レスポンス、失敗時は上記の HTTP ステータスを返します。
出典:APIAny 無料 API カタログと実際のルート動作。確認日:2026-07-17。