YouTube Get Video Captions Result

0 credits/call
ae_youtube_get_video_captions_result

## Purpose Check the progress of an existing asynchronous YouTube caption job and retrieve its captions when complete. Each call is a single, non-blocking query; it does not create a job or automatically wait for completion. ## Inputs - **job_id** (required): The job ID returned by a previous caption retrieval request when it reports `status="processing"`. It must be 8–128 characters using only letters, digits, underscores, and hyphens. Use the same account that created the job. - **format** (optional): `srt` (default, SubRip with timestamps), `xml`, `json3`, or `txt` (plain text without timestamps). This choice applies only when the job is complete. ## Results - `queued`: The job is waiting to be processed. - `active`: The job is still processing. - `completed`: The result includes `job_id`, `status`, `language_code`, `language_name`, `format`, `content` (the captions), and `available_languages` (available language codes). For `queued` or `active`, query again later; the recommended interval is 2–5 seconds. Avoid aggressive polling because rate limits apply. Failed jobs return an error. Accessing a job created by another account returns 403.

TranscriptVideo
0 credits/call

Pricing

0 credits/call
ConditionCharge
Each call0 credits/call

0 credits/call Free query.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
formatenum (srt | xml | json3 | txt)No字幕格式/Caption formatsrt
job_idstringYes异步任务ID/Async job ID—

Invocation example

Parameter template

Generated from the parameter configuration. Replace the sample values before use.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_youtube_get_video_captions_result' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "job_id": "xxx"
  }
}'

No response example available yet.