path
Jin's Lab
코드로 실험하고 기록하는 개발 일지 · J.Lab

Jin's Lab

코드로 실험하고 기록하는 개발 일지. 커리어와 삶의 방향을 탐색하며 기록하는 공간입니다

APIIntegration

Gemini 이미지 생성 API 연동으로 화질 문제 깔끔하게 해결한 후기

J.Lab ·
목차

    블로그 포스팅을 자동화하거나 자동 글 생성을 구축할 때 가장 신경 쓰이는 요소 중 하나가 바로 대표 이미지입니다. 그동안 나는 별도의 인증 없이 간편하게 사용할 수 있었던 Pollinations 무료 익명 등급을 활용해 블로그 대표 이미지를 생성하고 있었습니다.

    하지만 최근 들어 생성된 이미지의 화질이 심각하게 저하되는 현상이 지속되었습니다. 해상도가 뭉개지거나, 분명 IT 주제의 키워드를 넣었는데 전혀 무관한 뚱딴지같은 그림이 출력되는 일이 비일비재했습니다.

    흐릿한 이미지를 모니터로 확인하며 개발 문제를 분석하는 일러스트

    처음에는 단순히 프롬프트 문제인 줄 알고 영문 프롬프트를 다듬고 스타일 옵션을 아무리 수정해 보았습니다. 그러나 프롬프트를 아무리 고쳐도 엔진 자체의 품질 저하 한계를 극복할 수는 없었습니다. 결국 프롬프트를 다듬는 대신 이미지 생성 엔진 자체를 교체하기로 마음먹었습니다.

    프롬프트를 고쳐도 해결 안 되던 화질 문제

    Pollinations 익명 등급은 초기 테스트용으로는 매우 훌륭한 선택지였습니다. 하지만 서비스 운영이 지속될수록 이미지 품질의 기복이 심해졌고, 결과물이 깨져 나오는 경우가 빈번해졌습니다.

    블로그 방문자에게 좋은 첫인상을 주어야 할 대표 이미지가 뭉개져 있으니 포스팅 전체의 완성도까지 떨어져 보였습니다. 이미지를 매번 수동으로 검수하고 다시 생성하는 작업도 1인 개발자에게는 큰 공수로 다가왔습니다.

    단순히 프롬프트 지시어를 길게 늘리는 방식으로는 한계가 명확했습니다. 근본적인 해결을 위해서는 더 뛰어난 성능과 신뢰성을 보장하는 전용 이미지 생성 모델로 전환하는 것이 필수적이었습니다.

    Gemini 이미지 생성 API 연동과 나노바나나 모델 도입

    대안을 찾던 중 Gemini 자체 이미지 생성 모델인 gemini-2.5-flash-image(일명 나노바나나)를 알게 되었습니다. 기존에 이미 텍스트 생성용으로 사용 중이던 GEMINI_API_KEY가 있었기에, 동일한 키로 곧바로 Gemini 이미지 생성 API 연동을 진행할 수 있었습니다.

    새로운 키를 발급받거나 추가 인증 과정을 거칠 필요가 없어서 연동 작업이 매우 매끄러웠습니다. 텍스트 요청과 유사한 구조로 API를 호출하여 이미지 생성 결과를 받아올 수 있었습니다.

    Gemini API와 블로그 시스템이 깔끔하게 연동되는 모습을 나타낸 일러스트

    다만 이 부분은 나중에 다시 확인해 보니 예상과 달랐습니다. 이미지 모델은 무료 등급에서 제공되지 않아 결제 없이는 쓸 수 없었고, 결국 며칠 뒤 무료 할당량이 있는 다른 이미지 엔진으로 한 번 더 옮기게 됐습니다. 연동 후 테스트로 만들어진 이미지들을 확인해 보니 이전과는 비교할 수 없을 정도로 또렷하고 키워드의 의도를 정확히 반영한 결과물이 나왔습니다.

    안정성을 위한 이미지 생성 폴백 구조 완성

    새로운 엔진을 도입하면서 가장 공을 들인 부분은 시스템의 안정성입니다. 구체적으로는 fetchGeminiNativeImage() 함수를 신규로 작성하여 Gemini 모델을 우선적으로 호출하도록 구현했습니다.

    하지만 아무리 훌륭한 API라도 일시적인 네트워크 장애나 일일 할당량 초과 등으로 호출에 실패할 가능성이 존재합니다. 이를 대비해 실패 시 기존에 작성해 두었던 fetchPollinationsImage()로 자동 전환되는 이미지 생성 폴백 구조를 구축했습니다.

    안정적인 이중 폴백 구조를 나타내는 테크 스타일 일러스트

    이렇게 폴백 로직을 만들어두니 Gemini API 호출에 문제가 발생하더라도 최소한 이미지가 완전히 누락되는 불상사는 막을 수 있게 되었습니다. 메인 엔진의 뛰어난 화질을 누리면서도 예외 상황에 유연하게 대응할 수 있는 안전장치가 갖춰진 셈입니다.

    결론: 고민 대신 엔진을 바꾸길 잘했다

    결과적으로 화질 저하 문제로 머리를 싸매며 프롬프트만 수정하던 시간을 끝내고 엔진을 교체한 것은 최고의 선택이었습니다. 엔진을 한 번 더 바꾸게 됐지만, 이때 만들어 둔 폴백 구조 덕분에 교체 과정에서도 대표 이미지가 빠지는 일 없이 발행을 이어갈 수 있었습니다.

    자동화 로직에서 이미지 품질 때문에 고민 중이라면 프롬프트 조정에만 시간을 쏟기보다 메인 생성 엔진을 교체하고 이중 폴백 구조를 갖춰보시는 것을 추천합니다. 1인 개발 일지로서 이번 작업은 시스템 구조의 중요성을 다시 한번 깨닫게 해준 값진 경험이었습니다.

    APIIntegration FallbackSystem GeminiAPI ImageGeneration JavaScript WebDevelopment
    ← 이전 글
    최근 게시물
    다음 글 →
    이전 게시물
    ≡ 글 목록으로
    소개
    path
    J.Lab

    커리어와 삶의 방향을 탐색하며
    기록하는 공간입니다

    카테고리
    403 Forbidden Error 1 429 Error 1 Ad Exchange 1 Ad Layout Guide 1 ad-slot 1 adsense 2 AdSense 2 AdSense Bot Detection 1 AdSense CTR 1 AdSense Display Issue 1 adsense-optimization 1 AI Automation 1 AI Image Generation 1 ai-automation 2 ai-book-writing 1 ai-image-generation 1 AI-Prompting 1 ai-side-hustle 1 ai-workflow 1 ai-writing 1 AIAutomation 1 AIBlogAutomation 1 AICodeLog 1 AIContentGeneration 1 AIImageGeneration 1 AIWritingErrors 1 API Automation 2 API Retry Design 1 api-automation 1 API-Deprecation 1 api-error 1 api-fallback 1 api-integration 2 api-pagination 1 api-retry-strategy 1 api-troubleshooting 1 APIDebugging 1 APIError 1 APIErrorHandling 1 APIIntegration 3 APIQuotaOptimization 1 APITokenRenewal 1 apps-script-trigger 1 AppsScript 1 appsScriptAutomation 1 AutomatedBlogging 1 automation 5 Automation 4 Automation Queue 1 Automation Scheduler 1 Automation Troubleshooting 1 automation-error 1 automation-script 1 AutomationBug 1 AutomationTroubleshooting 1 Backoff Algorithm 1 Base64 Image 1 Base64Encoding 1 batch-processing 1 BatchProcessing 1 Blog Optimization 2 blog-automation 4 blog-customization 2 blog-migration 4 blog-monetization 1 Blog-Sorting 1 blog-strategy 1 blog-theme-customization 1 blog-workflow 1 blogautomation 1 BlogAutomation 4 Blogger 13 Blogger API 2 Blogger Automation 2 Blogger SEO 1 blogger-api 4 blogger-automation 1 blogger-customization 1 blogger-error-400 1 blogger-labels 1 blogger-seo 1 blogger-theme 1 blogger-theme-debug 1 blogger-tips 1 Blogger-Tips 1 blogger-xml 1 BloggerAPI 7 BloggerAutomation 1 BloggerBypath 1 BloggerCustomization 2 BloggerFavicon 1 BloggerPermalink 1 BloggerTemplate 1 BloggerTemplateEditing 1 BloggerTheme 3 BloggerThemeCustomization 1 BloggerXMLStructure 1 Blogging-Automation 1 BloggingTools 1 BlogQuality 1 BlogSpot 1 Bug Fix 1 bug-fix 1 bug-hunting 1 BWidgetBIncludable 1 card-overlay-css 1 CardClickHandler 1 career-advice 1 CDATA 1 checklist-template 1 clamping-text 1 Claude 1 claude-ai 3 claude-code 2 ClaudeChat 1 ClaudeCode 1 CLIPTokenLimit 1 CloudflareWorkersAI 1 CNAME 1 Code Cleanup 1 Code Integration 1 code-refactoring 1 codelog 1 CodeLog 1 codeRefactoring 1 CodeStack 1 coding-log 2 comment-classification 1 config-pattern 1 Content Strategy 1 Content-Marketing 1 content-monetization 1 content-strategy 1 content-writing 1 contentsequencing 1 ContentStrategy 1 context-management 1 cost-reduction 1 CSS 1 css-axis-rotation 1 css-bug-fix 1 CSS-Debugging 1 css-fix 1 css-flexbox 1 css-layout 3 css-logo 1 css-print 1 css-troubleshooting 1 CSSLayout 1 CSSOverlay 1 Custom Domain 1 custom-theme 1 data-backfill 1 data-parsing 1 data-synchronization 1 data-validation 1 DatabaseDesign 1 DataMigration 1 DataRecovery 1 DataValidation 1 DateInjection 1 debugging 2 Debugging 5 Debugging Log 1 DebuggingLog 1 derived-state 1 detail-page-design 1 dev-journey 2 dev-log 1 Developer-Blog 1 developer-career 1 DeveloperJourney 2 DevJourney 1 DevLog 1 digital-creator 1 digital-products 2 display-none-seo 1 DOM-Inspection 1 dom-manipulation 1 Domain Migration 1 DomainMigration 1 DOMAutomation 1 duplicate-content 1 dynamic-menu 1 ebook-marketing 2 ebook-planning 1 ebook-publishing 5 editing-tips 1 Error Handling 2 error-handling 1 Error-Handling 1 ErrorHandling 2 EventDispatch 1 Execution Timeout 1 ExecutionLimit 1 exponential-backoff 1 FactChecking 1 FallbackSystem 1 FaviconEmbedding 1 Feed-API 1 filesystem 1 Flat Illustration 1 flux-model 1 FluxModel 1 FreeAIImage 1 frontend 1 Frontend 1 frontend-developer 1 frontend-layout 1 frontend-tips 1 FrontEndDev 1 FrontendTips 1 GAS 1 GAS Blogger API 1 GAS Refactoring 1 GAS Trigger 1 gas-automation 2 gas-optimization 1 gas-trigger 1 GASTimeout 1 gasTriggerManagement 1 GCP Project Linkage 1 Gemini 1 Gemini API 2 gemini-api 1 GeminiAPI 3 GeminiPrompt 1 GeminiPromptEngineering 1 getBoundingClientRect 1 github-raw-url 1 GmailRestrictions 1 Google AdSense 1 Google Apps Script 12 Google Discover 1 google-apps-script 8 Google-Apps-Script 1 google-blogger 1 googleAppsScript 1 GoogleAppsScript 12 googlesapps-script 1 GoogleSearchConsole 1 grep 1 hero-image 1 hero-image-validation 1 HTML Fix 1 HTMLCSS 1 HTMLWidgetBlogger 1 http-429 1 HuggingFace 1 HuggingFaceAPI 1 ico-generator 1 Image Optimization 1 image-automation 2 image-generation 1 image-hosting 1 image-optimization 1 image-processing 1 image-upload 1 ImageGeneration 2 ImageIntegrity 1 ImageOptimization 1 In-App Browser 1 invalid-argument 1 javascript 4 JavaScript 4 javascript-automation 1 javascript-toc 1 JavaScriptDevLog 1 JavaScriptInjection 1 jlab-codelog 1 JLabDevLog 1 json-schema 1 label-length-limit 1 lead-magnet 1 legacy-code 1 LinkedIn-API 2 LinkedIn-OAuth 1 LinkHub 1 linux 1 markdown 1 meta-description 1 MetaTags 1 Migration 1 Migration Script 1 mobile-friendly 1 Mobile-Web 1 monetization 1 Monitoring Automation 1 MultilingualSEO 1 NakedDomain 1 Negative Prompt 1 node-js 1 nodejs-automation 1 noindex-tag 1 Notion API 1 notion-api 3 notion-database 2 notion-gas-integration 1 notion-setup 1 notion-template 1 NotionAPI 3 NotionAutomation 1 notionintegration 1 NotionIntegration 1 OAuth Scope 1 OpenGraph 1 padding-overlap 1 pagination 1 payload-validation 1 pdf-generation 1 pdf-publishing 1 pdf-selling 1 permalink-management 1 PersonaDesign 1 pil-image-processing 1 Pinterest 2 PinterestAutomation 1 PipelineFix 1 playwright 1 Pollinations 1 Pollinations Flux 1 pollinations-ai 1 pollinations-api 2 PollinationsAI 1 PositionAbsolute 1 post-queue 1 productivity-tools 1 Prompt Design 1 Prompt Engineering 1 prompt-engineering 3 Prompt-Engineering 1 prompt-validation 1 PromptEngineering 3 Publishing Flow 1 publishorder 1 python-favicon 1 python-markdown 1 python-pil 2 python-scripting 1 Queue Design 1 queue-pattern 1 queue-stuck 1 RandomDelay 1 rate-limiting 1 react 1 React 1 Refactoring 1 Resource Exhausted 1 responsive-ads 1 responsive-design 4 ResponsiveCSS 1 ResponsiveDesign 1 retrospective 1 rfc3339 2 Robots Meta Tag 1 RSS Feed 1 rss-feed 1 RSSProxy 2 SAXParseException 1 Script Authorization 1 scriptNotFound 1 SDXL 1 Search Engine Optimization 2 Search-Engine-Optimization 1 SearchConsole 1 Self Rescheduling Trigger 1 SEO 2 SEO Tips 1 seo-optimization 5 SEO-Optimization 1 SEOOptimization 2 seriesmanagement 1 serverless-automation 1 sessionstart-hook 1 shell-script 1 Side Ad Duplication 1 side-income 1 side-project 1 SidebarLinks 1 SNSMarketing 1 Social-Media-Automation 2 SocialSharing 1 state-management 1 StaticWebPage 1 sub-agent 1 SVG Icon 1 svg-mask 1 SVGIcon 1 Synchronization 1 table-of-contents 1 tech-blogging 1 TechJournal 1 TechVibe 1 Template 1 TextSanitization 1 threads-api 2 Threads-API-Comparison 1 ThreadsAPI 3 time-driven-trigger 1 Tistory 2 tistory-customization 1 tistory-migration 1 tistory-skin 1 tistory-theming 1 tistory-tips 1 TOC Ad Placement 1 token-optimization 1 TranslationAPI 1 transparent-favicon 1 triggerCleanup 1 troubleshooting 2 Troubleshooting 2 typesetting 1 ui-optimization 1 unzip 1 URL Slug 1 UrlFetchApp 1 usememo 1 UTF8Encoding 1 vanilla-js 1 Web Development 2 Web Publishing 2 Web Security 1 web-development 7 Web-Development 2 web-development-log 1 web-development-tips 1 web-layout 1 Web-Layout 1 web-performance 1 web-publisher 1 web-scraping 1 WebAccessibility 1 WebAutomation 1 WebDebugging 1 WebDesign 2 WebDevelopment 10 WebDevelopmentTips 1 WebDevJourney 1 WebMigration 1 windows 1 windows-task-scheduler 2 WorkAutomation 1 workflow-automation 1 WorkflowAutomation 1 writing-process 1 XHTML 1 XMLCustomization 1 XMLParser 1 XMLSpecialCharacters 1 XMLTheme 1 z-index-issue 1 zip 1
    인기 글
    GAS에서 Blogger API 403 오류 완전 정복 — appsscript.json 스코프와 GCP 프로젝트 연결
    GAS에서 Blogger API 403 오류 완전 정복 — appsscript.json 스코프와 GCP 프로젝트 연결
    GAS 트리거 방치했다가 오류 폭탄 맞은 이야기 — 함수명 바꿀 때 트리거도 꼭 같이 정리하세요
    GAS 트리거 방치했다가 오류 폭탄 맞은 이야기 — 함수명 바꿀 때 트리거도 꼭 같이 정리하세요
    Notion API page_size 함정 — 우선순위 항목이 조회에서 빠지는 이유와 해결법
    Notion API page_size 함정 — 우선순위 항목이 조회에서 빠지는 이유와 해결법
    다른 블로그
    IssueLog
    IssueLog
    issuelog.jinbytes.com
    KidStory
    KidStory
    kidstory.jinbytes.com
    IT Story
    IT Story
    jinbytes.com
    이야기하는 밤
    이야기하는 밤
    story.jinbytes.com
    [eBook] 개발자로 살아간다는 것
    [eBook] 개발자로 살아간다는 것
    유료 전자책
    [eBook] FE 실무 디테일
    [eBook] FE 실무 디테일
    유료 전자책
    [미니북] FE 실무 디테일
    [미니북] FE 실무 디테일
    무료 미니북
    © Jin's Lab · J.Lab · All Rights Reserved
    jinbytes.com · Powered by Blogger