API de Solicitação e Uso de QR Code Artístico

O QR Code Artístico é um produto tecnológico inovador que combina QR Codes com imagens de fundo estéticas, criando obras que são tanto práticas quanto visualmente agradáveis. Eles não apenas possuem a funcionalidade dos QR Codes tradicionais, que podem ser rapidamente escaneados e reconhecidos por dispositivos inteligentes, mas também incorporam elementos artísticos, aumentando a atratividade visual e a identificação da marca. Alguns QR Codes artísticos são até gerados por inteligência artificial, aproveitando ao máximo a tecnologia moderna, exibindo uma inovação e singularidade incomparáveis. Isso torna o QR Code Artístico amplamente aplicável em áreas como marketing de marca e promoção publicitária. Em termos simples, o QR Code Artístico é a combinação perfeita entre escanear um QR Code e a estética artística, oferecendo não apenas a funcionalidade de transmissão de informações, mas também melhorando a experiência visual do usuário, tornando cada escaneamento uma experiência artística.

Visão Geral das Obras

Vamos dar uma olhada em algumas obras de QR Code:

O que você acha? Esses QR Codes são QR Codes Artísticos, que realizam a combinação perfeita entre imagem e QR Code, sendo mais artísticos do que os QR Codes comuns. E o mais importante, cada QR Code pode ser escaneado!

Como Criar?

Quer criar um QR Code assim? Como fazer um QR Code Artístico? Na verdade, isso é relativamente complexo do ponto de vista técnico. Na era da IA atual, a solução para QR Codes Artísticos é baseada no Stable Diffusion, onde, ao inserir um prompt, podemos gerar a imagem correspondente, combinando-a com o conteúdo do QR Code para finalmente alcançar esse efeito. Portanto, o principal desafio aqui é: como fazer um QR Code que seja bonito e artístico, e que ainda possa ser escaneado corretamente. Para ser sincero, essa tecnologia é bastante difícil e requer muitos ajustes de parâmetros para obter um efeito um pouco melhor. Cerca de 99% das pessoas desistem no primeiro passo. Supondo que, após ajustes constantes, realmente conseguimos criar esse efeito, a execução real também envolve um custo considerável; se quisermos uma velocidade razoavelmente rápida, pode ser necessário um GPU de alto desempenho, que pode custar facilmente mais de dez mil reais. Alguns amigos podem dizer: eu não quero gastar tanta energia, não quero gastar tanto dinheiro, só quero fazer um QR Code Artístico, ou quero integrar essa capacidade ao meu produto; seria ótimo se houvesse uma API pronta para isso. E há? Na verdade, há. Esta plataforma oferece uma API de geração de QR Code Artístico, onde podemos chamar a API e inserir vários parâmetros, como conteúdo da imagem, link do QR Code, estilo, entre outros, para gerar facilmente o QR Code Artístico desejado, e a primeira solicitação oferece 20 gerações gratuitas.

Solicitação da API

Para usar a API de QR Code Artístico, primeiro você pode acessar a página da API de QR Code Artístico e clicar no botão “Obter”:

Se você ainda não estiver logado, será redirecionado automaticamente para a página de login; basta escanear o código para seguir a conta oficial e você será logado automaticamente, sem necessidade de registro adicional. Após o login, você será redirecionado de volta à página original, onde será exibida a mensagem “Você ainda não solicitou este serviço, é necessário solicitar”. Durante a solicitação, a verificação da autenticação real será realizada, por favor, siga as instruções do site para completar a autenticação. A autenticação real verificará nome, número de telefone e número de identidade; após a autenticação, você pode retornar à página, atualizar para garantir que as informações estejam atualizadas e, em seguida, solicitar novamente.

Uso Básico

Para usar a funcionalidade básica do QR Code Artístico, você precisa preencher os seguintes parâmetros obrigatórios:

type: tipo do QR Code, como texto puro, link, etc.
content: conteúdo do QR Code, por exemplo, se for um link, podemos inserir o link correspondente.
prompt: instrução de estilo correspondente ao QR Code, é altamente recomendável usar inglês. Por exemplo, pizza gerará um QR Code que se parece com uma pizza.
callback_url: opcional, endereço de callback assíncrono, se fornecido, retornará imediatamente o ID da tarefa.
content_image_url: opcional, link da imagem que contém o conteúdo real do QR Code.
aspect_ratio: opcional, proporção largura-altura da tela, padrão 1:1.
ecl: nível de correção de erros, padrão H.
qrw: peso do QR Code, 1.5-3, quanto maior, mais próximo do QR Code real.
seed: semente aleatória fixa, gera QR Codes reproduzíveis.
steps: número de iterações de desenho, 10-20, padrão 16.
preset: estilo de fundo predefinido.
pattern: estilo principal, padrão custom.
position: posição do QR Code, padrão center.
marker_shape: forma do ponto de localização, padrão square.
sub_marker: forma do ponto de localização auxiliar, padrão square.
pixel_style: estilo de pixel, como square, rounded, dot.
padding_level/padding_noise: intensidade de espaço em branco e ruído.
rotate: ângulo de rotação, padrão 0.
rawurl: se deve manter o link original, padrão false, se ativado, não faz encurtamento de link.

Em seguida, vamos gerar um QR Code do site oficial da Zhishuyun, o tipo é link, o conteúdo é https://data.zhishuyun.com, o prompt aqui é preenchido com o seguinte conteúdo:

(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

Na página de teste, preencha o seguinte conteúdo:

Em seguida, clique em testar:

Depois de um tempo, você verá que o QR Code Artístico foi gerado, e o resultado é semelhante ao seguinte:

{
  "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
}

O código QR é o seguinte:

Assim, geramos um código QR, cujo tema é um barco, que exibe várias bandeiras, e essas bandeiras formam os pontos de localização do código QR. Ao escanear com o celular, você pode ser redirecionado para o site oficial da Zhishuyun. Ao mesmo tempo, o conteúdo acima pode ser facilmente convertido em uma chamada de API.

Guia de prompt

Através da operação acima, podemos ver que a chave do código QR artístico está na redação do prompt. Quais são as considerações para a redação do prompt? Na verdade, todas essas são instruções de prompt genéricas do Stable Diffusion. O código QR artístico é gerado com base na tecnologia Stable Diffusion, além de alguns ajustes especiais, portanto, seu prompt de entrada é exatamente o mesmo do Stable Diffusion. Se você ainda não sabe o que é Stable Diffusion, pode visitar seu site oficial para saber mais: https://stablediffusionweb.com/, além de tutoriais e guias de prompt: https://stable-diffusion-art.com/prompt-guide/. Além disso, o Stable Diffusion também criou um gerador de prompt que pode nos ajudar a gerar prompts: https://stablediffusionweb.com/prompt-generator. Além disso, há alguns sites de coleções de exemplos de prompt: https://publicprompts.art/ O conteúdo acima é apenas para referência. Para mais informações, você pode pesquisar por materiais relacionados ao Stable Diffusion para aprender.

Parâmetros avançados

Esta API também oferece mais parâmetros avançados para facilitar a personalização de mais funcionalidades, conforme descrito abaixo:

preset: estilo de fundo predefinido. Estilo de fundo do código QR, como estilo surrealista, efeito neon, estilo desenhado à mão, etc.
steps: número de iterações de desenho. Quanto maior o número, mais forte será o estilo artístico do código QR, com um intervalo de 10-20, o padrão é 16.
qrw: peso do código QR. Quanto maior o peso, mais a imagem se aproxima de um código QR real, mas o estilo artístico será reduzido, com um intervalo de 1.5-3, o padrão é 1.5.
seed: semente aleatória. Usada para gerar códigos QR aleatórios. Quando a semente é a mesma, o estilo do código QR gerado é o mesmo, com um intervalo de 1-9007199254740991.
rawurl: se deve manter o link original. Por padrão, o link de entrada será encurtado para um link curto, o que pode aumentar a taxa de escaneamento, o valor padrão é false.
padding_level: margem interna do código QR. Tamanho da margem interna do código QR.
aspect_ratio: proporção largura-altura do código QR.
position: posição do código QR.
pixel_style: estilo de pixel do código QR.
marker_shape: forma da moldura de localização do código QR.
sub_marker: estilo de sub-marcador do código QR.
rotate: ângulo de rotação do código QR.
ecl: nível de correção de erro do código QR.
padding_noise: ruído na margem interna do código QR.
pattern: combinação de código QR predefinida. Combinações de estilo de código QR predefinidas, como estilo da moldura de localização (quadrada, redonda, etc.), estilo dos pontos (quadrado, redondo, etc.).

A seguir, vamos entender melhor alguns parâmetros avançados da API de código QR artístico, selecionando alguns para apresentar.

Preset preset

A API de código QR artístico definiu muitos modelos predefinidos, este parâmetro é chamado de preset, com os seguintes valores:

sunset（日落）: Fusão dos tons quentes e do efeito de luz suave do pôr do sol.
floral（花卉）: Estilo artístico com elementos de flores e plantas, enfatizando a beleza da natureza.
snowflakes（雪花）: Mundo de gelo e neve, com uma atmosfera fria de cristais de gelo e flocos de neve.
feathers（羽毛）: Apresenta características de penas e aves, criando uma sensação leve e suave.
raindrops（雨滴）: Inspirado em gotas de chuva e gotículas de água, criando um efeito fresco e úmido.
ultra-realism（超现实）: Detalhes e texturas extremamente realistas, criando um efeito que transcende a realidade.
epic-realms（史诗领域）: Cenários majestosos e uma sensação épica, proporcionando uma experiência visual grandiosa.
intricate-studio（错综复杂）: Estilo rico em detalhes e complexidade, que requer observação cuidadosa para ser completamente compreendido.
symmetric-masterpiece（对称杰作）: Criação de um equilíbrio e harmonia requintados através de elementos simétricos.
luminous-highway（发光高速公路）: Enfatiza o efeito luminoso à noite, como faróis de carros e luzes de néon.
celestial-journey（星际之旅）: Exploração de uma jornada fantástica pelo universo e pelos confins do espaço.
neon-mech（霓虹机械）: Combinação de elementos de néon e mecânicos, criando uma sensação futurista.
ethereal-low-poly（飘渺低多边形）: Estilo de baixo polígono, criando um efeito etéreo e abstrato.
golden-vista（金色景观）: Predominância de tons dourados, apresentando uma cena visual espetacular.
cinematic-expanse（电影式广袤）: Cenários vastos com uma sensação cinematográfica, cativante.
cinematic-warm（电影式温暖）: Tons quentes e efeitos de luz com uma qualidade cinematográfica.
desolate-wilderness（荒凉荒野）: Retrato de desolação e natureza selvagem, criando uma sensação de solidão.
vibrant-palette（鲜明调色板）: Cores ricas e variadas, com forte contraste de cores.
enigmatic-journey（神秘之旅）: Exploração de uma jornada cheia de mistérios e um senso de enigma.
timeless-cinematic（永恒电影）: Estilo com qualidade cinematográfica que não é limitado pelo tempo.
regal-galaxy（皇家星系）: Galáxias e elementos cósmicos com uma aura real.
illustrious-canvas（杰出画布）: Criação de um efeito de tela excepcional e atraente.
expressive-mural（富有表现力的壁画）: Estilo de mural grande, cheio de expressividade e emoção.
serene-haze（宁静薄雾）: Com efeito de tranquilidade e névoa, criando uma atmosfera serena.

Vamos tentar diferentes efeitos de parâmetros, por exemplo, usando sunset（日落） e raindrops（雨滴） para ver o efeito.

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": "sunset"
  }'

Aqui, definimos o preset como sunset（日落效果），o efeito é o seguinte:

Se mudarmos o estilo, por exemplo, alterando o parâmetro preset para raindrops（雨滴效果）， o efeito é o seguinte:

Sobre outras configurações, vocês podem experimentar por conta própria.

Proporção largura-altura do QR Code aspect_ratio

Através do parâmetro aspect_ratio, podemos definir a proporção largura-altura do QR Code, como quadrado 1:1, retângulo 16:9, etc. Este parâmetro:

768x768: Proporção 1:1, indicando que a largura e a altura da tela são iguais. O tamanho em pixels correspondente é 768x768, gerando um QR Code quadrado.
1008x576: Proporção 16:9, indicando que a largura da tela é 16/9 vezes a altura. O tamanho em pixels correspondente é 1008x576, gerando um QR Code com largura maior, adequado para exibição em tela larga.
576x1008: Proporção 9:16, indicando que a largura da tela é 9/16 vezes a altura. O tamanho em pixels correspondente é 576x1008, gerando um QR Code com altura maior, adequado para exibição em modo retrato.
864x672: Proporção 4:3, indicando que a largura da tela é 4/3 vezes a altura. O tamanho em pixels correspondente é 864x672, gerando um QR Code com uma leve sensação quadrada, adequado para exibição geral.
672x864: Proporção 3:4, indicando que a largura da tela é 3/4 vezes a altura. O tamanho em pixels correspondente é 672x864, gerando um QR Code com uma leve sensação retangular vertical, adequado para exibição geral.

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"
  }'

Aqui tentamos gerar um QR Code retangular, o efeito é o seguinte:

Posição do QR Code position

Também podemos controlar a posição do QR Code através do parâmetro position, por exemplo, em uma imagem onde há uma garota vestindo uma saia, e queremos colocar o QR Code na posição da saia e integrá-lo, podemos tentar alterar a posição do QR Code, o exemplo de chamada é o seguinte:

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": "uma das belas garotas à luz da lua ao fundo, no estilo de caos pixelado, arte inspirada no rococó, branco escuro e azul céu, feito de plástico, flores delicadas, gongbi, wimmelbilder",
    "position": "bottom",
    "aspect_ratio": "576x1008"
  }'

Efeito como abaixo:

Estilo de pixel do código QR pixel_style

Também podemos personalizar o estilo de pixel do código QR, passando pixel_style, os valores de parâmetro opcionais são os seguintes:

square (quadrado): usa unidades de pixel quadradas, cada unidade de pixel tem a forma de um quadrado.
rounded (cantoneira): as unidades de pixel têm cantoneiras, fazendo com que o código QR gerado pareça mais suave e moderno.
dot (ponto): usa pequenos pontos redondos como unidades de pixel, o código QR gerado apresenta um efeito de matriz, semelhante ao efeito de impressão.
squircle (quadrado arredondado): semelhante a um retângulo arredondado, mas mais próximo da forma circular, conferindo um estilo único ao código QR gerado.
row (linha): organiza as unidades de pixel em linhas, apresentando um padrão na direção horizontal.
column (coluna): organiza as unidades de pixel em colunas, apresentando um padrão na direção vertical.

Pré-visualização do estilo abaixo:

Estilo de moldura do código QR marker_shape

Através de marker_shape, é possível personalizar o estilo da moldura de localização, os valores de parâmetro opcionais são os seguintes:

square (quadrado): a forma do marcador é quadrada, usada para destacar uma posição ou elemento específico.
circle (círculo): a forma do marcador é circular, podendo ser usada para marcar áreas ou elementos-chave.
plus (sinal de mais): a forma do marcador é um sinal de mais, semelhante a uma cruz, usada para destacar atenção ou informações específicas.
box (caixa): a forma do marcador é uma caixa, semelhante a um retângulo contornado, podendo ser usada para cercar áreas ou elementos.
octagon (octógono): a forma do marcador é um octógono, com cantos únicos, usada para atrair visualmente.
random (aleatório): a forma do marcador é distribuída aleatoriamente, adicionando um toque artístico e interesse visual ao código QR.
tiny-plus (sinal de mais pequeno): um pequeno marcador de sinal de mais, podendo ser usado para marcar elementos ou detalhes sutis.

Pré-visualização do estilo abaixo:

Estilo de sub-marcador do código QR sub_marker

Através de sub_marker, é possível definir a forma dos sub-marcadores (marcadores menores), os valores de parâmetro opcionais são os seguintes:

square (quadrado): a forma do sub-marcador é quadrada, podendo ser usada para destacar detalhes de uma posição específica.
circle (círculo): a forma do sub-marcador é circular, podendo ser usada para enfatizar detalhes ou elementos-chave.
box (caixa): a forma do sub-marcador é uma caixa, semelhante a um retângulo contornado, adequada para marcar áreas pequenas.
random (aleatório): a forma do sub-marcador é distribuída aleatoriamente, adicionando um toque artístico e interesse visual ao código QR.
plus (sinal de mais): a forma do sub-marcador é um sinal de mais, semelhante a uma cruz, podendo ser usada para marcar informações ou elementos sutis.

Ângulo de rotação do código QR rotate

Através de rotate, é possível controlar o ângulo de rotação do código QR, os valores de parâmetro opcionais são os seguintes:

0: sem rotação, o código QR gerado mantém a direção original, sem efeito de rotação.
90: o código QR gerado é girado 90 graus no sentido horário, exibindo-se na direção vertical.
180: o código QR gerado é girado 180 graus, ficando invertido, ou seja, exibido de cabeça para baixo.
270: o código QR gerado é girado 270 graus no sentido horário, exibindo-se na direção oposta à vertical.

Padrão do código QR pattern

Através de pattern, é possível ativar facilmente alguns estilos de código QR, como molduras de localização quadradas, pontos de pixel circulares, etc., aqui estão alguns padrões pré-definidos:

padrão	significado
s1	estilo_pixel: quadrado forma_marcador: quadrado
s2	estilo_pixel: quadrado forma_marcador: quadrado rotacionar: 180
s3	estilo_pixel: quadrado forma_marcador: quadrado rotacionar: 180padding_personalizado_ruído: 0.25
rd1	estilo_pixel: arredondado forma_marcador: aleatório
rd2	estilo_pixel: arredondado forma_marcador: aleatório rotacionar: 180
rd3	estilo_pixel: arredondado forma_marcador: aleatório rotacionar: 180padding_personalizado_ruído: 0.25
d1	estilo_pixel: ponto forma_marcador: círculo
d2	estilo_pixel: ponto forma_marcador: círculo rotacionar: 180
d3	estilo_pixel: ponto forma_marcador: círculo rotacionar: 180padding_personalizado_ruído: 0.25
r1	estilo_pixel: linha forma_marcador: mais
r2	estilo_pixel: linha forma_marcador: mais rotacionar: 180
r3	estilo_pixel: linha forma_marcador: mais rotacionar: 180padding_personalizado_ruído: 0.25
c1	estilo_pixel: coluna forma_marcador: caixa
c2	estilo_pixel: coluna forma_marcador: caixa rotacionar: 180
c3	estilo_pixel: coluna forma_marcador: caixa rotacionar: 180padding_personalizado_ruído: 0.25
sq1	estilo_pixel: squircle forma_marcador: aleatório
sq2	estilo_pixel: squircle forma_marcador: aleatório rotacionar: 180
sq3	estilo_pixel: squircle forma_marcador: aleatório rotacionar: 180padding_personalizado_ruído: 0.25