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 字幕任務

計費參考

需要協助嗎？