당신의 에이전트가 AI 이미지 또는 비디오 모델(OpenAI, Google, Runway, fal)을 호출하면, 몇 초 후 URL이나 base64 블롭(blob)을 돌려받습니다. 작업이 끝난 것처럼 느껴지겠지만, 그렇지 않습니다. 그 가공되지 않은 출력물은 아마 만료될 것이고, 목적지에 맞지 않는 크기와 형식을 가지고 있으며, 무엇이 그것을 만들었는지에 대한 기록도 없고, 당신의 브랜드 기준에 맞는지 확인한 사람도 없습니다. 그리고 에이전트이기 때문에, 이 모든 것을 수정하기 위해 대기 중인 사람도 없습니다.

사라지는 URL이 모든 관심을 끌지만, 이는 "모델이 응답했다"와 "이것을 배포할 수 있다" 사이의 여러 단계 중 첫 번째 단계일 뿐입니다. 전체 경로는 다음과 같습니다.

다루는 내용: 주요 API에서 생성된 미디어가 만료될 때 발생하는 일, "프로덕션 준비 완료(production-ready)\

공정하게 말하자면, 지형이 변화하고 있습니다. fal.ai는 이제 fal Assets를 제공하여, 생성물이 만료되는 대신 지속적으로 유지되도록 하며, Leonardo와 같은 플랫폼은 결과물을 무기한 보관합니다. OpenRouter의 Unified Image API와 같은 라우팅 레이어(routing layer)조차 수십 개의 모델에 걸쳐 하나의 엔드포인트(endpoint)를 제공하지만, 라우터로서 아무것도 저장하지 않기 때문에 지속성(persistence) 문제는 여전히 사용자가 해결해야 할 과제로 남습니다.

하지만 만료 문제를 해결하는 것은 단지 0단계의 문제를 해결하는 것뿐입니다. 특정 벤더(vendor)의 라이브러리에 영구적으로 존재하는 파일이라 할지라도, 여전히 최적화되지 않았고, 브랜드화되지 않았으며, 사용 중인 여러 제공업체에 흩어져 있고, 해당 벤더의 UI만큼만 검색이 가능합니다. 어려운 점은 단순히 바이트(bytes)를 '유지하는' 것만이 아니었습니다.

자율 에이전트(autonomous agents)가 미디어 지속성을 더 어렵게 만드는 이유

사람이 웹 UI에서 이미지를 생성할 때는, 그 자리에서 바로 다운로드하고, 자르고, 브랜드를 확인하고, 적절한 위치에 배치할 수 있습니다. 에이전트 워크플로(Agentic workflows)는 이러한 안전망 전체를 제거합니다.

에이전트는 백그라운드에서 실행됩니다. 모델을 호출하고, 결과를 얻고, 다음 단계로 넘어갑니다. 결과물은 상태 객체(state object)나 데이터베이스 행(row)에 저장되며, 한참 뒤에나 확인됩니다. 훌륭한 에이전트 상태(agent-state) 설계에서는 대규모 아티팩트(artifacts)를 파일로 저장하고 상태에는 경로(path)만 유지하라고 조언합니다. 타당한 조언이지만, 이는 파일이 영구적이고 사용 가능한 어딘가에 있다는 것을 전제로 합니다. 가공되지 않은 모델 URL(raw model URL)은 둘 다 아닙니다. 따라서 사람이 수동으로 수행했을 모든 단계가 이제 생성 시점에 자동으로 이루어져야 합니다. 그것이 실제 작업입니다.

"프로덕션 준비 완료(production-ready)"의 실제 의미

생성된 미디어를 배포하기 전에 반드시 충족되어야 하는 조건들을 핵심만 추려보면 다음과 같습니다:

1. 지속성 (Persisted): 생성되는 즉시 캡처되어, 만료되는 URL에 의존하지 않아야 합니다.
2. 최적화 및 변환 (Optimised & transformed): 각 목적지에 맞는 적절한 형식과 크기를 갖춰야 합니다. 4 MB PNG 파일은 40 KB WebP 썸네일, 소셜 미디어용 크롭 이미지, 최신 브라우저용 AVIF 등으로 변환되어야 합니다. 비디오는 더 까다롭습니다. 하나의 마스터 파일로부터 MP4/WebM으로의 트랜스코딩 (transcoding), 적응형 HLS/DASH 스트림, 포스터 프레임, 그리고 종종 편집된 컷(trimmed cut)까지 생성해야 합니다.
3. 전송 (Delivered): CDN을 통해 빠르게 제공되어야 하며, 비디오는 한 지역에서 통째로 전송되는 대신 적응형으로 스트리밍되어야 합니다.
4. 브랜드 일치 (On-brand): 고객이 보기 전에 브랜드 규칙에 부합하는지 확인해야 합니다. 브랜드 가드레일 (brand guardrail) 없이 고객용 미디어를 생성하는 에이전트 (agent)는 가설적인 위험이 아니라 실제적인 위험입니다.
5. 검색 가능성 (Findable): 프롬프트 (prompt), 모델 (model), 사용 사례 (use-case), 태그 (tags), 그리고 비디오의 경우 재생 시간 및 자막과 같은 메타데이터 (metadata)와 함께 저장되어야 합니다. 자신의 출력물을 검색할 수 없는 에이전트는 동일한 것을 두 번 다시 생성하게 됩니다.

이 중 하나라도 놓친다면 그것은 에셋 (asset)이 아니라, 가공되지 않은 출력물 (raw output)과 할 일 목록 (to-do list)일 뿐입니다.

이것은 사실상 에셋 파이프라인 (asset pipeline)입니다

이러한 요구 사항들은 이미 전통적인 미디어 워크플로 (media workflows)에 존재합니다. AI 생성 기술이 파이프라인을 없앤 것이 아니라, 단지 첫 번째 단계를 자동화했을 뿐입니다. 에이전트 (agent)는 그 간극을 수동으로 메워줄 사람이 더 이상 남아있지 않기 때문에 이 과정을 더욱 명확하게 만듭니다.

미디어 파이프라인 직접 구축하기

모두가 시도하는 패턴은 단순해 보입니다:

생성 → 바이트 (bytes) 다운로드 → 오브젝트 스토어 (object store)로 푸시 → 해당 위치에서 서비스

스토어는 보통 S3, Cloudflare R2, 또는 Supabase이며, 그 메커니즘은 이미 잘 알려져 있습니다. 하지만 바이트를 지속시키는 것은 쉬운 ~60%의 과정일 뿐입니다. 여러분이 해결해야 할 남은 과제는 다음과 같습니다:

• 모든 생성 경로에서의 Glue code (접착 코드), 다운로드 도중 URL이 만료될 경우를 대비한 재시도 로직 포함 (대용량 비디오 파일의 경우 상황이 더 악화됨).
• 변환 서비스 (Transformation service) (Lambda + sharp, imgix) 및, 비디오의 경우 스트리밍 가능한 렌더링(renditions)과 포스터 프레임을 위한 트랜스코딩 파이프라인 (Transcoding pipeline) (FFmpeg 또는 관리형 서비스).
• 비디오를 위한 적응형 스트리밍 (Adaptive streaming) 기능을 갖춘 전면의 CDN.
• 대부분의 파이프라인이 그냥 건너뛰는 브랜드 체크 (Brand check).
• 에셋을 계속 찾을 수 있도록 직접 구축하고 유지 관리해야 하는 메타데이터 저장소 (Metadata store).

여러분은 이를 충분히 조립할 수 있으며, 만약 저장 비용이 지배적이고 변환 요구 사항이 적다면 R2와 Worker를 조합하는 것이 합리적인 선택입니다. 다만, 여러분이 이제 단순한 버킷(bucket)이 아니라 작은 미디어 파이프라인(media pipeline)을 운영하고 있다는 사실을 솔직하게 인정해야 합니다.

두 개의 파이프라인, 하나의 호출

모델 단계는 어떤 방식이든 동일합니다. 차이점은 그 '이후'의 모든 것입니다.

아래의 생성 호출은 의도적으로 추상화되었습니다. generateMedia()가 OpenAI, Google, Runway, fal, 또는 OpenRouter 경로를 감싸고 있든 간에, 여러분이 손에 쥐게 되는 것은 동일합니다: 바로 이제 프로덕션 환경에 적용해야 하는 일시적인(ephemeral) URL입니다.

DIY 방식: 다운로드하고, 만료 시간과 경주(race)하며, 영구 저장한 다음, 나머지 파이프라인을 시작합니다.

import { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";
const s3 = new S3Client({ region: process.env.AWS_REGION });

...

플러그인 방식 (Pluggable way): 동일한 URL을 미디어 파이프라인에 전달하고 한 번의 호출로 프로덕션 에셋을 돌려받습니다. (이 예제는 Cloudinary를 사용하지만, 중요한 것은 그 구조입니다.)

import { v2 as cloudinary } from "cloudinary"; // CLOUDINARY_URL로부터 설정됨

const asset = await cloudinary.uploader.upload(await generateMedia(prompt), {
...

이는 바이트(bytes)를 가져오고(코드 내 만료 경합 문제 없음), 영구적인 원본을 저장하며, 요청 시 렌더링(renditions)을 생성하고, 메타데이터와 함께 태그를 지정합니다. resource_type: "video"를 전달하면, 즉시 변환(eager transforms) 기능이 이미지 크롭 대신 적응형 스트림(adaptive stream)과 포스터 프레임(poster frame)으로 작동합니다. 한 제공업체의 이미지든 다른 제공업체의 클립이든 동일한 호출 방식을 사용하므로, 에이전트는 모델별로 별도의 레시피를 요구하지 않고도 하나의 안정적이고, 브랜드화되었으며, 검색 가능한 URL을 보유하게 됩니다.

또는 에셋 플랫폼으로 직접 생성하기

만약 생성기(generator)와 에셋 플랫폼이 동일한 시스템이라면, 애초에 구조할 필요가 있는 일시적인(ephemeral) URL 자체가 존재하지 않습니다. 이것이 Cloudinary의 새로운 Image Generation API의 핵심 아이디어입니다. 이는 앞서 언급한 라우팅 레이어와 매우 유사하지만, 출력물이 사라지는 링크가 아닌 관리되는 에셋(managed asset)으로 저장된다는 점이 다릅니다. 최고 수준의 모델 제품군(FLUX.2, Nano Banana, GPT Image, Recraft, Ideogram)에 걸쳐 단일 text_to_image 엔드포인트를 제공합니다.

curl -X POST https://api.cloudinary.com/v2/generate/<CLOUD_NAME>/text_to_image \
  -u "<API_KEY>:<API_SECRET>" \
  -H "Content-Type: application/json" \
...

응답은 영구적인 secure_url과 함께 Cloudinary의 다른 모든 곳에서 사용하는 asset_id 및 public_id를 포함합니다. 이미지는 생성되는 즉시 영구 저장되고, 최적화 가능하며, 전달할 준비가 된 상태로 태어납니다. 즉, 생성(generation)과 프로덕션(production)이 하나의 단계로 통합됩니다. (Nano Banana 기본값을 사용하려면 model을 생략하세요. 영구 저장을 원하지 않는 경우 target은 수명이 짧은 임시 에셋으로 기본 설정됩니다.)

요약 (The takeaway)

솔직하게 말씀드리면: 단순히 가장 저렴한 버킷(bucket)이 필요한 것이라면, 순수 저장 비용 면에서는 R2가 승리하며, Supabase는 이제 기본적인 변환(transforms)과 CDN을 묶어서 제공합니다. 하지만 전체 작업(영구 저장, 변환, 전달, 브랜드 유지, 정리)이 중요하고, 다섯 가지를 오케스트레이션(orchestrate)하는 대신 한 번의 호출로 해결하고 싶다면 전체 미디어 플랫폼을 선택하십시오.

하지만 더 넓은 교훈은 그 어떤 제품 선택보다 오래 지속됩니다. 에이전트 시스템 (agentic system)에서 생성된 파일은 중간값 (intermediate value)이지, 최종 결과물 (deliverable)이 아닙니다. 모델은 하나의 구성 요소 (component)일 뿐, 결승선이 아닙니다. 가공되지 않은 출력물 (raw output)에서 프로덕션 에셋 (production asset)으로 가는 경로를 하나의 실제 파이프라인 (pipeline)으로 취급하십시오 (이를 버킷 (buckets), 워커 (workers), 트랜스코더 (transcoders), 메타데이터 테이블 (metadata table)으로 직접 구축하든, 이 다섯 가지를 모두 수행하는 무언가에 맡기든 상관없습니다). 그렇게 하면 여러분의 에이전트가 아무것도 없는 곳을 가리키는 링크를 저장하는 일이 중단될 것입니다.

Cloudinary ❤️ 개발자
미디어 워크플로 (media workflow)를 한 단계 업그레이드할 준비가 되셨나요? 지금 바로 Cloudinary를 무료로 사용해 보고 더 나은 시각적 경험을 구축해 보세요.
👉 무료 계정 생성하기