[中文]

用途:

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

视频较大时 /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

[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

[示例/Example]

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

TikOmni Pricing

Actual billing follows the TikOmni pricing catalog. Query /api/pricing/v1/endpoints with this endpoint path for the current unit price.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

[中文]

用途:

参数:

返回数据:

处理中:

已完成:

注意事项:

[English]

Purpose:

Parameters:

Returns:

Processing:

Completed:

Notes:

[示例/Example]

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

TikOmni Pricing

Request

Request Code Samples

Responses

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

[中文]#

用途:#

参数:#

返回数据:#

处理中:#

已完成:#

注意事项:#

[English]#

Purpose:#

Parameters:#

Returns:#

Processing:#

Completed:#

Notes:#

[示例/Example]#

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

TikOmni Pricing#

Request

Request Code Samples

Responses

[中文]

用途:

参数:

返回数据:

处理中:

已完成:

注意事项:

[English]

Purpose:

Parameters:

Returns:

Processing:

Completed:

Notes:

[示例/Example]

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

TikOmni Pricing