# YouTube 자막 작업 설정 **API:** Data API **Endpoint:** `POST /v1/beta/dataforseo/serp/youtube/video_subtitles/task_post` **Tags:** DataForSEO YouTube 동영상 하나의 자막 트랙을 대기열에 넣고 작업 `id`를 `tasks[0].id`에 반환합니다. DataForSEO 봉투로 감싸지며 데이터는 `tasks[0].result`, 결과 상태는 `tasks[0].status_code`에 있습니다. 거부된 요청도 여전히 HTTP 200을 반환합니다. 실시간 짝은 즉시 응답하며 단일 쿼리에 더 간단합니다. 배치가 도구 호출보다 오래 걸릴 때는 대기열을 사용하세요. ### 가격 참고 - 과금 기준: 보고된 응답 비용. - 참고 요청 추정치: USD 0.02. - 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요. 참고용 메타데이터일 뿐이며, 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다. ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Request body Required: **no** ### application/json Schema: ```json { "type": "array", "items": { "type": [ "object", "null" ], "oneOf": [ { "type": "object", "properties": { "video_id": { "type": "string", "description": "동영상 ID\n필수 필드\n동영상 ID는 URL 또는 YouTube Organic 결과의 'youtube_video' 항목에서 찾을 수 있습니다\n예:\nY8Wu4rSNJms" }, "location_code": { "type": [ "integer", "null" ], "description": "검색 엔진 위치 코드\nlocation_name을 지정하지 않으면 필수 필드입니다\n이 필드를 사용하면 location_name을 지정할 필요가 없습니다\n사용 가능한 검색 엔진 위치와 해당 location_code 목록은 https://api.dataforseo.com/v3/serp/youtube/locations 경로로 별도 요청해 받을 수 있습니다\n예:\n2840" }, "language_code": { "type": [ "string", "null" ], "description": "검색 엔진 언어 코드\nlanguage_name을 지정하지 않으면 필수 필드입니다\n이 필드를 사용하면 language_name을 지정할 필요가 없습니다\n사용 가능한 검색 엔진 언어와 해당 language_code 목록은 https://api.dataforseo.com/v3/serp/youtube/languages 경로로 별도 요청해 받을 수 있습니다\n예:\nen" }, "priority": { "type": [ "integer", "null" ], "description": "작업 우선순위\n선택 필드\n다음 값을 사용할 수 있습니다:\n1 – 일반 실행 우선순위(기본으로 설정됨)\n2 – 높은 실행 우선순위\n우선순위가 높은 작업에는 추가 요금이 부과됩니다.\n비용은 Pricing 페이지에서 계산할 수 있습니다." }, "device": { "type": [ "string", "null" ], "description": "기기 유형\n선택 필드\n유일한 값: desktop" }, "pingback_url": { "type": [ "string", "null" ], "description": "완료된 작업의 알림 URL\n선택 필드\n작업이 완료되면 지정한 URL로 GET 요청을 보내 알려드립니다\n‘$id’ 문자열을 $id 변수로, ‘$tag’를 urlencoded $tag 변수로 사용할 수 있습니다. 요청을 보내기 전에 필요한 값을 설정합니다.\n예:\nhttp://your-server.com/pingscript?id=$id\nhttp://your-server.com/pingscript?id=$id&tag=$tag\n참고: pingback_url의 특수 문자는 URL 인코딩됩니다;\n즉, # 문자는 %23으로 인코딩됩니다\n자세한 내용은 Help Center에서 확인하세요" }, "postback_url": { "type": [ "string", "null" ], "description": "작업 결과 전송 URL\n선택 필드\n작업이 완료되면 결과를 gzip 형식으로 압축하여 지정한 postback_url로 POST 요청을 보냅니다\n‘$id’ 문자열을 $id 변수로, ‘$tag’를 urlencoded $tag 변수로 사용할 수 있습니다. 요청을 보내기 전에 필요한 값을 설정합니다.\n예:\nhttp://your-server.com/postbackscript?id=$id\nhttp://your-server.com/postbackscript?id=$id&tag=$tag\n참고: postback_url의 특수 문자는 URL 인코딩됩니다;\n즉, # 문자는 %23으로 인코딩됩니다\n자세한 내용은 Help Center에서 확인하세요" }, "postback_data": { "type": [ "string", "null" ], "description": "postback_url 데이터 유형\npostback_url을 지정하면 필수 필드입니다\n서버로 전송될 데이터 유형에 해당합니다\n가능한 값:\nadvanced" }, "location_name": { "type": [ "string", "null" ], "description": "검색 엔진 위치 전체 이름\nlocation_code를 지정하지 않으면 필수 필드입니다\n이 필드를 사용하면 location_code를 지정할 필요가 없습니다\n사용 가능한 검색 엔진 위치와 해당 location_name 목록은 https://api.dataforseo.com/v3/serp/youtube/locations 경로로 별도 요청해 받을 수 있습니다\n예:\nUnited States" }, "language_name": { "type": [ "string", "null" ], "description": "검색 엔진 언어 전체 이름\nlanguage_code를 지정하지 않으면 필수 필드입니다\n이 필드를 사용하면 language_code를 지정할 필요가 없습니다\n사용 가능한 검색 엔진 언어와 해당 language_name 목록은 https://api.dataforseo.com/v3/serp/youtube/languages 경로로 별도 요청해 받을 수 있습니다\n예:\nEnglish" }, "os": { "type": [ "string", "null" ], "description": "기기 운영 체제\n선택 필드\n다음 값 중에서 선택하세요: windows, macos\n기본값: windows" }, "tag": { "type": [ "string", "null" ], "description": "사용자 정의 작업 식별자\n선택 필드\n문자 제한은 255자입니다\n이 매개변수로 작업을 식별하고 결과와 연결할 수 있습니다\n지정한 tag 값은 응답의 data 객체에서 확인할 수 있습니다" }, "subtitles_language": { "type": [ "string", "null" ], "description": "원문 언어 코드\n언어 코드는 YouTube Video Info 결과에서 가져올 수 있습니다" }, "subtitles_translate_language": { "type": [ "string", "null" ], "description": "번역문 언어 코드\n가능한 값:\n\"az\", \"ay\", \"ak\", \"sq\", \"am\", \"en\", \"ar\", \"hy\", \"as\", \"af\", \"eu\", \"be\", \"bn\", \"my\", \"bg\", \"bs\", \"bho\", \"cy\", \"hu\", \"vi\", \"haw\", \"ht\", \"gl\", \"lg\", \"el\", \"ka\", \"gn\", \"gu\", \"gd\", \"da\", \"fy\", \"zu\", \"iw\", \"ig\", \"yi\", \"id\", \"ga\", \"is\", \"es\", \"it\", \"yo\", \"kk\", \"kn\", \"ca\", \"qu\", \"rw\", \"ky\", \"zh-Hant\", \"zh-Hans\", \"ko\", \"co\", \"xh\", \"ku\", \"km\", \"lo\", \"la\", \"lv\", \"ln\", \"lt\", \"lb\", \"mk\", \"mg\", \"ms\", \"ml\", \"dv\", \"mt\", \"mi\", \"mr\", \"mn\", \"und\", \"de\", \"ne\", \"nl\", \"no\", \"ny\", \"or\", \"om\", \"pa\", \"fa\", \"pl\", \"pt\", \"ps\", \"ro\", \"ru\", \"sm\", \"sa\", \"ceb\", \"nso\", \"sr\", \"si\", \"sd\", \"sk\", \"sl\", \"so\", \"sw\", \"su\", \"tg\", \"th\", \"ta\", \"tt\", \"te\", \"ti\", \"ts\", \"tr\", \"tk\", \"uz\", \"ug\", \"uk\", \"ur\", \"fil\", \"fi\", \"fr\", \"ha\", \"hi\", \"hmn\", \"hr\", \"cs\", \"sv\", \"sn\", \"ee\", \"eo\", \"et\", \"st\", \"jv\", \"ja\", \"kri\"" } }, "example": [ { "language_code": "en", "location_code": 2840, "video_id": "Y8Wu4rSNJms" } ] } ] }, "example": [ { "language_code": "en", "location_code": 2840, "video_id": "Y8Wu4rSNJms" } ] } ``` ## Responses ### 200 — 작업 성공 Headers: - `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다. **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostResponseInfo" } ] } ``` ### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요. ### 401 — 유효한 Felo API 키가 필요합니다. ### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다. ### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다. ### 429 — 요청 또는 지출 한도에 도달했습니다. ### 502 — 서비스가 요청을 완료할 수 없습니다. ### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다. ### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다. ### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다. **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_BaseResponseInfo `#/components/schemas/Response36Afe1097B20_BaseResponseInfo` ```json { "properties": { "version": { "type": [ "string", "null" ], "description": "API의 현재 버전" }, "status_code": { "type": [ "integer", "null" ], "description": "일반 상태 코드입니다.\n응답 코드 전체 목록은 여기에서 확인할 수 있습니다." }, "status_message": { "type": [ "string", "null" ], "description": "일반 정보 메시지입니다.\n일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다." }, "time": { "type": [ "string", "null" ], "description": "총 실행 시간(초)" }, "cost": { "type": [ "number", "null" ], "description": "전체 작업 비용, USD", "format": "double" }, "tasks_count": { "type": [ "integer", "null" ], "description": "tasks 배열의 작업 수", "format": "int64" }, "tasks_error": { "type": [ "integer", "null" ], "description": "오류와 함께 반환된 tasks 배열의 작업 수", "format": "int64" } } } ``` ### Response36Afe1097B20_BaseResponseTaskInfo `#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo` ```json { "properties": { "id": { "type": [ "string", "null" ], "description": "작업 식별자\n시스템 내 고유 작업 식별자(UUID 형식)" }, "status_code": { "type": [ "integer", "null" ], "description": "작업의 상태 코드\nDataForSEO가 생성하며 10000-60000 범위일 수 있습니다.\n응답 코드 전체 목록은 여기에서 확인할 수 있습니다." }, "status_message": { "type": [ "string", "null" ], "description": "작업의 정보 메시지\n일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다." }, "time": { "type": [ "string", "null" ], "description": "실행 시간, 초" }, "cost": { "type": [ "number", "null" ], "description": "전체 작업 비용, USD", "format": "double" }, "result_count": { "type": [ "integer", "null" ], "description": "result 배열의 요소 수", "format": "int64" }, "path": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "URL 경로" }, "data": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "object", "null" ] }, "description": "POST 요청에 지정한 것과 동일한 매개변수를 포함합니다" } } } ``` ### Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostResponseInfo `#/components/schemas/Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostResponseInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo" }, { "type": "object", "properties": { "tasks": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostTaskInfo" } ] }, "description": "작업 배열" } } } ] } ``` ### Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostTaskInfo `#/components/schemas/Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostTaskInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo" }, { "type": "object", "properties": { "result": { "type": [ "object", "null" ], "description": "결과 배열\n이 경우 값은 null입니다" } } } ] } ```