CheaperGen API 문서

MCP

AI 에이전트로 생성하기

Claude, ChatGPT, Cursor 또는 Codex에 동영상이나 이미지를 요청하면 잔액에서 결제해 생성합니다. 이 내용을 에이전트에 한 번 붙여넣으세요.

Set up CheaperGen for me by following https://cheapergen.com/agents/setup.md

프롬프트 복사

Setup for each agent

lib/cheapergen.ts

export async function generate(prompt) {
  const res = await fetch(`${BASE}/run/${MODEL}`, {
    headers: { Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}` },
    body: JSON.stringify({ prompt, max_cost_usd: 1 }),

REST API

코딩 에이전트로 개발하기

Claude Code, Cursor 또는 Codex가 앱에서 API를 호출하는 코드를 작성합니다. API 키는 환경 변수에 저장하며 무료 테스트도 제공합니다.

Add CheaperGen video and image generation to this project by following https://cheapergen.com/agents/integrate.md

프롬프트 복사

에이전트가 읽는 내용

직접 코드를 작성하시나요? 빠른 시작·코드 작성 없이 시작하려면? Studio 열기

기본 URL#

모든 엔드포인트는 버전이 지정된 단일 기본 URL을 사용합니다. 요청과 응답은 HTTPS를 통한 JSON 형식이며 금액은 미국 달러로 표시됩니다.

사용 방법#

1. 생성 작업을 시작하려면 제출 요청을 보내세요. 요금은 선불 잔액에서 보류되며, 응답에는 POST /api/v1/run/{endpoint}과 status: "queued"가 포함된 생성 객체가 반환됩니다(HTTP 202).
2. 대기 완료까지 기다리세요. 몇 초마다 GET /api/v1/generations/{id}을 조회하거나 webhook_url를 전달하면 결과를 POST로 보내 드립니다. 자세한 내용: 생성 내역.
3. 다운로드에서 output.video.url 또는 output.images[].url로 결과물을 가져오세요. 작업이 실패하면 보류 금액은 자동 환불되므로 실패한 생성에는 비용이 들지 않습니다.

curl -X POST https://cheapergen.com/api/v1/run/bytedance/seedance-2.0-fast/text-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "골든아워에 꽃병을 빚는 도예가에게 천천히 다가가는 카메라, 빛 속 먼지 입자, 얕은 심도",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

모델#

모든 모델은 작업별 엔드포인트 하나를 제공하며 (예: 텍스트→동영상, 이미지→동영상), 각 엔드포인트는 모델 입력값과 선택적 webhook_url을 받습니다. 모델 페이지에서 전체 목록과 가격을 보거나 GET /api/v1/models로 가져오세요.

• 동영상: Seedance 2.0, Seedance 2.5, Seedance 2.0 Fast, Seedance 2.0 Mini, Kling 3.0, Kling 3.0 Omni, Kling 3.0 Turbo, Veo 3.1, Veo 3.1 Fast, Veo 3.1 Lite, Gemini Omni Flash, Wan 3.0, Wan 3.0 Prime, MiniMax H3, MiniMax H3 Max, MiniMax H3 Fast, Vidu Q3 Turbo, Vidu Q3 Pro, Vidu Q4, Grok Imagine Video 1.5, FLUX 3 Video, PixVerse V6, LTX-2.5
• 이미지: Seedream 4.5, Seedream 5.0 Pro, Seedream 5.0 Lite, Seedream 5.0 Flash, Nano Banana Pro, Nano Banana 2.1, GPT Image 2.5, GPT Image 2.5 Flare, FLUX 3, FLUX 3 Image Klein, FLUX.2 [klein] 4B, FLUX.2 [pro], FLUX.2 [max], FLUX.2 [flex], FLUX.1 Kontext [pro], FLUX.1 Kontext [max], Grok Imagine Image 2.0, Qwen-Image 3.0 Pro, Qwen-Image 3.0, Z-Image Turbo, Krea 2 Turbo, MOSS Image

규칙#

• Authorization: Bearer cg_live_…로 인증하세요 — 자세한 내용: 인증.
• 생성 ID는 gen_ 접두사로 시작합니다. 타임스탬프는 UTC ISO 8601 형식입니다. 금액 필드는 _usd로 끝나며 미국 달러의 소수 값입니다.
• 오류는 항상 의미 있는 HTTP 상태 코드와 함께 { "error": { "code", "message", "param" } } 형식으로 반환됩니다. 자세한 내용은 오류 처리에서 확인하세요.
• 요청에 알 수 없는 매개변수가 있으면 400 invalid_request 오류로 거부됩니다. 오타가 있어도 결과가 조용히 달라지지 않습니다.
• 공개 엔드포인트 (/models, /quote)는 API 키 없이 사용할 수 있어 브라우저에서 호출해도 안전합니다.

AI 에이전트 및 LLM용#

API와 모든 모델을 기계가 읽을 수 있는 형식으로 정리한 정보는 /llms.txt에서 확인할 수 있습니다. 각 모델 페이지에는 같은 카탈로그에서 생성한 전체 입력 스키마가 있습니다.

에이전트가 CheaperGen을 직접 호출할 수도 있습니다. 호스팅된 MCP 서버을 Claude Code, ChatGPT, Codex, Cursor 또는 VS Code에 연결하거나 CheaperGen 에이전트 스킬을 설치하세요. 코딩 에이전트에게 자신의 프로젝트에 API를 추가하게 하려면 위의 “코딩 에이전트” 문장을 붙여넣으세요. /agents/integrate.md를 따릅니다.