v0.2.0-beta

OpenAPI 3.1.0

设置 YouTube 字幕任务

Felo API Support

MIT

服务器

https://openapi.felo.ai

客户端库

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO 操作

post/v1/beta/dataforseo/serp/youtube/video_subtitles/task_post

设置 YouTube 字幕任务

将一个 YouTube 视频的字幕轨道加入 YouTube 队列，并在 tasks[0].id 中返回任务 id。采用 DataForSEO 的信封结构：数据位于 tasks[0].result，结果状态位于 tasks[0].status_code——被拒绝的请求仍会返回 HTTP 200。实时版本会立即返回，单次查询更简单；当批量任务耗时超过一次工具调用时再使用队列。

计费参考

计量方式：按上报的响应成本计量。
参考请求估算：0.02 美元。
参考客户倍率：1.0。不得对已结算的客户金额再次应用。

仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。

请求体

application/json

类型: array (object | null)[]
- device
  类型: string | null
  
  设备类型可选字段唯一值：desktop
- language_code
  类型: string | null
  
  搜索引擎语言代码未指定 language_name 时为必填字段如果使用此字段，则无需指定 language_name 可单独向 https://api.dataforseo.com/v3/serp/youtube/languages 发起请求，获取搜索引擎支持的语言及其 language_code 列表示例： en
- language_name
  类型: string | null
  
  搜索引擎语言全名未指定 language_code 时为必填字段如果使用此字段，则无需指定 language_code 可单独向 https://api.dataforseo.com/v3/serp/youtube/languages 发起请求，获取搜索引擎支持的语言及其 language_name 列表示例： English
- location_code
  类型: integer | null
  
  搜索引擎地点代码未指定 location_name 时为必填字段如果使用此字段，则无需指定 location_name 可单独向 https://api.dataforseo.com/v3/serp/youtube/locations 发起请求，获取搜索引擎支持的地点及其 location_code 列表示例： 2840
- location_name
  类型: string | null
  
  搜索引擎地点全名未指定 location_code 时为必填字段如果使用此字段，则无需指定 location_code 可单独向 https://api.dataforseo.com/v3/serp/youtube/locations 发起请求，获取搜索引擎支持的地点及其 location_name 列表示例： United States
- os
  类型: string | null
  
  设备操作系统可选字段请从以下值中选择：windows、macos 默认值：windows
- pingback_url
  类型: string | null
  
  已完成任务的通知 URL 可选字段任务完成后，我们会向你指定的 URL 发送 GET 请求进行通知可将 ‘$id’ 字符串用作 $id 变量，将 ‘$tag’ 用作经 URL 编码的 $tag 变量。发送请求前我们会设置必要的值。示例： http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag 注意：pingback_url 中的特殊字符会进行 URL 编码；例如，# 字符会被编码为 %23 详情请参阅我们的帮助中心
- postback_data
  类型: string | null
  
  postback_url 数据类型指定 postback_url 时为必填字段对应将发送到你服务器的数据类型可能的值： advanced
- postback_url
  类型: string | null
  
  用于发送任务结果的返回 URL 可选字段任务完成后，我们会将结果以 gzip 格式压缩，并向你指定的 postback_url 发送 POST 请求可将 ‘$id’ 字符串用作 $id 变量，将 ‘$tag’ 用作经 URL 编码的 $tag 变量。发送请求前我们会设置必要的值。示例： http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag 注意：postback_url 中的特殊字符会进行 URL 编码；例如，# 字符会被编码为 %23 详情请参阅我们的帮助中心
- priority
  类型: integer | null
  
  任务优先级可选字段可取以下值： 1 – 正常执行优先级（默认设置） 2 – 高执行优先级高执行优先级的任务将额外收费。费用可在价格页计算。
- subtitles_language
  类型: string | null
  
  原始文本的语言代码你可以从 YouTube Video Info 结果中获取语言代码
- subtitles_translate_language
  类型: string | null
  
  译文语言代码可能的值： "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"
- tag
  类型: string | null
  
  用户自定义任务标识符可选字段字符数上限为 255 可使用此参数标识任务，并将其与结果对应可在响应的 data 对象中找到指定的 tag 值
- video_id
  类型: string
  
  视频 ID 必填字段可在 URL 或 YouTube Organic 结果的 'youtube_video' 项中找到视频 ID 示例： Y8Wu4rSNJms

响应

200
类型: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostResponseInfo
cost
类型: number | null 格式: double

任务总费用，美元

status_code
类型: integer | null

通用状态码完整响应码列表见此处

status_message
类型: string | null

通用信息性消息完整的一般信息性消息列表见此处

tasks
类型: array (object | null)[] | null

任务数组

类型: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesTaskPostTaskInfo
cost
类型: number | null 格式: double

任务总费用，美元

data
类型: object | null

包含你在 POST 请求中指定的相同参数

propertyName
类型: object | null
id
类型: string | null

任务标识符我们系统中 UUID 格式的唯一任务标识符

path
类型: array (string | null)[] | null

URL 路径

result
类型: object | null

结果数组在本例中，该值将为 null

result_count
类型: integer | null 格式: int64

result 数组中的元素数

status_code
类型: integer | null

任务的状态码由 DataForSEO 生成，范围如下：10000-60000 完整响应码列表见此处

status_message
类型: string | null

任务的信息性消息完整的一般信息性消息列表见此处

time
类型: string | null

执行时间，秒

tasks_count
类型: integer | null 格式: int64

tasks 数组中的任务数

tasks_error
类型: integer | null 格式: int64

tasks 数组中返回错误的任务数

time
类型: string | null

总执行时间，秒

version
类型: string | null

API 的当前版本
application/json
400

无法处理该请求。请检查请求参数。
401

需要有效的 Felo API 密钥。
402

由于未满足计费要求，请求无法继续。
403

该账户无权执行此操作。
429

已达到请求或支出限额。
502

服务无法完成该请求。
503

API 或计费服务暂时不可用。
504

服务在处理请求时超时。
default

错误响应；上游透传响应可能采用提供方格式

application/json

post/v1/beta/dataforseo/serp/youtube/video_subtitles/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/video_subtitles/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "video_id": "Y8Wu4rSNJms"
  }
]'

显示 Schema

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": null
    }
  ]
}

操作成功

需要帮助？

API、计费或账号问题，请联系支持。
在 Discord 上与 Felo 开发者交流。
查看我们的更新日志。
需要批量定价或采购支持？联系销售。
正在使用 LLM 构建？阅读 llms.txt。

设置 YouTube 字幕任务

身份验证Required

DataForSEO

设置 YouTube 字幕任务

计费参考

需要帮助？