문서/고급/커스텀 가격 전략
AI: $0.01사람: 무료

커스텀 가격 전략

콘텐츠 유형, 복잡도, 사용 패턴에 따른 동적 가격 책정을 구현하세요.

안내: 브라우저에서 이 페이지를 보고 있다면 무료입니다! AI 에이전트가 프로그래밍 방식으로 이 페이지에 접근하면 $0.01 USDC가 부과됩니다.

참고: 아래 코드 예제들은 동적 가격 책정의 개념적 구현을 보여줍니다. 실제 구현은 사용하는 프레임워크와 x402 SDK 버전에 따라 달라질 수 있습니다.

동적 가격 책정

고정 가격 대신 다양한 요소에 기반한 동적 가격 책정을 구현할 수 있습니다.

전략 1

콘텐츠 기반 가격

콘텐츠 길이에 따라 가격을 동적으로 결정합니다. 긴 콘텐츠일수록 AI가 더 많은 가치를 얻으므로 높은 가격을 책정합니다.

// x402.config.ts
// 콘텐츠 길이에 따라 가격을 동적으로 결정하는 예제입니다.

export const x402Config = {
  // USDC를 받을 지갑 주소
  wallet: "0x...",

  // 동적 가격 결정 함수
  // path: 요청된 URL 경로 (예: "/docs/api/users")
  // metadata: 페이지 메타데이터 (wordCount, category 등)
  getPricing: (path: string, metadata: any) => {
    // 콘텐츠의 단어 수를 기준으로 가격 책정
    // metadata.wordCount는 빌드 시 자동 계산됩니다
    const wordCount = metadata.wordCount || 0;

    // 5000단어 초과: 상세한 기술 문서 → $0.05 (5센트)
    if (wordCount > 5000) return 0.05;

    // 1000~5000단어: 일반적인 가이드 → $0.02 (2센트)
    if (wordCount > 1000) return 0.02;

    // 1000단어 미만: 짧은 레퍼런스 → $0.01 (1센트)
    return 0.01;
  },
};
전략 2

시간 기반 가격

피크 시간대(트래픽이 많은 시간)에는 높은 가격을 책정합니다. 수요-공급 원칙에 따른 동적 가격 전략입니다.

// 시간대별 가격 차등 적용 예제

getPricing: (path: string) => {
  // 현재 시간을 UTC 기준으로 가져옵니다
  const hour = new Date().getUTCHours();

  // 미국 업무 시간대 (UTC 14:00-22:00 = PST 6:00-14:00)
  // 이 시간대에 AI 에이전트 요청이 가장 많습니다
  const isPeakHour = hour >= 14 && hour <= 22;

  // 피크 시간: $0.02 (2센트)
  // 비피크 시간: $0.01 (1센트) - 50% 할인 효과
  return isPeakHour ? 0.02 : 0.01;
};
전략 3

사용량 기반 가격

자주 사용하는 AI 에이전트에게 볼륨 할인을 제공하여 지속적인 사용을 유도합니다.

// 사용량 기반 볼륨 할인 예제

getPricing: async (path: string, context: RequestContext) => {
  // context에서 AI 에이전트의 고유 ID를 추출
  // 이 ID는 결제 서명에서 자동으로 파싱됩니다
  const { aiAgentId } = context;

  // 데이터베이스에서 이 에이전트의 월간 사용량 조회
  // getUsage()는 직접 구현해야 하는 함수입니다
  const monthlyUsage = await getUsage(aiAgentId);

  // 볼륨 할인 티어:
  // 10,000회 초과: 50% 할인 → $0.005 (0.5센트)
  if (monthlyUsage > 10000) return 0.005;

  // 1,000~10,000회: 20% 할인 → $0.008 (0.8센트)
  if (monthlyUsage > 1000) return 0.008;

  // 1,000회 미만: 기본 가격 → $0.01 (1센트)
  return 0.01;
};

콘텐츠 카테고리별 가격표

콘텐츠를 분류하고 가치에 따라 가격을 책정하세요.

카테고리예시권장 가격
시작하기설치, 빠른 시작무료 또는 $0.005
API 레퍼런스메서드 문서$0.01
튜토리얼단계별 가이드$0.02
고급 주제아키텍처, 베스트 프랙티스$0.03-0.05
엔터프라이즈스케일링, 보안$0.05-0.10

티어별 접근 구현

경로 패턴을 기반으로 선언적 가격 정책을 정의합니다.

// middleware.ts
// 티어(등급)별 가격 정책을 선언적으로 정의하는 예제입니다.
// 콘텐츠의 가치에 따라 4단계로 가격을 차등 적용합니다.

import { x402Middleware, TieredPricing } from "x402-middleware";

// TieredPricing 클래스로 경로별 가격 매핑 생성
const pricing = new TieredPricing({
  tiers: {
    // =====================================
    // 무료 티어 (Free Tier)
    // =====================================
    // 진입 장벽을 낮추기 위해 시작 문서는 무료로 제공
    // AI 에이전트도 이 경로는 무료로 접근 가능
    free: {
      paths: ["/docs/getting-started/**", "/docs/installation"],
      price: 0,  // $0.00 - 완전 무료
    },

    // =====================================
    // 기본 티어 (Basic Tier)
    // =====================================
    // API 레퍼런스, 가이드 등 일반적인 문서
    // 대부분의 요청이 이 티어에 해당
    basic: {
      paths: ["/docs/api/**", "/docs/guides/**"],
      price: 0.01,  // $0.01 (1센트) - 기본 가격
    },

    // =====================================
    // 고급 티어 (Advanced Tier)
    // =====================================
    // 아키텍처, 베스트 프랙티스 등 심화 내용
    // 더 높은 가치를 제공하므로 2배 가격
    advanced: {
      paths: ["/docs/advanced/**"],
      price: 0.02,  // $0.02 (2센트)
    },

    // =====================================
    // 엔터프라이즈 티어 (Enterprise Tier)
    // =====================================
    // 스케일링, 보안, 규정 준수 등 전문 내용
    // 기업용 고가치 콘텐츠에 프리미엄 가격 적용
    enterprise: {
      paths: ["/docs/enterprise/**"],
      price: 0.05,  // $0.05 (5센트) - 프리미엄 가격
    },
  },
});

// 설정된 pricing 객체를 미들웨어에 전달
// 요청이 들어오면 자동으로 경로를 매칭하여 가격 적용
export const middleware = x402Middleware({ pricing });

베스트 프랙티스

1

낮은 가격으로 시작

$0.01로 시작하고 수요에 따라 조정하세요. 초기에는 접근성을 높이는 것이 중요합니다.

2

시작 문서는 무료로

Getting Started 문서를 무료로 제공하여 진입 장벽을 낮추세요.

3

가치 기반 가격 책정

엔터프라이즈 콘텐츠는 더 높은 가격을 책정할 수 있습니다. 콘텐츠의 가치를 반영하세요.

4

모니터링 및 조정

분석 데이터를 활용하여 가격을 최적화하세요. 사용 패턴을 관찰하고 대응하세요.

프로 팁

가장 성공적인 프로젝트들은 기본 문서를 $0.01로, 특화된 엔터프라이즈 콘텐츠는 $0.05 이상으로 책정합니다. 이렇게 하면 접근성과 수익을 모두 극대화할 수 있습니다.