CreateDecodeBlindWatermarkTask - - Centre de documentation Alibaba Cloud

Extrait un filigrane invisible.

Description de l'opération

Avant d'utiliser cette API, assurez-vous de bien comprendre les méthodes de facturation et la tarification d'Intelligent Media Management (IMM).
Important L'achèvement des tâches asynchrones dans un délai précis n'est pas garanti.
Assurez-vous qu'un projet est créé dans IMM. Pour plus d'informations, consultez Créer un projet.
Assurez-vous que la région de service et le projet sont les mêmes que ceux utilisés pour ajouter le filigrane invisible via l'opération EncodeBlindWatermark. Sinon, le filigrane ne pourra pas être extrait.
Le filigrane peut être extrait même après que l'image a subi des attaques telles que la compression, la mise à l'échelle, le recadrage et les modifications de couleur.
Cette API est compatible avec la version précédente de la fonctionnalité de filigrane invisible. Certains paramètres proviennent de l'API DecodeBlindWatermark précédente.
Il s'agit d'une API asynchrone. Une fois qu'une tâche démarre, ses informations ne sont conservées que pendant 7 jours. Passé ce délai, les informations ne peuvent plus être récupérées. Appelez l'API GetTask ou ListTasks pour récupérer le TaskId et consulter les informations de la tâche. Vous pouvez également définir le paramètre Notification pour recevoir les informations de la tâche via des messages de notification asynchrones.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

imm:CreateDecodeBlindWatermarkTask

create

*Project

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ProjectName	string	Oui	Le nom du projet. Pour savoir comment obtenir le nom du projet, consultez Créer un projet. Important Le nom du projet doit être identique à celui utilisé pour ajouter le filigrane invisible avec l'opération EncodeBlindWatermark. Sinon, le filigrane ne pourra pas être extrait.	immtest
SourceURI	string	Oui	L'URI Object Storage Service (OSS) de l'image. L'URI OSS doit être au format `oss://<bucket>/<object>`. `<bucket>` est le nom du compartiment OSS qui se trouve dans la même région que le projet actuel. `<object>` est le chemin complet du fichier, y compris l'extension du nom de fichier.	oss://target/sampleobject.jpg
StrengthLevel	string	Non	Le niveau d'extraction du filigrane, qui contrôle la précision de l'extraction. Un niveau plus élevé indique un temps de traitement plus long et un meilleur effet d'extraction. Valeurs valides : low medium high	low
WatermarkType	string	Non	Le type de filigrane intégré. Valeur valide : text (Les filigranes d'image ne sont pas pris en charge. Par conséquent, ce paramètre ne peut être défini que sur text.) Valeurs valides : text : text.	text
TargetURI	string	Non	Un paramètre de l'ancienne API DecodeBlindWatermark. Il spécifie l'URI OSS où l'image est enregistrée après l'analyse du filigrane invisible. L'URI OSS doit être au format `oss://<bucket>/<object>`. `<bucket>` est le nom du compartiment OSS qui se trouve dans la même région que le projet actuel. `<object>` est le chemin complet du fichier, y compris l'extension du nom de fichier.	oss://target/targetobject.jpg
ImageQuality	integer	Non	Un paramètre de l'ancienne API DecodeBlindWatermark. Il spécifie la qualité de l'image de sortie. La valeur par défaut est 90. La valeur doit être comprise entre 70 et 100. Une qualité supérieure entraîne une taille d'image plus importante et une meilleure qualité d'analyse du filigrane.	90
Model	string	Non	Un paramètre de l'ancienne API DecodeBlindWatermark. Il spécifie le modèle d'algorithme de filigrane. Les valeurs valides incluent FFT, FFT_FULL, DWT et DWT_IBG. La valeur par défaut est FFT. Si ce paramètre est laissé vide, la nouvelle version de la fonctionnalité de filigrane invisible est utilisée. Sinon, c'est l'ancienne version qui est utilisée. Valeurs valides : DWT : DWT. FFT_FULL : FFT_FULL. FFT : FFT. DWT_IBG : DWT_IBG.	FFT
OriginalImageURI	string	Non	Un paramètre de l'ancienne API DecodeBlindWatermark. Il spécifie l'URI OSS de l'image avant l'ajout du filigrane invisible. Ce paramètre n'est pas requis lorsque Model est défini sur DWT ou DWT_IBG. L'URI OSS doit être au format `oss://<bucket>/<object>`. `<bucket>` est le nom du compartiment OSS qui se trouve dans la même région que le projet actuel. `<object>` est le chemin complet du fichier, y compris l'extension du nom de fichier.	oss://imm-test/testcases/watermarktestbefore.jpg
Notification	Notification	Non	La configuration des notifications. Pour plus d'informations, cliquez sur Notification. Pour connaître le format des messages de notification asynchrones, consultez Format des messages de notification asynchrones.

Éléments de réponse

Élément	Type	Description	Exemple
	object	Paramètres de réponse.
RequestId	string	L'identifiant de la requête.	4A7A2D0E-D8B8-4DA0-8127-EB32C6600ADE
EventId	string	L'identifiant de l'événement.	27C-1jyAP5qQI7RoI8lFFwvMrWtl0ft
TaskId	string	L'identifiant de la tâche.	DecodeBlindWatermark-78ac8f3b-59e0-45a6-9b67-32168c3f22b9

Exemples

JSON format

{
  "RequestId": "4A7A2D0E-D8B8-4DA0-8127-EB32C6600ADE",
  "EventId": "27C-1jyAP5qQI7RoI8lFFwvMrWtl0ft",
  "TaskId": "DecodeBlindWatermark-78ac8f3b-59e0-45a6-9b67-32168c3f22b9"
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.