Demande et utilisation de l'API QR Code artistique

Le QR Code artistique est un produit technologique innovant qui combine des QR codes avec des images de fond esthétiques, créant ainsi des œuvres à la fois pratiques et attrayantes. Ils possèdent non seulement la fonctionnalité des QR codes traditionnels, pouvant être rapidement scannés et reconnus par des appareils intelligents, mais intègrent également des éléments artistiques, renforçant ainsi l’attrait visuel et la reconnaissance de la marque. Certains QR codes artistiques sont même générés par intelligence artificielle, tirant pleinement parti des technologies modernes pour montrer une innovation et une unicité sans précédent. Cela permet aux QR codes artistiques d’avoir une large application dans des domaines tels que le marketing de marque et la promotion publicitaire. En termes simples, le QR Code artistique est la combinaison parfaite entre le scan de QR code et l’esthétique artistique, offrant non seulement une fonction de transmission d’informations, mais améliorant également l’expérience visuelle de l’utilisateur, rendant chaque scan plein de plaisir artistique.

Aperçu des œuvres

Voyons d’abord quelques œuvres QR Code :

Qu’en pensez-vous ? Ces QR codes sont des QR codes artistiques, ils réalisent la combinaison parfaite entre image et QR code, étant plus artistiques que les QR codes ordinaires. Et surtout, chaque QR code peut être scanné !

Comment créer ?

Vous souhaitez créer un tel QR code ? Comment créer un QR Code artistique comme celui-ci ? En fait, d’un point de vue technique, c’est relativement complexe. À l’ère de l’IA actuelle, la solution pour les QR codes artistiques est basée sur Stable Diffusion. En entrant un prompt, nous pouvons générer l’image correspondante, tout en intégrant certains contenus de QR code pour finalement réaliser cet effet. Ainsi, le principal défi ici est : comment rendre le QR code à la fois esthétique et artistique, tout en permettant un scan correct. Pour être honnête, cette technologie est en fait assez difficile, nécessitant de nombreux ajustements de paramètres pour obtenir un résultat légèrement meilleur. Environ 99 % des gens abandonnent à la première étape. Supposons qu’après de nombreux ajustements, nous ayons vraiment obtenu un tel effet, le fonctionnement réel représente également un coût non négligeable. Si l’on veut une vitesse relativement rapide, il faut probablement un GPU performant, ce qui peut facilement coûter des milliers d’euros. Certains amis pourraient dire : je ne veux pas dépenser autant d’énergie, je ne veux pas dépenser autant d’argent, je veux juste faire un QR code artistique, ou je veux intégrer cette capacité dans mon produit, ce serait bien d’avoir une API prête à l’emploi. Y en a-t-il une ? En fait, oui. Cette plateforme propose une API de génération de QR codes artistiques. Nous pouvons appeler l’API en entrant divers paramètres, tels que le contenu de l’image, le lien du QR code, le style, etc., et il est très facile de générer le QR code artistique souhaité, et la première demande offre 20 créations gratuites.

Demande d’API

Pour utiliser l’API QR Code artistique, vous pouvez d’abord vous rendre sur la page API QR Code artistique et cliquer sur le bouton « Obtenir » :

Si vous n’êtes pas encore connecté, vous serez automatiquement redirigé vers la page de connexion. Scannez le code pour suivre le compte public et vous serez automatiquement connecté, sans étapes d’inscription supplémentaires. Une fois connecté, vous serez redirigé vers la page d’origine, où il sera indiqué « Vous n’avez pas encore demandé ce service, vous devez faire une demande ». Lors de la demande, une vérification de l’authentification réelle sera effectuée, veuillez suivre les instructions du site pour compléter l’authentification. L’authentification vérifiera le nom, le numéro de téléphone et le numéro d’identité. Une fois l’authentification terminée, vous pouvez revenir à la page, rafraîchir pour vous assurer que les informations sont mises à jour, puis faire une nouvelle demande.

Utilisation de base

Pour utiliser les fonctionnalités de base du QR Code artistique, vous devez remplir les paramètres obligatoires suivants :

type : le type de QR code, comme texte brut, lien, etc.
content : le contenu du QR code, par exemple, si c’est un lien, nous pouvons entrer le lien correspondant.
prompt : l’instruction de style pour le QR code, il est fortement recommandé d’utiliser l’anglais. Par exemple, pizza dessinera un QR code ressemblant à une pizza.
callback_url : optionnel, adresse de rappel asynchrone, fournie, elle renverra immédiatement l’ID de la tâche.
content_image_url : optionnel, lien de l’image contenant le contenu réel du QR code.
aspect_ratio : optionnel, rapport largeur/hauteur de la toile, par défaut 1:1.
ecl : niveau de correction d’erreur, par défaut H.
qrw : poids du QR code, 1.5-3, plus il est grand, plus il se rapproche du QR code réel.
seed : graine aléatoire fixe, générant un QR code reproductible.
steps : nombre d’itérations de dessin, 10-20, par défaut 16.
preset : style de fond prédéfini.
pattern : style principal, par défaut custom.
position : position du QR code, par défaut center.
marker_shape : forme du point de localisation, par défaut square.
sub_marker : forme du point de localisation auxiliaire, par défaut square.
pixel_style : style pixel, par exemple square, rounded, dot.
padding_level/padding_noise : intensité de l’espace blanc et du bruit.
rotate : angle de rotation, par défaut 0.
rawurl : conserver le lien original ou non, par défaut false, activé, il ne fait pas de lien court.

Ensuite, nous allons générer un QR code pour le site officiel de Zhishuyun, le type est un lien, le contenu est https://data.zhishuyun.com, le prompt ici est le suivant :

(best quality, masterpiece:1.2), underwater, ((pirate ship)), close up, zoom in, absurdes, big waves, twister, water falling, tentacles, ((glowing lights)), ((lighting storm)), fog, smoke, 4k res, 8k, higly detailed textures, cinematic shot, intricate details, side view

Remplissez les informations suivantes sur la page de test :

Puis cliquez sur tester :

Après un moment, vous verrez que le QR code artistique a été généré, le résultat est similaire à ceci :

{
  "task_id": "a7e8831c-203d-447e-83fc-71783c766446",
  "image_url": "https://qrart.cdn.zhishuyun.com/attachments/1132182283529494652/1136344944630563006/Germey_2023-08-02__64ca8da51e5834b500e077bf.png",
  "image_width": 768,
  "image_height": 768
}

Le code QR est comme suit :

Ainsi, nous avons généré un code QR, dont le sujet est un bateau, arborant plusieurs drapeaux, et ces drapeaux constituent précisément les points de localisation du code QR. En scannant avec un téléphone, vous pouvez accéder au site officiel de Zhishuyun. En même temps, le contenu ci-dessus peut être facilement transformé en appel API.

Guide de prompt

À travers les opérations ci-dessus, on peut voir que la clé de l’art du code QR réside dans la rédaction du prompt, alors quelles sont les subtilités de la rédaction du prompt ? En fait, ce sont toutes des instructions de prompt universelles de Stable Diffusion, l’art du code QR est basé sur la technologie Stable Diffusion avec quelques ajustements spéciaux, donc son prompt d’entrée est exactement le même que celui de Stable Diffusion. Si vous ne savez pas encore ce qu’est Stable Diffusion, vous pouvez consulter son site officiel : https://stablediffusionweb.com/, ainsi que des tutoriels et guides sur les prompts : https://stable-diffusion-art.com/prompt-guide/, de plus, Stable Diffusion a également créé un générateur de prompts, qui peut nous aider à générer des prompts : https://stablediffusionweb.com/prompt-generator, en outre, il existe également des sites de collections d’exemples de prompts : https://publicprompts.art/ Le contenu ci-dessus est à titre de référence uniquement, pour plus d’informations, vous pouvez rechercher vous-même des documents relatifs à Stable Diffusion pour apprendre.

Paramètres avancés

Cette API propose également de nombreux paramètres avancés pour faciliter la personnalisation de plus de fonctionnalités, les explications sont les suivantes :

preset : style de fond prédéfini. Style de fond du code QR, comme le style surréaliste, effet néon, style dessin à la main, etc.
steps : nombre d’itérations de dessin. Plus le nombre est élevé, plus le style artistique du code QR est fort, la plage est de 10 à 20, par défaut c’est 16.
qrw : poids du code QR. Plus le poids est élevé, plus l’image se rapproche d’un vrai code QR, mais le style artistique sera atténué, la plage de valeurs est de 1,5 à 3, par défaut c’est 1,5.
seed : graine aléatoire. Utilisée pour générer des codes QR aléatoires, lorsque la graine est la même, le style du code QR généré est identique, la plage est de 1 à 9007199254740991.
rawurl : conserver le lien d’origine ou non. Par défaut, le lien d’entrée sera raccourci en un lien court, ce qui peut augmenter le taux de scan, cette valeur est par défaut false.
padding_level : marge intérieure du code QR. Taille de la marge intérieure du code QR,
aspect_ratio : rapport largeur/hauteur du code QR.
position : position du code QR.
pixel_style : style pixel du code QR.
marker_shape : forme du cadre de localisation du code QR.
sub_marker : style de sous-marque du code QR.
rotate : angle de rotation du code QR.
ecl : niveau de correction d’erreur du code QR.
padding_noise : bruit de marge intérieure du code QR.
pattern : combinaison de code QR prédéfini. Combinaisons de styles de code QR prédéfinies, comme le style du cadre de localisation (carré, rond, etc.), style des points (carré, rond, etc.).

Dans le texte suivant, nous allons examiner en détail certains des paramètres avancés de l’API de code QR artistique, en en sélectionnant quelques-uns pour les présenter.

Préréglage preset

L’API de code QR artistique a défini de nombreux modèles prédéfinis, ce paramètre s’appelle preset, les valeurs sont les suivantes :

coucher de soleil（日落）: Fusion des teintes chaudes et des effets de lumière douce du crépuscule.
floral（花卉）: Un style artistique avec des éléments floraux et végétaux, mettant en avant la beauté de la nature.
flocons de neige（雪花）: Un monde de glace et de neige, avec une atmosphère froide de cristaux de glace et de flocons de neige.
plumes（羽毛）: Présentant des caractéristiques de plumes et d’oiseaux, créant une sensation de légèreté et de douceur.
gouttes de pluie（雨滴）: Inspiré par les gouttes de pluie et les perles d’eau, créant un effet frais et humide.
ultra-réalisme（超现实）: Détails et textures extrêmement réalistes, créant un effet qui dépasse la réalité.
royaumes épiques（史诗领域）: Scènes majestueuses et sensation épique, offrant une expérience visuelle grandiose.
studio complexe（错综复杂）: Un style riche en détails et en complexité, nécessitant une observation attentive pour être pleinement compris.
chef-d’œuvre symétrique（对称杰作）: Création d’un équilibre et d’harmonie exquis à travers des éléments symétriques.
autoroute lumineuse（发光高速公路）: Met l’accent sur les effets lumineux nocturnes, comme les phares de voiture et les néons.
voyage céleste（星际之旅）: Exploration d’un voyage fantastique à travers l’univers et les étoiles.
néon-mécanique（霓虹机械）: Combinaison d’éléments néon et mécaniques, créant une sensation futuriste.
éthéré bas-poly（飘渺低多边形）: Style bas-poly, créant un effet illusoire et abstrait.
paysage doré（金色景观）: Dominé par des teintes dorées, présentant un spectacle visuel spectaculaire.
étendue cinématographique（电影式广袤）: Scènes vastes avec une sensation cinématographique, captivantes.
chaleur cinématographique（电影式温暖）: Teintes et effets de lumière chauds avec une texture cinématographique.
wilderness désolée（荒凉荒野）: Dépeignant la désolation et la nature sauvage, créant un sentiment de solitude.
palette vibrante（鲜明调色板）: Couleurs riches et variées, avec un fort contraste de couleurs.
voyage énigmatique（神秘之旅）: Exploration d’un voyage rempli de mystères et de sensations mystérieuses.
cinématographique intemporel（永恒电影）: Un style avec une texture cinématographique qui n’est pas limité par le temps.
galaxie royale（皇家星系）: Système stellaire et éléments cosmiques avec une atmosphère royale.
toile illustre（杰出画布）: Création d’un effet de toile exceptionnel et accrocheur.
fresque expressive（富有表现力的壁画）: Un style de grande fresque rempli d’expression et d’émotion.
brume sereine（宁静薄雾）: Avec des effets de sérénité et de brume, créant une atmosphère paisible.

Nous allons maintenant essayer les effets de différents paramètres, par exemple en prenant coucher de soleil（日落） et gouttes de pluie（雨滴） comme exemple.

curl -X POST "https://api.zhishuyun.com/qrart/generate?token={token}" \
  -H "accept: application/json" \
  -H "content-type: application/json" \
  -d '{
    "type": "link",
    "content": "https://data.zhishuyun.com",
    "prompt": "sakura",
    "preset": "coucher de soleil"
  }'

Ici, nous avons défini le preset sur coucher de soleil（日落效果），l’effet est le suivant :

Si nous changeons de style, par exemple en remplaçant le paramètre preset par gouttes de pluie（雨滴效果），l’effet est le suivant :

Concernant d’autres paramètres, vous pouvez les expérimenter vous-même.

Rapport largeur/hauteur du code QR aspect_ratio

Avec le paramètre aspect_ratio, nous pouvons définir le rapport largeur/hauteur du code QR, par exemple carré 1:1, rectangle 16:9, etc. Ce paramètre :

768x768 : Rapport largeur/hauteur de 1:1, indiquant que la largeur et la hauteur de la toile sont égales. La taille en pixels correspondante est de 768x768, le code QR généré est carré.
1008x576 : Rapport largeur/hauteur de 16:9, indiquant que la largeur de la toile est 16/9 fois la hauteur. La taille en pixels correspondante est de 1008x576, le code QR généré a une largeur plus grande, adapté à un affichage en écran large.
576x1008 : Rapport largeur/hauteur de 9:16, indiquant que la largeur de la toile est 9/16 fois la hauteur. La taille en pixels correspondante est de 576x1008, le code QR généré a une hauteur plus grande, adapté à un affichage en portrait.
864x672 : Rapport largeur/hauteur de 4:3, indiquant que la largeur de la toile est 4/3 fois la hauteur. La taille en pixels correspondante est de 864x672, le code QR généré a une légère sensation carrée, adapté à un affichage général.
672x864 : Rapport largeur/hauteur de 3:4, indiquant que la largeur de la toile est 3/4 fois la hauteur. La taille en pixels correspondante est de 672x864, le code QR généré a une légère sensation de rectangle vertical, adapté à un affichage général.

curl -X POST "https://api.zhishuyun.com/qrart/generate?token={token}" \
  -H "accept: application/json" \
  -H "content-type: application/json" \
  -d '{
    "type": "link",
    "content": "https://data.zhishuyun.com",
    "prompt": "Fish",
    "aspect_ratio": "576x1008"
  }'

Ici, nous avons essayé de générer un code QR rectangulaire, l’effet est le suivant :

Position du code QR position

Nous pouvons également contrôler la position du code QR via le paramètre position, par exemple, si une image contient une fille portant une robe et que nous voulons placer le code QR à l’endroit de la robe et le fusionner, nous pouvons essayer de modifier la position du code QR, un exemple d’appel est le suivant :

curl -X POST "https://api.zhishuyun.com/qrart/generate?token={token}" \
  -H "accept: application/json" \
  -H "content-type: application/json" \
  -d '{
    "type": "link",
    "content": "https://data.zhishuyun.com",
    "prompt": "une des belles filles au clair de lune en arrière-plan, dans le style du chaos pixelisé, art inspiré du rococo, blanc sombre et bleu ciel, fait de plastique, fleurs délicates, gongbi, wimmelbilder",
    "position": "bottom",
    "aspect_ratio": "576x1008"
  }'

L’effet est comme suit :

Style de pixel du code QR pixel_style

Nous pouvons également personnaliser le style de pixel du code QR en passant pixel_style, les valeurs de paramètres disponibles sont les suivantes :

square (carré) : utilise des unités de pixel carrées, chaque unité de pixel a une forme carrée.
rounded (arrondi) : les unités de pixel ont des coins arrondis, ce qui rend le code QR généré plus doux et moderne.
dot (point) : utilise de petits points ronds comme unités de pixel, le code QR généré présente un effet de pointillé, similaire à un effet d’impression.
squircle (carré arrondi) : similaire à un rectangle arrondi, mais plus proche de la forme ronde, donnant un style unique au code QR généré.
row (rangée) : dispose les unités de pixel en rangées, présentant un motif horizontal.
column (colonne) : dispose les unités de pixel en colonnes, présentant un motif vertical.

Aperçu des styles comme suit :

Style de cadre du code QR marker_shape

Avec marker_shape, vous pouvez personnaliser le style du cadre de localisation, les valeurs de paramètres disponibles sont les suivantes :

square (carré) : la forme du marqueur est carrée, utilisée pour mettre en évidence un emplacement ou un élément spécifique.
circle (cercle) : la forme du marqueur est circulaire, pouvant être utilisée pour marquer des zones ou éléments clés.
plus (plus) : la forme du marqueur est un plus, similaire à une croix, utilisée pour attirer l’attention ou des informations spécifiques.
box (boîte) : la forme du marqueur est une boîte, similaire à un rectangle avec contour, utilisée pour entourer une zone ou un élément.
octagon (octogone) : la forme du marqueur est un octogone, avec des coins uniques, utilisée pour attirer visuellement.
random (aléatoire) : la forme du marqueur est distribuée de manière aléatoire, ajoutant un sens artistique et un intérêt visuel au code QR.
tiny-plus (petit plus) : un petit marqueur en forme de plus, pouvant être utilisé pour marquer des éléments ou détails subtils.

Aperçu des styles comme suit :

Style de sous-marqueur du code QR sub_marker

Avec sub_marker, vous pouvez définir la forme des sous-marqueurs (marqueurs plus petits), les valeurs de paramètres disponibles sont les suivantes :

square (carré) : la forme du sous-marqueur est carrée, pouvant être utilisée pour mettre en évidence des détails spécifiques.
circle (cercle) : la forme du sous-marqueur est circulaire, pouvant être utilisée pour souligner des détails ou éléments clés.
box (boîte) : la forme du sous-marqueur est une boîte, similaire à un rectangle avec contour, adaptée pour marquer de petites zones.
random (aléatoire) : la forme du sous-marqueur est distribuée de manière aléatoire, ajoutant un sens artistique et un intérêt visuel au code QR.
plus (plus) : la forme du sous-marqueur est un plus, similaire à une croix, pouvant être utilisée pour marquer des informations ou éléments subtils.

Angle de rotation du code QR rotate

Avec rotate, vous pouvez contrôler l’angle de rotation du code QR, les valeurs de paramètres disponibles sont les suivantes :

0 : pas de rotation, le code QR généré conserve sa direction d’origine, sans effet de rotation.
90 : le code QR généré est tourné de 90 degrés dans le sens des aiguilles d’une montre, affiché en direction verticale.
180 : le code QR est tourné de 180 degrés, affiché à l’envers, c’est-à-dire de haut en bas.
270 : le code QR est tourné de 270 degrés dans le sens des aiguilles d’une montre, affiché en direction inverse.

Préréglage du code QR pattern

Avec pattern, vous pouvez facilement activer certains styles de code QR, comme un cadre de localisation carré, des points de pixel ronds, etc., ici quelques patterns sont prédéfinis :

motif	signification
s1	style_pixel : carré forme_marqueur : carré
s2	style_pixel : carré forme_marqueur : carré rotation : 180
s3	style_pixel : carré forme_marqueur : carré rotation : 180padding_personnalisé_bruit : 0.25
rd1	style_pixel : arrondi forme_marqueur : aléatoire
rd2	style_pixel : arrondi forme_marqueur : aléatoire rotation : 180
rd3	style_pixel : arrondi forme_marqueur : aléatoire rotation : 180padding_personnalisé_bruit : 0.25
d1	style_pixel : point forme_marqueur : cercle
d2	style_pixel : point forme_marqueur : cercle rotation : 180
d3	style_pixel : point forme_marqueur : cercle rotation : 180padding_personnalisé_bruit : 0.25
r1	style_pixel : rang forme_marqueur : plus
r2	style_pixel : rang forme_marqueur : plus rotation : 180
r3	style_pixel : rang forme_marqueur : plus rotation : 180padding_personnalisé_bruit : 0.25
c1	style_pixel : colonne forme_marqueur : boîte
c2	style_pixel : colonne forme_marqueur : boîte rotation : 180
c3	style_pixel : colonne forme_marqueur : boîte rotation : 180padding_personnalisé_bruit : 0.25
sq1	style_pixel : squircle forme_marqueur : aléatoire
sq2	style_pixel : squircle forme_marqueur : aléatoire rotation : 180
sq3	style_pixel : squircle forme_marqueur : aléatoire rotation : 180padding_personnalisé_bruit : 0.25