generate_video
Creates billed AI video generation jobs from prompts, enforces budgets, prevents duplicate charges, and saves outputs automatically. Returns a job ID to track status.
Instructions
영상 생성 작업을 만든다. 과금된다. 사용자가 영상 생성을 요청했을 때만 부른다.
기본값: 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 에 원래 모델을 적는다.
예상 비용이 설정 임계값 이상이면 서버가 사용자에게 직접 확인을 요청할 수 있다.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>"
},
"name": "generate_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | ||
| model | No | ||
| prompt | Yes | ||
| request_id | No | ||
| resolution | No | ||
| aspect_ratio | No | ||
| duration_sec | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||