Open API - Documentación de análisis multimedia

01 · Inicio rápido

Envía una solicitud de análisis

Añade la clave API al encabezado y envía una URL pública en el cuerpo JSON.

curl -X POST https://api.videotool.cc/openapi/parse \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://..."}'

02 · Autenticación

Autenticación con clave API

Envía X-API-Key en cada solicitud. Consulta o renueva la clave en la consola.

X-API-KeyYOUR_API_KEY

Guarda la clave API en el servidor y no la publiques en aplicaciones o repositorios.

03 · Endpoint

Endpoint disponible

POST/openapi/parseURL única

Analizar una URL pública

Envía una publicación o vídeo público. Se cobra un crédito después de obtener recursos utilizables.

url string · required URL pública de publicación o vídeo

04 · Respuesta

Respuesta correcta

Una llamada correcta devuelve ParseResult dentro de AjaxResult, con recursos de vídeo, imagen, audio y texto.

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "resultCode": 0,
    "hasResource": true,
    "resourceType": 200,
    "descList": ["..."],
    "imgList": [],
    "videoList": [],
    "audioList": []
  }
}

05 · Errores

Códigos de negocio

code	Significado	Cargo
`400`	URL ausente o no válida	Sin cargo
`401`	Clave API ausente, no válida o desactivada	Sin cargo
`403`	Créditos insuficientes	Sin cargo
`422`	No se devolvieron recursos utilizables	Sin cargo
`500`	Error del servicio de análisis	Sin cargo

06 · Facturación

Solo se cobran resultados correctos

1crédito cobrado al devolver recursos utilizables

0créditos cobrados por errores o resultados vacíos

Alcance actual

Open API solo ofrece POST /openapi/parse para una URL. No incluye lotes, capacidades, caché de idempotencia ni limitación.

Integra el análisis multimedia con un endpoint