Open API - 미디어 분석 문서

01 · 빠른 시작

분석 요청 보내기

요청 헤더에 API 키를 추가하고 JSON 본문에 공개 URL 하나를 전송하세요.

curl -X POST https://api.videotool.cc/openapi/parse \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://..."}'

02 · 인증

API 키로 인증

각 요청에 X-API-Key를 전송합니다. 콘솔에서 키를 확인하거나 갱신할 수 있습니다.

X-API-KeyYOUR_API_KEY

API 키는 서버에 보관하고 앱이나 공개 저장소에 포함하지 마세요.

03 · 엔드포인트

사용 가능한 엔드포인트

POST/openapi/parse단일 URL

공개 미디어 URL 하나 분석

공개 게시물 또는 동영상 URL을 전송합니다. 사용 가능한 리소스 반환 후 1크레딧이 차감됩니다.

url string · required 공개 게시물 또는 동영상 URL

04 · 응답

성공 응답

성공 시 AjaxResult 안의 ParseResult로 동영상, 이미지, 오디오와 텍스트를 반환합니다.

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "resultCode": 0,
    "hasResource": true,
    "resourceType": 200,
    "descList": ["..."],
    "imgList": [],
    "videoList": [],
    "audioList": []
  }
}

05 · 오류

비즈니스 오류 코드

code	의미	과금
`400`	URL이 없거나 잘못되었습니다	차감 없음
`401`	API 키가 없거나 잘못되었거나 비활성화되었습니다	차감 없음
`403`	크레딧이 부족합니다	차감 없음
`422`	사용 가능한 리소스가 없습니다	차감 없음
`500`	분석 서비스 오류	차감 없음

06 · 과금

성공 결과만 과금

1사용 가능한 리소스 반환 시 차감 크레딧

0실패·예외·빈 결과 시 차감 크레딧

현재 범위

Open API는 URL 하나를 처리하는 POST /openapi/parse만 제공합니다. 일괄, 기능 조회, 멱등 캐시, 속도 제한 엔드포인트는 없습니다.

하나의 엔드포인트로 미디어 분석 연동