---
title: "견적을 받아 권장(또는 최소) 예산이 max_budget 이하이면 바로 시작 — 넘거나 외부 전송 동의가 없으면 시작하지 않고 started: false 와 견적"
method: POST
path: "/runs/quote-and-start"
---

# 견적을 받아 권장(또는 최소) 예산이 max_budget 이하이면 바로 시작 — 넘거나 외부 전송 동의가 없으면 시작하지 않고 started: false 와 견적

`POST /runs/quote-and-start`

## Request

- Base URL: `https://vidia.kr/api/v1`
- URL: `https://vidia.kr/api/v1/runs/quote-and-start`
- Auth: HTTP bearer

필요한 키 권한: run

## Request body

- object
  - `package` string, required: 패키지 slug
  - `input` object, required: 입력 칸 key → 값
  - `max_budget` integer, required: 사용자가 동의한 최대 예산 포인트
  - `budget_policy` 'recommended' | 'minimum': 잡을 예산(기본 recommended)
  - `idempotency_key` string, required: 중복 제작을 막는 키(영숫자·_·- 8~96자)
  - `confirm` boolean, required: 사용자가 max_budget 과 권리 확인·책임 안내에 동의했으면 true
  - `use_coupon` boolean: 제작 쿠폰 사용
  - `external_consent` boolean: 외부 전송 동의
  - `price_tolerance` 0 | 5 | 10 | 20 | 30: 시가 변동 허용(예산 대비 %)
  - `auto_resolve` boolean: 예산 상한에 닿으면 남은 유료 단계를 건너뛰고 이어 갈지(기본 true)
  - `agent_support` boolean: 비디아 에이전트 서포트 — 완성 직전 자동 점검·수리(기본 true, 끄는 것은 권장하지 않음. 유료 수리는 남은 예산 안에서만)
  - `publish_pack` boolean: 게시 묶음 — 완성 전에 업로드 키트(제목 후보·설명·태그·해시태그·썸네일 문구)와 제목 든 썸네일을 만든다(추가 비용 없음). 보내지 않으면 롱폼·숏폼 모두 켬
  - `test_scenario` 'complete' | 'fail' | 'budget' | 'review': 시험용 키일 때만: 재현할 흐름
  - `title` string: 프로젝트 이름(160자 이내)
  - `mode` 'AUTO' | 'MANUAL': 진행 방식
  - `problem_policy` 'SKIP' | 'ASK': 오류 처리
  - `loop_policy` 'ACCEPT' | 'ASK': 품질 미달 처리
  - `loop_retries` integer: 품질 미달 시 다시 만들기 횟수
  - `scheduled_at` string: 예약 시작 시각(ISO 8601)

## Response `200`

시작하지 않음(started: false·reason·quote) 또는 이미 시작한 제작(reused: true)

- object

## Other responses

- `201`: 시작함(started: true·quote·run)
- `401`: 오류
- `402`: 오류
- `403`: 오류
- `404`: 오류
- `409`: 오류
- `422`: 오류
- `429`: 오류

---

[API](https://skmtc.dev/vidia/apis/api.md) · [All operations](https://skmtc.dev/vidia/apis/api/llms.txt) · [OpenAPI document](https://skmtc.dev/vidia/apis/api/revisions/884ff1a585a6?raw)