---
title: "제작 시작(예산만큼 포인트를 먼저 잡는다)"
method: POST
path: "/runs"
---

# 제작 시작(예산만큼 포인트를 먼저 잡는다)

`POST /runs`

## Request

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

필요한 키 권한: run

## Request body

- object
  - `package` string, required: 패키지 slug
  - `input` object, required: 견적 때와 같은 입력값
  - `quote_id` string, required: 견적 id
  - `budget` integer, required: 예산 포인트(견적 minimum 이상)
  - `idempotency_key` string, required: 중복 제작을 막는 키(영숫자·_·- 8~96자)
  - `confirm` boolean, required: 견적 금액과 권리 확인·책임 안내(견적의 rights)에 사용자가 동의했으면 true
  - `use_coupon` boolean: 제작 쿠폰 사용
  - `external_consent` boolean: 외부 전송 동의(견적의 external 이 있을 때)
  - `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 `201`

시작한 제작

- object

## Other responses

- `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)