すべてのプロダクト
Search
ドキュメントセンター

Intelligent Media Management:EncodeBlindWatermark

最終更新日:Feb 26, 2026

ブラインドウォーターマークとして、特定のテキスト情報をイメージに埋め込みます。このウォーターマークは視覚的に認識できず、イメージの美観や元データの完全性には影響しません。ウォーターマークは、CreateDecodeBlindWatermarkTask 操作を使用して抽出できます。

操作説明

  • この操作を呼び出す前に、Intelligent Media Management (IMM) の課金についてよく理解していることを確認してください。

  • IMM プロジェクトが作成されていることを確認してください。プロジェクトの作成方法の詳細については、「CreateProject」をご参照ください。

  • イメージにブラインドウォーターマークとして埋め込むことができるのはテキストのみです。

  • 出力イメージのフォーマットは、入力イメージのフォーマットと同じです。

  • 圧縮、スケーリング、トリミング、色変換などの攻撃がイメージに対して行われた場合でも、ブラインドウォーターマークは抽出できます。

  • 純粋な白黒イメージおよび低解像度 (約 200 px × 200 px 未満) のイメージはサポートされていません。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

imm:EncodeBlindWatermark

none

*Project

acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ProjectName

string

必須

プロジェクトの名前。詳細については、「CreateProject」をご参照ください。

test-project

SourceURI

string

必須

イメージの Object Storage Service (OSS) URI です。

oss://${Bucket}/${Object} のフォーマットで値を指定します。${Bucket} は、現在のプロジェクトと同じリージョンにある OSS バケットの名前を指定します。${Object} は、拡張子を含むオブジェクトのパスを指定します。

サポートされているイメージフォーマット:JPG、PNG、BMP、TIFF、WebP。

イメージサイズの制限:最大 10,000 px、最小 80 px x 80 px。

oss://test-bucket/test-object.jpg

TargetURI

string

必須

OSS 内の出力イメージの URI です。

oss://${Bucket}/${Object} のフォーマットで URI を指定します。ここで、${Bucket} は現在のプロジェクトと同じリージョンにあるバケットの名前で、${Object} は拡張子を含むオブジェクトのパスです。

説明
  • 出力イメージのフォーマットは入力イメージのフォーマットと同じです。

oss://test-bucket/target-object.jpg

Content

string

任意

ウォーターマークのテキストコンテンツ。最大 256 文字までです。

阿里云版权所有

StrengthLevel

string

任意

ウォーターマークの強度レベル。強度が高いほど、ウォーターマーク付きのイメージは攻撃に対する耐性が高くなりますが、イメージの歪みは大きくなります。デフォルト値:low。有効な値:[low, medium, high]。

列挙値:

  • high :

    high

  • low :

    low

  • medium :

    medium

low

ImageQuality

integer

任意

このパラメーターは、入力イメージのフォーマットが JPG の場合にのみ有効です。

ウォーターマークを含む出力イメージのストレージ品質。デフォルト値:90。有効な値:70~100。品質が高いほど、イメージサイズが大きくなり、ウォーターマークの解像度品質も高くなります。

90

レスポンスフィールド

フィールド

説明

object

レスポンスのスキーマ

RequestId

string

リクエスト ID。

8E0DD64B-28C6-4653-8FF7-93E4C234BCF0

成功レスポンス

JSONJSON

{
  "RequestId": "8E0DD64B-28C6-4653-8FF7-93E4C234BCF0"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。