VIDIA

내 비디아 포인트 잔액·쿠폰·요금제를 확인합니다. 무료입니다.

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

영상을 만들 수 있는 발행된 패키지(영상 제작 템플릿)를 찾습니다. 각 패키지의 예상 포인트·작업 시간이 함께 나옵니다. 무료입니다.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "검색어(제목·설명·태그)"
    },
    "format": {
      "type": "string",
      "description": "shorts | longform",
      "enum": [
        "shorts",
        "longform"
      ]
    },
    "mix": {
      "type": "string",
      "description": "결과물 구성: ai-video | mixed | ai-image",
      "enum": [
        "ai-video",
        "mixed",
        "ai-image"
      ]
    },
    "sort": {
      "type": "string",
      "description": "popular | recent | completed",
      "enum": [
        "popular",
        "recent",
        "completed"
      ]
    },
    "limit": {
      "type": "integer",
      "description": "최대 50",
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "type": "integer",
      "description": "건너뛸 수",
      "minimum": 0
    }
  },
  "required": [],
  "additionalProperties": false
}

패키지 한 개의 설명과 입력 칸(inputs)을 봅니다. 견적·제작의 input 은 이 칸의 key 로 채웁니다. 무료입니다.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "패키지 slug(vidia_list_packages 결과)"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

입력값으로 제작 견적(최소·권장 예산 포인트, 예상 비용·장면 계획)을 받습니다. 포인트가 차감되지 않습니다. 견적은 10분 동안 유효하고, 제작은 이 견적의 id 로만 시작할 수 있습니다.

{
  "type": "object",
  "properties": {
    "package": {
      "type": "string",
      "description": "패키지 slug"
    },
    "input": {
      "type": "object",
      "description": "입력 칸 key → 값(vidia_get_package 의 inputs)",
      "additionalProperties": true
    },
    "title": {
      "type": "string",
      "description": "프로젝트 이름(선택, 160자 이내)"
    },
    "mode": {
      "type": "string",
      "description": "진행 방식: AUTO(기본, 끝까지 자동) | MANUAL",
      "enum": [
        "AUTO",
        "MANUAL"
      ]
    },
    "problem_policy": {
      "type": "string",
      "description": "오류 처리: SKIP(기본) | ASK",
      "enum": [
        "SKIP",
        "ASK"
      ]
    },
    "loop_policy": {
      "type": "string",
      "description": "품질 미달 처리: ACCEPT(기본) | ASK",
      "enum": [
        "ACCEPT",
        "ASK"
      ]
    },
    "loop_retries": {
      "type": "integer",
      "description": "품질 미달 시 다시 만들기 횟수(0~5)",
      "minimum": 0,
      "maximum": 5
    }
  },
  "required": [
    "package",
    "input"
  ],
  "additionalProperties": false
}

견적을 사용자에게 보여 주고 동의를 받은 뒤에만 부르세요. budget 만큼 포인트를 먼저 잡아 두고 제작을 시작합니다(쓰지 않은 포인트는 끝나면 돌아옵니다). 견적 때와 같은 package·input·설정을 보내야 합니다. "제작 시작 허용" 권한 키가 필요합니다.

{
  "type": "object",
  "properties": {
    "package": {
      "type": "string",
      "description": "패키지 slug"
    },
    "input": {
      "type": "object",
      "description": "견적 때와 같은 입력값",
      "additionalProperties": true
    },
    "quote_id": {
      "type": "string",
      "description": "vidia_quote 결과의 id"
    },
    "budget": {
      "type": "integer",
      "description": "예산 포인트(견적 minimum 이상, 보통 recommended)",
      "minimum": 1
    },
    "idempotency_key": {
      "type": "string",
      "description": "같은 요청 재시도 때 중복 제작을 막는 키(영숫자·_·- 8~96자). 요청마다 새로 만들고 재시도 때는 그대로 씁니다."
    },
    "confirm": {
      "type": "boolean",
      "description": "사용자가 견적 금액을 확인하고 동의했으면 true",
      "const": true
    },
    "use_coupon": {
      "type": "boolean",
      "description": "제작 쿠폰을 쓸지(선택)"
    },
    "external_consent": {
      "type": "boolean",
      "description": "패키지가 외부 서비스로 요청을 보내는 경우(견적의 external), 사용자가 그 전송에 동의했으면 true"
    },
    "title": {
      "type": "string",
      "description": "프로젝트 이름(선택, 160자 이내)"
    },
    "mode": {
      "type": "string",
      "description": "진행 방식: AUTO(기본, 끝까지 자동) | MANUAL",
      "enum": [
        "AUTO",
        "MANUAL"
      ]
    },
    "problem_policy": {
      "type": "string",
      "description": "오류 처리: SKIP(기본) | ASK",
      "enum": [
        "SKIP",
        "ASK"
      ]
    },
    "loop_policy": {
      "type": "string",
      "description": "품질 미달 처리: ACCEPT(기본) | ASK",
      "enum": [
        "ACCEPT",
        "ASK"
      ]
    },
    "loop_retries": {
      "type": "integer",
      "description": "품질 미달 시 다시 만들기 횟수(0~5)",
      "minimum": 0,
      "maximum": 5
    }
  },
  "required": [
    "package",
    "input",
    "quote_id",
    "budget",
    "idempotency_key",
    "confirm"
  ],
  "additionalProperties": false
}

제작 한 건의 상태(대기·제작 중·완성·실패)·진행 단계·예상 남은 시간을 봅니다. 완성되면 vidia_get_downloads 로 받습니다. 무료입니다. 너무 자주 부르지 말고 30초 이상 간격으로 확인하세요.

{
  "type": "object",
  "properties": {
    "run_id": {
      "type": "integer",
      "description": "제작(프로젝트) 번호",
      "minimum": 1
    }
  },
  "required": [
    "run_id"
  ],
  "additionalProperties": false
}

내 제작(프로젝트) 목록을 최근 순으로 봅니다. 무료입니다.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "상태로 거르기",
      "enum": [
        "QUEUED",
        "RUNNING",
        "AWAITING_APPROVAL",
        "PAUSED",
        "COMPLETED",
        "FAILED",
        "CANCELLED"
      ]
    },
    "limit": {
      "type": "integer",
      "description": "최대 50",
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "type": "integer",
      "description": "건너뛸 수",
      "minimum": 0
    }
  },
  "required": [],
  "additionalProperties": false
}

진행 중이거나 대기 중인 제작을 취소합니다. 되돌릴 수 없으니 사용자에게 확인을 받은 뒤 부르세요. "제작 시작 허용" 권한 키가 필요합니다.

{
  "type": "object",
  "properties": {
    "run_id": {
      "type": "integer",
      "description": "제작 번호",
      "minimum": 1
    },
    "confirmed": {
      "type": "boolean",
      "description": "오류로 멈춘 제작을 전액 돌려받고 취소할 때(만든 파일이 지워짐) true"
    }
  },
  "required": [
    "run_id"
  ],
  "additionalProperties": false
}

내 자료실 파일(이미지·영상·소리)의 id 를 봅니다. 패키지 입력 칸 중 type 이 asset 인 칸에는 이 id 를 넣습니다(여러 장이면 배열). 파일 올리기는 웹 자료실이나 REST·SDK(POST /api/v1/assets)로 합니다. 무료입니다.

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "description": "image | video | audio",
      "enum": [
        "image",
        "video",
        "audio"
      ]
    },
    "q": {
      "type": "string",
      "description": "이름 검색"
    },
    "limit": {
      "type": "integer",
      "description": "최대 200",
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [],
  "additionalProperties": false
}

완성된 제작의 결과물(완성 영상·썸네일·자막 등)과 1시간 동안 쓸 수 있는 다운로드 링크, 게시용 제목·설명을 받습니다. 무료입니다.

{
  "type": "object",
  "properties": {
    "run_id": {
      "type": "integer",
      "description": "제작 번호",
      "minimum": 1
    }
  },
  "required": [
    "run_id"
  ],
  "additionalProperties": false
}