API de Transcripción de Youku
Salud de la API
- Salud 24 h
- Normal
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Últimas 24 horas
Últimos 30 días
Extrae texto disponible del video indicado por url, con idioma, duración y autor; puede conservar texto traducido cuando la respuesta lo trae. No promete traducción o transcripción para toda pieza.
Envía POST https://api.everyinfra.com/api/v1/social con platform igual a youku y action igual a transcript. Precio $2.78 por 1.000 solicitudes ($0.002778 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Asíncrona por defecto: primero devuelve un job_id; consulta GET /api/v1/jobs/{job_id}.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Youku: Transcripción (youku/transcript).
Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en youku y action en transcript, y los parámetros dentro de params.
- Parámetros obligatorios:
- url: URL pública y real de un vídeo para la acción transcript. La transcripción es una tarea asíncrona, por lo que debes esperar a que finalice. No es compatible con vídeos protegidos por suscripción.
- Devuelve un objeto. Campos principales: title, text, language, translated_text, translated_language, duration_seconds, duration_sec, author_name, author_id, author_url, thumbnail_url, tags.
- Cuerpo de solicitud de ejemplo:
{
"platform": "youku",
"action": "transcript",
"params": {
"url": "https://v.youku.com/v_show/id_XNTA2NTA0MjA1Mg==.html"
}
}
- Precio: $2.78 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Este endpoint es asíncrono por defecto: devuelve 202 y un job_id; luego consulta GET https://api.everyinfra.com/api/v1/jobs/{job_id} hasta que el estado sea succeeded o failed.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.
Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.Parámetros de la solicitud
#| Nombre | Ubicación | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|---|
Authorization | header | string | Sí | - | Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código. |
platform | body | string | Sí | youku | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | transcript | Identificador de la capacidad, valor fijo. |
url | body.params | string | Sí | - | URL pública y real de un vídeo para la acción transcript. La transcripción es una tarea asíncrona, por lo que debes esperar a que finalice. No es compatible con vídeos protegidos por suscripción. La acción video puede extraer el ID de un enlace id_…html, pero aun así debes proporcionar el parámetro id obligatorio. |
Ejemplos de código
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "youku",
"action": "transcript",
"params": {
"url": "https://v.youku.com/v_show/id_XNTA2NTA0MjA1Mg==.html"
}
}'Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.
Ejemplo de respuesta
#{ "id": "req_…", "platform": "youku", "action": "transcript", "results": { "title": "Minecraft我的世界:建造超大巨型航空飞机,菜鸟vs高手vs黑客", "text": "哈囉觀眾老爺們大家好我是小舊子Z 其實影片給大家帶來的是Minecraft我的世界那麼作為機長的菜鳥那麼 他現在要開始建造他屬於他自己的飛機那麼我們來看一下我們的餐鳥是否能造好一個完美的飛機 那麼彩鳥的飛機已經馬上完工了這個機翼並且發動機OK那麼 材料的飞机完成了也是非常大的一架飞机啊非常的棒那么到我们的高手了高手呢在远处的这个池汤里面呢游泳 上岸之后呢却看到了菜鸟的飞机然后呢自己又找了一片非常非常大的一个空地摇摄一遍变成机长那么机长 就一定要有自己的飛機那麼我們的高手呢開始建造自己屬於自己的一架巨型的飛機那咱們看到這裡之後呢我們的高手的飛機呢也快 建造…", "language": "Chinese", "duration_seconds": 542, "author_name": "•••", "author_id": "•••", "author_url": "https://www.youku.com/•••", "thumbnail_url": "https://m.ykimg.com/054101016001F5EA07937EACA8E0510A", "tags": [ "高手", "飞机", "黑客" ], "platform": "youku", "duration_sec": 542 }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campos de la respuesta
#Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.
| Campo | Significado |
|---|---|
title | Título. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto). |
text | Texto del contenido sin HTML, completo y sin recortes (en algunas plataformas los resultados de listado solo traen un extracto; lo indican las notas de campos de la plataforma). |
language | Código de idioma del contenido (por ejemplo zh, en) según la plataforma; puede no ser exacto. |
translated_text | Conserva el significado de la plataforma |
translated_language | Conserva el significado de la plataforma |
duration_seconds | Duración en segundos. null en contenido que no es video ni audio. |
duration_sec | Conserva el significado de la plataforma |
author_name | Nombre visible del autor. |
author_id | Identificador único del autor en la plataforma. |
author_url | Enlace al perfil del autor en la plataforma. |
thumbnail_url | Enlace a la miniatura, con menos resolución que image_url. |
tags | Lista de etiquetas. Si no hay, es una lista vacía, no null. |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
Errores y facturación
#- 401
- Falta la clave o no es válida.
- 402
- Saldo insuficiente. Recarga primero.
- 422
- Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
- 429
- Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
- 503
- No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
- 200 vacío
- Sin datos. Sin cargo.
Referencias oficiales
#Solo sirven para contrastar objetos y términos. No implican autorización ni respaldo de la plataforma a EveryInfra.
- Youku: Recopilación automatizada y restricciones de acceso a contenido para miembros ↗
El acuerdo de Youku prohíbe acciones como la recopilación o el procesamiento automatizado del contenido de la plataforma, así como eludir las medidas de protección de derechos de autor para que los no miembros accedan a contenido exclusivo. Esta página no considera la transcripción de vídeos públicos como una autorización de la plataforma, ni promete eludir las restricciones de membresía, derechos de autor o acceso; debes verificar las licencias correspondientes antes de su uso.
Comprobado el 2026-09-04