Explore our Marketplace to buy and sell APIs, services, and social media solutions. Connect with a vibrant community of developers, businesses, and creators!

获取视频字幕异步任务结果/Get video captions async job result

GET

https://api.tikhub.io/api/v1/youtube/web_v2/get_video_captions_result

YouTube-Web-V2-API

Last modified:2026-07-25 04:00:08

OperationId:get_video_captions_result_api_v1_youtube_web_v2_get_video_captions_result_get

[中文]

用途:

查询字幕异步任务的处理结果

视频较大时 /get_video_captions 会返回 status="processing" 和 job_id，
用该 job_id 调用本接口即可获取最终字幕

本接口为单次查询、不阻塞等待，由调用方按需重复调用直到任务完成

参数:

job_id: 异步任务ID（由 /get_video_captions 返回）

format: 字幕格式（仅任务完成时生效）

srt: SubRip 字幕格式（带时间轴）

xml: XML 格式

json3: JSON 格式

txt: 纯文本（无时间轴）

返回数据:

处理中:

{ "job_id": "123e4567-e89b-12d3-a456-426614174000", "status": "queued" }

status 为 queued（排队中）或 active（处理中），稍后重试即可

已完成:

{
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "completed",
  "language_code": "en",
  "language_name": "English",
  "format": "srt",
  "content": "<字幕内容>",
  "available_languages": ["en", "ja"]
}

注意事项:

任务失败时返回错误

建议轮询间隔 2-5 秒（本接口有 RPS 限制，请勿高频轮询）

job_id 仅创建它的账号可查询，他人查询返回 403

价格:

免费（$0 USD / 请求）

[English]

Purpose:

Get the result of an asynchronous caption job

For large videos, /get_video_captions returns status="processing" with a
job_id; use that job_id here to retrieve the final captions

Single-shot, non-blocking query; poll it until the job completes

Parameters:

job_id: Async job ID (returned by /get_video_captions)

format: Caption format (applies only when the job is completed)

srt: SubRip subtitle format (with timestamps)

xml: XML format

json3: JSON format

txt: Plain text (no timestamps)

Returns:

Processing:

{ "job_id": "123e4567-e89b-12d3-a456-426614174000", "status": "queued" }

status is queued or active; retry later

Completed:

{
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "completed",
  "language_code": "en",
  "language_name": "English",
  "format": "srt",
  "content": "<caption content>",
  "available_languages": ["en", "ja"]
}

Notes:

Returns an error if the job failed

Recommended polling interval: 2-5 seconds (this endpoint is rate-limited,
please do not poll aggressively)

A job_id may only be queried by the account that created it; others get 403

Price:

Free ($0 USD / request)

[示例/Example]

GET /get_video_captions_result?job_id=123e4567-e89b-12d3-a456-426614174000&format=srt

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.tikhub.io/api/v1/youtube/web_v2/get_video_captions_result?job_id=123e4567-e89b-12d3-a456-426614174000&format=srt' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

Modified at 2026-07-25 04:00:08

获取视频字幕/Get video captions

获取视频相似内容/Get related videos

获取视频字幕异步任务结果/Get video captions async job result

[中文]#

用途:#

参数:#

返回数据:#

处理中:#

已完成:#

注意事项:#

价格:#

[English]#

Purpose:#

Parameters:#

Returns:#

Processing:#

Completed:#

Notes:#

Price:#

[示例/Example]#

GET /get_video_captions_result?job_id=123e4567-e89b-12d3-a456-426614174000&format=srt#