Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FAL_KEYNofal API key (API scope; do not use ADMIN scope).
CAPPED_VIDEO_HOMENoData folder location; absolute path, only via registration env (not effective in .env). Example: D:/capped-video.
CAPPED_VIDEO_FFMPEGNoPath to ffmpeg for previews; empty uses PATH (preview.ffmpeg). Example: C:/ffmpeg/bin/ffmpeg.exe.
REPLICATE_API_TOKENNoReplicate API token.
CAPPED_VIDEO_FAILOVERNoSwitch to fallback_model on confirmed rejection (limits.failover). Example: true.
CAPPED_VIDEO_PROVIDERNoSet to 'mock' to avoid real API calls; other values are errors. Example: mock.
CAPPED_VIDEO_OUTPUT_DIRNoDirectory to save videos; relative paths are relative to the data folder (download.dir). Example: ~/Videos/capped-video.
CAPPED_VIDEO_DAILY_MAX_USDNoDaily maximum budget in USD (limits.daily_max_usd). Example: 5.
CAPPED_VIDEO_DEFAULT_MODELNoDefault model (defaults.model). Example: kling-3.0.
CAPPED_VIDEO_MAX_RESOLUTIONNoMaximum allowed resolution (limits.max_resolution). Example: 720p.
CAPPED_VIDEO_DAILY_MAX_COUNTNoDaily maximum job count (limits.daily_max_count). Example: 10.
CAPPED_VIDEO_MONTHLY_MAX_USDNoMonthly maximum budget in USD (limits.monthly_max_usd). Example: 30.
CAPPED_VIDEO_CONFIRM_FALLBACKNoBehavior when the client does not support confirmation: allow or deny (limits.confirm_fallback). Example: allow.
CAPPED_VIDEO_MAX_DURATION_SECNoMaximum allowed duration in seconds (limits.max_duration_sec). Example: 10.
CAPPED_VIDEO_MAX_PENDING_JOBSNoMaximum number of pending jobs (limits.max_pending_jobs). Example: 3.
CAPPED_VIDEO_CONFIRM_ABOVE_USDNoThreshold in USD above which the server asks the user to confirm before generation; 0 disables (limits.confirm_above_usd). Example: 0.5.
CAPPED_VIDEO_DEFAULT_RESOLUTIONNoDefault resolution (defaults.resolution). Example: 480p.
CAPPED_VIDEO_DEFAULT_ASPECT_RATIONoDefault aspect ratio (defaults.aspect_ratio). Example: 9:16.
CAPPED_VIDEO_DEFAULT_DURATION_SECNoDefault duration in seconds (defaults.duration_sec). Example: 5.
CAPPED_VIDEO_DUPLICATE_WINDOW_MINUTESNoTime window in minutes for treating identical requests as duplicates; 0 disables (limits.duplicate_window_minutes). Example: 10.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

영상 생성 서버입니다. generate_video 는 과금되므로 사용자가 요청할 때만 부르세요. 생성 후에는 get_video_status 로 완료를 확인합니다. 완료된 영상은 서버가 출력 폴더에 자동 저장하고, get_video_status 가 파일 경로를 알려 줍니다. 결과 수거는 이 서버(세션)가 켜져 있는 동안에만 일어납니다. 생성 중에는 세션을 닫지 않는 것이 좋습니다. 오류 메시지가 "다시 보내지 마세요"라고 하면 같은 요청을 반복하지 마세요 (이중 과금 위험). 모델·가격은 list_models, 남은 예산은 get_usage 로 확인합니다. 어떤 모델이 얼마인지, 예산 안에서 가장 싼 모델이 무엇인지는 estimate_video (무료) 로 먼저 봅니다. 완성된 영상은 preview_video (무료) 로 프레임 이미지를 받아 결과가 요청과 맞는지 눈으로 확인합니다.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
generate_videoA

영상 생성 작업을 만든다. 과금된다. 사용자가 영상 생성을 요청했을 때만 부른다.

    기본값: config.toml 의 defaults (seedance-2.5 / Replicate, 480p, 5초, 16:9).
    모델마다 허용 해상도·길이·화면 비율과 가격이 다르다. 다른 모델을 쓰기 전에 list_models 로 확인한다
    (예: veo 는 4·6·8초, wan 은 5·10초, hailuo 는 6·10초만). 지정하지 않으면 모델에 맞는 가장 싼 값을 고른다.
    자동 길이는 허용하지 않는다. 일일·월간 예산을 넘으면 거부한다.
    job_id 를 반환한다. 완료되면 서버가 출력 폴더에 자동 저장하며, get_video_status 로 확인한다.
    오류가 "다시 보내지 마세요"라고 하면 같은 요청을 반복하지 않는다.
    같은 요청(프롬프트·모델·해상도·길이·비율)이 최근에 이미 접수됐으면 새 작업을 만들지 않고 기존 job_id 를
    duplicate=true 로 돌려준다 (과금 없음). request_id 를 주면 그 값으로도 중복을 잡는다.
    사용자가 같은 영상을 하나 더 원할 때만 force=true 를 쓴다.
    1차 제공처가 요청을 확정 거부하면 대체 모델로 만들고 failover_from 에 원래 모델을 적는다.
    예상 비용이 설정 임계값 이상이면 서버가 사용자에게 직접 확인을 요청할 수 있다.
    
get_video_statusA

작업 상태를 확인한다. 과금되지 않는다.

    완료될 때까지 최대 wait_seconds(상한 60초) 동안 기다린다.
    status 가 queued/running/downloading 이면 이 도구를 다시 부른다.
    succeeded 이면 file 에 저장된 영상 경로가 있다.
    
download_videoA

내려받지 못한(lost) 작업의 다운로드를 다시 시도하거나, 완료된 파일 경로를 돌려준다. 과금되지 않는다.

보통은 서버가 자동으로 내려받으므로 부를 필요가 없다. URL 이나 경로는 받지 않는다.

get_usageA

오늘·이번 달 생성 횟수와 예상 비용, 상한, 진행 중인 작업 수를 돌려준다.

preview_videoA

완성된 영상의 프레임 여러 장을 한 이미지로 붙여 돌려준다. 과금되지 않는다.

    영상을 직접 볼 수 없으니 이 이미지로 결과가 요청과 맞는지 확인한다. 왼쪽 위부터 오른쪽 아래로 시간 순서다.
    succeeded 상태에서만 만들 수 있다. ffmpeg 가 없으면 preview_available=false 와 이유를 돌려준다.
    
estimate_videoA

과금 없이 비용을 견적한다. 조건(길이·해상도·화면 비율)에 맞는 모델을 싼 순서로, 남은 예산과 함께 돌려준다.

    generate_video 를 부르기 전에 모델을 고르거나 예산이 충분한지 볼 때 쓴다. cheapest 는 예산 안에서 가장 싼 모델.
    조건을 지정하지 않으면 모델별 가장 싼 값을 가정한다. 조건을 만족하지 못하는 모델은 unavailable 에 이유와 함께 나온다.
    prompt 를 주면 같은 요청이 최근에 있었는지(duplicate_of)도 알려 준다.
    
list_modelsA

사용할 수 있는 모델, 해상도별 초당 가격(USD), 길이 범위, 기본값을 돌려준다.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.2/5.0

Scored across 7 tools

Disambiguation5/5

Each tool targets a distinct lifecycle stage: pricing (estimate_video/list_models), creation (generate_video), polling (get_video_status), recovery (download_video), inspection (preview_video), and budget (get_usage). The descriptions explicitly state when NOT to call a tool (download_video: 'usually unnecessary'; generate_video: only when user requests creation), which removes the main overlap risk. The paid-vs-free distinction is stated on every tool.

Naming Consistency5/5

All names follow a consistent snake_case verb_noun pattern: generate_video, estimate_video, preview_video, download_video, list_models, get_usage, get_video_status. The only minor variation is the three-part get_video_status, which still fits the scheme.

Tool Count5/5

Seven tools map cleanly onto one domain (generate, check, fetch, preview, price, list, budget) with no filler. Each tool earns its place, and none could be merged without losing a distinct paid/free or blocking/non-blocking behavior.

Completeness4/5

The generation lifecycle is well covered: model discovery, cost estimation, creation, polling, recovery download, preview, and budget tracking. Missing operations are cancel/abort for an in-flight paid job and a list of past jobs; today an agent must retain job_ids itself, though this is a workable gap.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues