문서 둘러보기
API 참조
YouTube Captions API
YouTube 캡션을 타임스탬프 텍스트와 전체 성적표로 검색합니다. Uploader-provided captions는 기본적으로 선택됩니다.
요청 구성
11-character ID 비디오에서 URL, 전체 URL.
en-orig를 시도하기 위해 공백을 남기고, 다음 en, 그리고 한 트랙을 반환합니다. 또는 commas에 의해 분리되는 10 명백한 부호까지 1개의 부호 또는 들어갑니다.
https://data.flashdata.dev/v1/queries/realtime제품 설명
제품 정보 source 으로 video_id 최고 수준에서. Source 옵션은 params. 선택적인 분야는 omitted 일 수 있습니다.
요청 본문
sourcestring / 필수- youtube_captions로 설정.
video_idstring / 필수- 11-character YouTube 비디오 ID, FUfGcZ092b0와 같은. 문자, 숫자, 밑줄 및 하이픈을 허용한다.정확히 11 이름 *기본 정보:
설정하기수용된 체재
^[A-Za-z0-9_-]{11}$ paramsobject / 선택 사항- 이 요구를 위한 Settings.기본 정보:
{} callback_urlstring · nullable / 선택 사항- Async 및 배치만. 공공 HTTPS 완료 URL 포트에 443, 최대 2,048 문자. 사용자 자격 또는 URL 파편이 없습니다. Omit, null 또는 알림이 없는 빈 문자열을 사용하십시오. 일괄 처리에서, 각 쿼리에 설정, 외부 params.기본 정보:
설정하기
Caption 선택
params.languagestring | array / 선택 사항- 영어 (en-orig, 그 다음 en)에 대한 오미스트. auto=true로, 각 코드는 -orig 궤도를 첫째로, 그 후에 요구한 부호 삼습니다. Explicit -orig 부호와 auto=false는 정확한 체재합니다. 배열은 1–10를 다른 언어 요청합니다.기본 정보:
en-orig → en params.autoboolean / 선택 사항- true는 YouTube 생성된 캡션을 선정합니다; false는 올려주기 보호된 캡션을 선정합니다. 이 선택 caption 근원, 언어 탐지 또는 새로운 transcription.
true또는false기본 정보:false
응답
Realtime 반환 status: done. 소스 출력을 읽으십시오 results[0]; usage.credits 책임의 기록.
결합된 텍스트에 대한 몇 초 및 fullText에서 start/end 시간으로 캡션 텍스트에 대한 세그먼트를 읽으십시오. languageCode 및 isAutoGenerated는 선택한 트랙을보고 있습니다.
결과보기
response.json로 성공적인 JSON 응답을 저장하십시오. read-response.py로 저장하고 python read-response.py를 실행하십시오. Python의 표준 라이브러리를 사용하고 새로운 요청을 만들 수 있습니다.
import json
from pathlib import Path
response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
print("[]")
raise SystemExit(0)
result = response["results"][0]
output = {
"tracks": result.get("tracks", [result]),
"errors": result.get("errors", []),
}
print(json.dumps(output, ensure_ascii=False, indent=2))Omit 언어는 en-orig를 선호하고 en로 돌아가고, 한 트랙을 반환합니다. auto=true로, 각 요청한 부호는 그것의 -orig 궤도를, 그 때 일반 부호 선호합니다; 명시한 -orig와 auto=false는 정확한 체재합니다. 배열은 각 요구한 언어 및 반환 궤도 및 순서에 있는 과실을 시도합니다. languageCode는 선택된 궤도를 식별합니다; requestedLanguageCode는 그것 다른 때 포함됩니다.
언어 배열을 요청한 경우 errors에서 가져오지 못한 트랙을 확인하세요. 트랙을 하나도 가져오지 못하면 요청이 실패하고 예약된 크레딧이 환불됩니다. 동영상 추출 실패나 요청 시간 초과도 요청 실패로 처리됩니다.
자동 기본적으로 false에 대한 로더 보호 캡션. 자동 캡션을 위한 true를 설정합니다. API는 캡션 소스를 결코 전환하지 않습니다.
API는 기존 YouTube 캡션을 읽습니다. 새로운 성적표를 생성하지 않습니다. 과태 응답은 정상화한 JSON 세그먼트를 포함합니다; Accept는 일반 텍스트와 X-Respond-With를 선택할 수 있습니다. 마진은 Markdown를 선택합니다. languageName는 null일 수 있습니다. 세그먼트 타이밍은 보존됩니다.
여러 언어
트랙 및 언어 오류를 수신하는 언어 배열을 보내십시오. 이 예제는 영어를 사용할 수 있으며 스페인어를 사용할 수 없습니다.
{
"source": "youtube_captions",
"video_id": "jNQXAC9IVRw",
"params": {
"language": [
"en",
"es"
],
"auto": false
}
}{
"videoId": "jNQXAC9IVRw",
"isAutoGenerated": false,
"tracks": [
{
"videoId": "jNQXAC9IVRw",
"languageCode": "en",
"languageName": null,
"isAutoGenerated": false,
"segments": [
{
"start": 0,
"end": 1.5,
"text": "Hello world."
}
],
"fullText": "Hello world."
}
],
"errors": [
{
"languageCode": "es",
"code": "language_unavailable",
"message": "Uploader-provided subtitles not available for language: es"
}
]
}모든 응답 분야
| - 연혁 | 의 특징 |
|---|---|
sourcestring | 요청된 API 소스. |
statusstring | 실시간 요청이 성공할 때 완료됩니다. |
created_atstring | ISO 8601 형식의 응답 생성 시간. |
usage.creditsnumber | 요청시 크레딧이 청구되며, 플랜을 기준으로 합니다. |
results[0].videoIdstring | 요청된 비디오 ID. |
results[0].languageCodestring | 실제 선택된 캡션 트랙 코드, 같은 en-orig. |
results[0].languageNamestring · nullable | 사용 가능한 언어 표시 이름. |
results[0].requestedLanguageCodestring · optional | languageCode와 다를 때 요청된 코드는, 예를 들어 en-orig가 선택되었을 때. |
results[0].isAutoGeneratedboolean | 선택된 캡션이 자동으로 생성되었는지 여부. |
results[0].segmentsarray | 연쇄 순서에 있는 Caption 세그먼트. |
results[0].segments[].startnumber | 초에 세그먼트 시작 시간. |
results[0].segments[].endnumber | 초에 세그먼트 끝 시간. |
results[0].segments[].textstring | 캡션 텍스트. |
results[0].fullTextstring | 모든 세그먼트 텍스트는 성적표에 결합. |
results[0].tracksarray · optional | 언어 배열에 대한. 요청 순서에 있는 유효한 궤도; 각각은 위에 목록으로 만들어진 단 하나 궤도 분야가 있습니다. |
results[0].errorsarray · optional | 언어 배열에 대한. 요청 주문에 실패한 언어. 모든 트랙이 성공할 때 빈. |
results[0].errors[].languageCodestring | 실패한 언어. |
results[0].errors[].codestring | 선택된 트랙이 존재하지 않을 때 language_unavailable; 다운로드 또는 파싱 할 수 없을 때 retrieval_failed. |
results[0].errors[].messagestring | 언어 장애의 설명. |
위의 필드는 기본 JSON 응답을 설명합니다. JSON, 일반 텍스트 및 Markdown 형식.
Async는 1개의 일 영수증을 돌려보냅니다; 배치는 당 1개를 돌려보냅니다 비디오 ID. 각 업무의 상태를 확인하고 반환된 링크를 사용하여 결과를 검색하십시오.
Async 및 배치 수명주기
제출은 영수증을 반환, 결과가 아닙니다. Async는 한 일을 만듭니다; 배치는 분리된 일을 안으로 돌려보냅니다 queries[] 모든 허용된 쿼리에 대 한. 각 직무를 독립적으로 추적하고 검색합니다.
제출하기 data.flashdata.dev; 작업 상태 및 결과 읽기 api.flashdata.dev 동일한 X-API-Key로. API 기본 예제는 Python 및 cURL를 사용합니다.
1. 작업 IDs 저장
Async로 전환 할 때이 소스 요청 필드를 유지하십시오. Batch의 경우, JSON 객체의 쿼리 배열 내부에 각 요청을 넣어. 모든 반환 작업 ID 저장.
2. 본문 바로가기
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: 지연 및 존경을 가진 오염Retry-After현재 위치completed: fetch 결과.failed: 검사job.error.job.status를 읽으십시오, 제출 영수증의 상태는 아닙니다.
일 상태 API 참고3. Fetch 결과
GET https://api.flashdata.dev/v2/jobs/{jobId}/results완료 후 결과를 확인한 다음 302 저장 URL 키를 사용하지 않고 API 저장을 읽습니다. 24 시간 내에 JSON를 저장하십시오.
결과 다운로드 API 참조
오염 및 기존 결과를 fetching하는 것은 쿼리 크레딧을 사용하지 않습니다. 퇴직시간은 업무 취소를 하지 않습니다. ID 대신 중복 청구 가능한 작업을 제출합니다. 오류 코드 및 재시동 행동.
완료 웹훅
자주 묻는 질문
설치하기 callback_url async 요청의 최고 수준에서, 또는 각 질의 안 배치에서, 밖에 params. 별도의 webhook-registration 요청이 필요하지 않습니다. Realtime 요청은 콜백을 보내지 않습니다.
포트 443에 공공 HTTPS URL를 사용하십시오. FlashData POSTs 각 작업에 대한 알림 completed 또는 failed; 이벤트 포함 링크, 그 결과 자체.
Acknowledge 및 검증
을 읽다 2xx 이벤트를 수락 한 후. 으로 Deduplicate delivery_id, 또한 보내진 것과 같이 X-Delivery-Id. Redirects는 다음과 같습니다.
실패한 납품은 exponential backoff, 까지 재기합니다 8는 총 시도 가장 많이 완료 후 24 시간. 추락으로 오염을 지키십시오.
Callbacks는 할당되지 않습니다. ID, 소스 및 터미널 상태를 확인 인증된 상태 endpoint 알림을 처리하기 전에. 납품 ID는 deduplication를 위해, 정정성의 증거 아닙니다.
webhook 이벤트 및 필드 보기
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "youtube_captions",
"status": "completed",
"links": [
{
"rel": "self",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001",
"method": "GET"
},
{
"rel": "results",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
"method": "GET"
}
]
}| - 연혁 | 의 특징 |
|---|---|
delivery_idstring | 안정적인 납품 식별자. 이 값을 사용하여 알림을 삭제; 또한 X-Delivery-Id 헤더에 보내집니다. |
idstring | 작업 ID. |
sourcestring | 요청된 데이터 소스. |
statusstring | 완료 또는 실패. |
linksarray | 상태 및 결과 링크. 알림은 결과 내용이나 API 키가 포함되지 않습니다. |
links[].relstring | 자기 또는 결과. |
links[].hrefstring | 절대 관리 API URL; 당신의 API 열쇠로 정정. |
links[].methodstring | GET. |
Bulk 파일 처리
라인 당 하나의 비디오 ID를 업로드하고 소스와 Bulk 작업을 만듭니다.: youtube_captions. 공유 옵션은 모든 ID 파일에 적용됩니다.
근원 선택권: 언어, 자동차. Bulk 작업을 만들 때 옵션에 넣어.
NDJSON 결과 부품으로 완성된 컬렉션을 검색합니다. 데이터 소스는 Bulk 작업을 만들 때 options.result_storage를 설정하여 클라우드 스토리지에 결과를 제공 할 수 있습니다. Bulk 작업 전체가 완료된 후 24 시간 내에 나타날과 부품을 저장하십시오.
오류 복구
비디오는 자동 캡션이 있지만 수동 트랙이 없거나 요청한 언어가 부족할 수 있습니다. Metadata를 사용하여 caption 가용성을 확인하고 새로운 제출하기 전에 언어 및 원산지를 결정하십시오.
Metadata로 사용할 수 있는 캡션 언어 확인. 새로운 요청은 쿼리 크레딧을 사용; 트랙 변경은 기존 작업을 수정하지 않습니다.
인증, 균형, 요청 정보 및 속도 제한 실패를 위해, 공유 오류 참조를 사용합니다. 제출 시간표는 여전히 일자리를 만들 수 있습니다; 재발하기 전에 기존 작업을 확인하십시오.
단계별 가이드: 타임스탬프 캡션 검색
요금
| 계획하기 | 사용법 비율표준 요청 1,000회당 | 이름 * | 청구 기간 당 크레딧 포함 |
|---|---|---|---|
| 사용량 기반 결제 | US$0.50 | 월 이용료 없음 | 필요할 때 충전 |
| Micro | US$0.40 | US$49.00 / 월별 월별 | 1,000 크레딧 (US$50.00의 API 사용) 포함 |
| Starter | US$0.35 | US$199.00 / 월별 월별 | 4,000 크레딧 (US$200.00의 API 사용) 포함 |
| Pro | US$0.30 | US$499.00 / 월별 월별 | 10,000 크레딧 (US$500.00의 API 사용) 포함 |
| Scale | US$0.25 | US$999.00 / 월별 월별 | 20,000 크레딧 (US$1,000.00의 API 사용) 포함 |
| Business | US$0.20 | US$1,999.00 / 월별 월별 | 40,000 크레딧 (US$2,000.00의 API 사용) 포함 |
계정당 하나의 요금제. 세 제품이 크레딧을 공유합니다. 포함된 크레딧으로 처리한 사용량에는 다시 과금하지 않습니다.
현재 가격 및 계획 제한