예술 QR 코드 API 신청 및 사용

예술 QR 코드는 QR 코드와 아름다운 배경 이미지를 결합한 혁신적인 기술 제품으로, 실용적이면서도 아름다운 작품을 창조합니다. 이들은 전통적인 QR 코드의 기능성을 가지고 있어 스마트 기기로 빠르게 스캔하고 인식할 수 있을 뿐만 아니라, 예술적 요소를 추가하여 시각적 매력과 브랜드 인지도를 높입니다. 그 중 일부 예술 QR 코드는 인공지능에 의해 생성되며, 현대 기술을 충분히 활용하여 비할 데 없는 혁신성과 독특성을 보여줍니다. 이는 예술 QR 코드가 브랜드 마케팅, 광고 홍보 등 다양한 분야에서 널리 사용될 수 있게 합니다. 간단히 말해, 예술 QR 코드는 QR 코드 스캔과 예술적 미감의 완벽한 결합으로, 정보 전달 기능을 제공할 뿐만 아니라 사용자에게 시각적 경험을 향상시켜 매번 스캔할 때마다 예술적 즐거움을 선사합니다.

작품 개요

먼저 몇 가지 QR 코드 작품을 살펴보겠습니다:

어떻게 생각하시나요? 이 QR 코드들은 예술 QR 코드로, 이미지와 QR 코드의 완벽한 결합을 실현하여 일반 QR 코드보다 더 예술적인 느낌을 줍니다. 게다가 중요한 것은, 모든 QR 코드가 스캔이 가능하다는 것입니다!

어떻게 제작하나요?

이런 QR 코드를 만들고 싶으신가요? 어떻게 이런 예술 QR 코드를 만들 수 있을까요? 사실 기술적으로는 상대적으로 복잡합니다. 현재 AI 시대에서 예술 QR 코드의 솔루션은 Stable Diffusion을 기반으로 하며, 프롬프트를 입력하면 해당 이미지를 생성할 수 있고, QR 코드 내용과의 융합을 통해 최종적으로 이러한 효과를 실현합니다. 따라서 여기서 가장 큰 도전 과제는 QR 코드를 아름답고 예술적으로 만드는 동시에 QR 코드가 올바르게 스캔될 수 있도록 하는 것입니다. 솔직히 이 기술은 여전히 꽤 어렵고, 약간의 좋은 효과를 얻기 위해서는 많은 매개변수 조정이 필요합니다. 99%의 사람들은 첫 단계에서 포기할 것입니다. 가정해 보세요, 끊임없는 조정을 통해 정말로 이러한 효과를 만들어냈다면, 실제로 운영하는 것도 만만치 않은 비용이 들 것입니다. 속도가 빠르려면 성능이 좋은 GPU가 필요할 수 있으며, 잘못하면 수만 원이 될 수 있습니다. 어떤 친구들은 이렇게 말할지도 모릅니다: 나는 그렇게 많은 정성을 들이고 싶지 않고, 그렇게 많은 돈을 쓰고 싶지 않으며, 그냥 예술 QR 코드를 만들고 싶거나 이 기능을 내 제품에 통합하고 싶다. 만약 이렇게 준비된 API가 있다면 좋겠네요. 있습니다. 정말로 있습니다. 본 플랫폼은 예술 QR 코드 관련 생성 API를 제공하며, 우리는 API를 호출하여 다양한 매개변수, 예를 들어 이미지 내용, QR 코드 링크, 스타일 등을 입력하면 매우 편리하게 원하는 예술 QR 코드를 생성할 수 있습니다. 게다가 첫 신청 시 20회 무료 생성이 제공됩니다.

API 신청

예술 QR 코드 API를 사용하려면, 먼저 예술 QR 코드 API 페이지로 가서 “받기” 버튼을 클릭하세요:

로그인하지 않은 경우 자동으로 로그인 페이지로 이동하며, QR 코드를 스캔하여 공공 계정을 팔로우하면 자동으로 로그인됩니다. 추가 등록 절차는 필요하지 않습니다. 로그인 후 원래 페이지로 돌아가면 “서비스를 신청하지 않았습니다. 신청이 필요합니다.”라는 메시지가 표시됩니다. 신청 시 실명 인증 여부를 확인하므로, 웹사이트의 안내에 따라 실명 인증을 완료해 주세요. 실명 인증은 이름, 전화번호, 신분증 번호를 확인하며, 인증이 완료되면 페이지로 돌아가서 정보를 업데이트하기 위해 새로 고침한 후 다시 신청하면 됩니다.

기본 사용

예술 QR 코드의 가장 기본적인 기능을 사용하려면 다음과 같은 필수 매개변수를 입력해야 합니다:

type: QR 코드의 유형, 예를 들어 순수 텍스트, 링크 등.
content: QR 코드의 내용, 예를 들어 링크인 경우 해당 링크를 입력합니다.
prompt: QR 코드에 해당하는 스타일 그리기 지시어, 영어로 입력하는 것이 강력히 권장됩니다. 예를 들어 pizza라고 입력하면 피자처럼 보이는 QR 코드가 그려집니다.
callback_url: 선택 사항, 비동기 콜백 주소, 제공 시 즉시 작업 ID를 반환합니다.
content_image_url: 선택 사항, 실제 QR 코드 내용을 포함하는 이미지 링크.
aspect_ratio: 선택 사항, 캔버스 가로 세로 비율, 기본값 1:1.
ecl: 오류 수정 수준, 기본값 H.
qrw: QR 코드 가중치, 1.5-3, 숫자가 클수록 실제 QR 코드에 가까워집니다.
seed: 고정 랜덤 시드, 재현 가능한 QR 코드를 생성합니다.
steps: 그리기 반복 단계 수, 10-20, 기본값 16.
preset: 미리 설정된 배경 스타일.
pattern: 주체 스타일, 기본값 custom.
position: QR 코드 위치, 기본값 center.
marker_shape: 위치 점 모양, 기본값 square.
sub_marker: 보조 위치 점 모양, 기본값 square.
pixel_style: 픽셀 스타일, 예를 들어 square, rounded, dot.
padding_level/padding_noise: 여백 및 노이즈 강도.
rotate: 회전 각도, 기본값 0.
rawurl: 원래 링크를 유지할지 여부, 기본값 false, 활성화 시 단축 링크를 만들지 않습니다.

이제 우리는 지수 클라우드 공식 웹사이트의 QR 코드를 생성해 보겠습니다. 유형은 링크이고, 내용은 https://data.zhishuyun.com이며, 프롬프트는 다음과 같이 입력합니다:

(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

테스트 페이지에 다음 내용을 입력합니다:

그런 다음 테스트를 클릭합니다:

잠시 후 예술 QR 코드가 생성되며, 결과는 다음과 유사합니다:

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

QR 코드는 다음과 같습니다:

이렇게 우리는 QR 코드를 생성했습니다. 주체는 배이며, 여러 개의 깃발이 걸려 있고, 이 깃발들이 QR 코드의 위치 점을 형성합니다. 휴대폰으로 스캔하면 지수 클라우드의 공식 웹사이트로 이동할 수 있습니다. 동시에 위의 내용 호출 방안을 우리는 매우 편리하게 API 호출로 전환할 수 있습니다.

프롬프트 가이드

위의 작업을 통해 알 수 있듯이, 예술 QR 코드의 핵심은 프롬프트 작성에 있습니다. 그 프롬프트 작성에는 어떤 주의사항이 있을까요? 사실 이것은 일반적인 Stable Diffusion의 프롬프트 지침으로, 예술 QR 코드는 Stable Diffusion 기술에 몇 가지 특별한 조정을 추가하여 생성된 것이므로, 입력 프롬프트는 Stable Diffusion과 완전히 동일합니다. 만약 당신이 아직 Stable Diffusion이 무엇인지 모른다면, 공식 웹사이트에서 알아볼 수 있습니다: https://stablediffusionweb.com/, 또한 프롬프트 튜토리얼과 가이드: https://stable-diffusion-art.com/prompt-guide/가 있습니다. 게다가 Stable Diffusion은 프롬프트 생성기를 제작하여 프롬프트 생성을 도와줍니다: https://stablediffusionweb.com/prompt-generator, 그 외에도 몇 가지 프롬프트 샘플 모음 웹사이트: https://publicprompts.art/ 위의 내용은 참고용일 뿐이며, 더 많은 정보는 Stable Diffusion 관련 자료를 검색하여 학습할 수 있습니다.

고급 매개변수

이 API는 더 많은 고급 매개변수를 제공하여 더 많은 기능 맞춤화를 편리하게 할 수 있습니다. 설명은 다음과 같습니다:

preset: 미리 설정된 배경 스타일. QR 코드 배경의 스타일, 예를 들어 초현실적 스타일, 네온 효과, 손으로 그린 스타일 등.
steps: 그리기 반복 횟수. 횟수가 많을수록 그려지는 QR 코드의 예술 스타일이 강해지며, 범위는 10-20, 기본값은 16입니다.
qrw: QR 코드의 가중치. 가중치가 클수록 이미지가 실제 QR 코드에 가까워지지만, 예술화된 스타일은 약해집니다. 값의 범위는 1.5-3, 기본값은 1.5입니다.
seed: 랜덤 시드. 랜덤 QR 코드를 생성하는 데 사용되며, 시드가 같을 경우 생성된 QR 코드 스타일이 동일합니다. 범위는 1-9007199254740991입니다.
rawurl: 원본 링크를 유지할지 여부. 기본적으로 입력 링크를 짧은 링크로 축소하여 스캔율을 높일 수 있으며, 이 값의 기본값은 false입니다.
padding_level: QR 코드 내 여백. QR 코드 내 여백의 크기,
aspect_ratio: QR 코드의 가로 세로 비율.
position: QR 코드 위치.
pixel_style: QR 코드 픽셀 스타일.
marker_shape: QR 코드 위치 프레임 모양.
sub_marker: QR 코드 서브 마커 스타일.
rotate: QR 코드 회전 각도.
ecl: QR 코드 오류 수정 수준.
padding_noise: QR 코드 내 여백 노이즈.
pattern: 미리 설정된 QR 코드 조합. 미리 설정된 QR 코드 스타일 조합, 예를 들어 위치 프레임의 스타일(사각형, 원형 등), 점의 스타일(사각형, 원형 등).

아래에서는 예술 QR 코드 API의 몇 가지 고급 매개변수를 자세히 살펴보고, 그 중 일부를 소개하겠습니다.

미리 설정된 preset

예술 QR 코드 API는 많은 미리 설정된 템플릿을 설정했으며, 이 매개변수는 preset이라고 하며, 값은 다음과 같습니다:

sunset（日落）: 석양의 잔광과 따뜻한 색조, 부드러운 조명 효과가 융합된 것.
floral（花卉）: 꽃과 식물 요소가 포함된 예술 스타일로, 자연의 아름다움을 강조함.
snowflakes（雪花）: 얼음과 눈의 세계로, 얼음 결정과 눈송이의 차가운 분위기를 지님.
feathers（羽毛）: 깃털과 새의 특징을 나타내어 가볍고 부드러운 느낌을 조성함.
raindrops（雨滴）: 빗방울과 물방울에서 영감을 받아 신선하고 촉촉한 효과를 창조함.
ultra-realism（超现实）: 극도로 사실적인 세부 사항과 질감으로 현실을 초월하는 효과를 만들어냄.
epic-realms（史诗领域）: 장엄한 장면과 서사적인 느낌을 주어 웅장한 시각적 경험을 제공함.
intricate-studio（错综复杂）: 세부 사항과 복잡성이 풍부하여 면밀히 관찰해야 완전히 이해할 수 있는 스타일.
symmetric-masterpiece（对称杰作）: 대칭 요소를 통해 정교한 균형과 조화를 창출함.
luminous-highway（发光高速公路）: 야간의 발광 효과를 강조하며, 자동차 불빛과 네온사인을 포함함.
celestial-journey（星际之旅）: 우주와 별들 사이의 환상적인 여행을 탐험함.
neon-mech（霓虹机械）: 네온사인과 기계 요소를 결합하여 미래적인 느낌을 조성함.
ethereal-low-poly（飘渺低多边形）: 저다각형 스타일로, 환상적이고 추상적인 효과를 창조함.
golden-vista（金色景观）: 금색 조명을 주로 하여 장관을 이루는 시각적 장면을 나타냄.
cinematic-expanse（电影式广袤）: 영화 같은 광활한 장면으로, 매력적인 느낌을 줌.
cinematic-warm（电影式温暖）: 영화적인 질감의 따뜻한 색조와 조명 효과를 지님.
desolate-wilderness（荒凉荒野）: 황량하고 황무지를 묘사하여 고독한 느낌을 조성함.
vibrant-palette（鲜明调色板）: 색상이 풍부하고 다양하며 강렬한 색상 대비를 지님.
enigmatic-journey（神秘之旅）: 신비롭고 수수께끼로 가득한 여행을 탐험함.
timeless-cinematic（永恒电影）: 영화적인 질감이 있으며 시간에 구애받지 않는 스타일.
regal-galaxy（皇家星系）: 왕실의 기운이 느껴지는 별계와 우주 요소.
illustrious-canvas（杰出画布）: 뛰어나고 주목을 끄는 캔버스 효과를 창조함.
expressive-mural（富有表现力的壁画）: 표현력과 감정이 가득한 대형 벽화 스타일.
serene-haze（宁静薄雾）: 고요함과 안개 효과가 있는, 평화로운 분위기를 조성함.

우리는 아래에서 서로 다른 매개변수의 효과를 시도해 보겠습니다. 예를 들어 sunset（日落）와 raindrops（雨滴）를 사용하여 효과를 살펴보겠습니다.

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

여기서 우리는 preset을 sunset（日落效果）로 설정했습니다. 효과는 다음과 같습니다:

만약 스타일을 바꾼다면, preset 매개변수를 raindrops（雨滴效果）로 변경했을 때의 효과는 다음과 같습니다:

다른 설정에 대해서는 여러분이 직접 실험해 보시기 바랍니다.

二维码宽高比 aspect_ratio

aspect_ratio 매개변수를 통해 QR 코드의 가로 세로 비율을 설정할 수 있습니다. 예를 들어 정사각형 1:1, 직사각형 16:9 등등, 해당 매개변수는:

768x768: 가로 세로 비율이 1:1로, 캔버스의 너비와 높이가 같음을 나타냄. 해당 픽셀 크기는 768x768이며, 생성된 QR 코드 캔버스는 정사각형임.
1008x576: 가로 세로 비율이 16:9로, 캔버스의 너비가 높이의 16/9배임. 해당 픽셀 크기는 1008x576이며, 생성된 QR 코드 캔버스는 너비가 넓어 와이드 스크린 표시에 적합함.
576x1008: 가로 세로 비율이 9:16으로, 캔버스의 너비가 높이의 9/16배임. 해당 픽셀 크기는 576x1008이며, 생성된 QR 코드 캔버스는 높이가 크고 세로 화면 표시에 적합함.
864x672: 가로 세로 비율이 4:3으로, 캔버스의 너비가 높이의 4/3배임. 해당 픽셀 크기는 864x672이며, 생성된 QR 코드 캔버스는 약간 정사각형 느낌이 있어 일반 표시에 적합함.
672x864: 가로 세로 비율이 3:4로, 캔버스의 너비가 높이의 3/4배임. 해당 픽셀 크기는 672x864이며, 생성된 QR 코드 캔버스는 약간 세로 직사각형 느낌이 있어 일반 표시에 적합함.

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

여기서 우리는 직사각형 QR 코드를 생성해 보았습니다. 효과는 다음과 같습니다:

二维码位置 position

우리는 position 매개변수를 통해 QR 코드의 위치를 제어할 수 있습니다. 예를 들어 한 이미지에 치마를 입은 소녀가 있고, QR 코드를 치마 위치에 배치하여 융합하고 싶다면, QR 코드의 위치를 변경해 볼 수 있습니다. 호출 예시는 다음과 같습니다:

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": "달빛 속의 아름다운 소녀 중 한 명, 픽셀화된 혼란의 스타일, 로코코에서 영감을 받은 예술, 어두운 흰색과 하늘색, 플라스틱으로 만들어진 섬세한 꽃들, 공비, 비밀 그림",
    "position": "bottom",
    "aspect_ratio": "576x1008"
  }'

효과는 다음과 같습니다:

QR 코드 픽셀 스타일 pixel_style

우리는 pixel_style을 통해 QR 코드의 픽셀 스타일을 사용자 정의할 수 있습니다. 선택 가능한 매개변수 값은 다음과 같습니다:

square(정사각형): 정사각형 픽셀 단위를 사용하며, 각 픽셀 단위는 정사각형 모양입니다.
rounded(둥근 모서리): 픽셀 단위에 둥근 모서리가 있어 생성된 QR 코드가 더 부드럽고 현대적으로 보입니다.
dot(점): 작은 원형 점을 픽셀 단위로 사용하여 생성된 QR 코드가 점 배열 효과를 나타내며, 인쇄 효과와 유사합니다.
squircle(둥근 사각형): 둥근 직사각형과 유사하지만 더 원형에 가까운 모양으로, 생성된 QR 코드에 독특한 스타일을 부여합니다.
row(행 배열): 픽셀 단위를 행으로 배열하여 수평 방향의 패턴을 나타냅니다.
column(열 배열): 픽셀 단위를 열로 배열하여 수직 방향의 패턴을 나타냅니다.

스타일 미리보기는 다음과 같습니다:

QR 코드 프레임 스타일 marker_shape

marker_shape를 통해 위치 프레임의 스타일을 사용자 정의할 수 있습니다. 선택 가능한 매개변수 값은 다음과 같습니다:

square(정사각형): 마커 모양이 정사각형으로 특정 위치나 요소를 강조하는 데 사용됩니다.
circle(원형): 마커 모양이 원형으로, 주요 영역이나 요소를 표시하는 데 사용됩니다.
plus(더하기): 마커 모양이 더하기 기호로, 십자형과 유사하여 주의나 특정 정보를 강조하는 데 사용됩니다.
box(사각형): 마커 모양이 사각형으로, 테두리 있는 직사각형과 유사하여 영역이나 요소를 둘러싸는 데 사용됩니다.
octagon(팔각형): 마커 모양이 팔각형으로 독특한 모서리를 가지고 있어 시각적으로 매력적입니다.
random(무작위): 마커 모양이 무작위로 분포하여 QR 코드에 예술적 감각과 시각적 재미를 추가합니다.
tiny-plus(미세한 더하기): 미세한 더하기 기호 마커로, 세밀한 요소나 세부 사항을 표시하는 데 사용됩니다.

스타일 미리보기는 다음과 같습니다:

QR 코드 서브 마커 스타일 sub_marker

sub_marker를 통해 서브 마커(더 작은 마커)의 모양을 정의할 수 있습니다. 선택 가능한 매개변수 값은 다음과 같습니다:

square(정사각형): 서브 마커의 모양이 정사각형으로 특정 위치의 세부 사항을 강조하는 데 사용됩니다.
circle(원형): 서브 마커의 모양이 원형으로 주요 세부 사항이나 요소를 강조하는 데 사용됩니다.
box(사각형): 서브 마커의 모양이 사각형으로, 테두리 있는 직사각형과 유사하여 작은 영역을 표시하는 데 적합합니다.
random(무작위): 서브 마커의 모양이 무작위로 분포하여 QR 코드에 예술적 감각과 시각적 재미를 추가합니다.
plus(더하기): 서브 마커의 모양이 더하기 기호로, 십자형과 유사하여 세밀한 정보나 요소를 표시하는 데 사용됩니다.

QR 코드 회전 각도 rotate

rotate를 통해 QR 코드의 회전 각도를 제어할 수 있습니다. 선택 가능한 매개변수 값은 다음과 같습니다:

0: 회전하지 않으며, 생성된 QR 코드는 원래 방향을 유지하고 회전 효과가 없습니다.
90: 생성된 QR 코드를 시계 방향으로 90도 회전시켜 세로 방향으로 표시합니다.
180: 생성된 QR 코드를 180도 회전시켜 거꾸로, 즉 위아래가 뒤집힌 방식으로 표시합니다.
270: 생성된 QR 코드를 시계 방향으로 270도 회전시켜 반대 세로 방향으로 표시합니다.

QR 코드 프리셋 pattern

pattern을 통해 정사각형 위치 프레임, 원형 픽셀 점 등과 같은 QR 코드 스타일을 쉽게 활성화할 수 있습니다. 여기에는 몇 가지 패턴이 미리 정의되어 있습니다:

패턴	의미
s1	pixel_style: square marker_shape: square
s2	pixel_style: square marker_shape: square rotate: 180
s3	pixel_style: square marker_shape: square rotate: 180custom_padding_noise: 0.25
rd1	pixel_style: rounded marker_shape: random
rd2	pixel_style: rounded marker_shape: random rotate: 180
rd3	pixel_style: rounded marker_shape: random rotate: 180custom_padding_noise: 0.25
d1	pixel_style: dot marker_shape: circle
d2	pixel_style: dot marker_shape: circle rotate: 180
d3	pixel_style: dot marker_shape: circle rotate: 180custom_padding_noise: 0.25
r1	pixel_style: row marker_shape: plus
r2	pixel_style: row marker_shape: plus rotate: 180
r3	pixel_style: row marker_shape: plus rotate: 180custom_padding_noise: 0.25
c1	pixel_style: column marker_shape: box
c2	pixel_style: column marker_shape: box rotate: 180
c3	pixel_style: column marker_shape: box rotate: 180custom_padding_noise: 0.25
sq1	pixel_style: squircle marker_shape: random
sq2	pixel_style: squircle marker_shape: random rotate: 180
sq3	pixel_style: squircle marker_shape: random rotate: 180custom_padding_noise: 0.25