Open API - Documentação de análise de mídia

01 · Início rápido

Envie uma solicitação de análise

Adicione a chave API ao cabeçalho e envie uma URL pública no corpo 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 · Autenticação

Autenticar com uma chave API

Envie X-API-Key em cada solicitação. Consulte ou renove a chave no console.

X-API-KeyYOUR_API_KEY

Mantenha a chave API no servidor e não a publique em aplicativos ou repositórios.

03 · Endpoint

Endpoint disponível

POST/openapi/parseURL única

Analisar uma URL pública

Envie uma publicação ou vídeo público. Um crédito é cobrado após o retorno de recursos utilizáveis.

url string · required URL pública de publicação ou vídeo

04 · Resposta

Resposta bem-sucedida

Uma chamada bem-sucedida retorna ParseResult em AjaxResult, com vídeo, imagem, áudio e texto.

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

05 · Erros

Códigos de negócio

code	Significado	Cobrança
`400`	URL ausente ou inválida	Sem cobrança
`401`	Chave API ausente, inválida ou desativada	Sem cobrança
`403`	Créditos insuficientes	Sem cobrança
`422`	Nenhum recurso utilizável retornado	Sem cobrança
`500`	Erro do serviço de análise	Sem cobrança

06 · Cobrança

Cobrar apenas resultados bem-sucedidos

1crédito cobrado quando recursos utilizáveis são retornados

0créditos cobrados por falhas ou resultados vazios

Escopo atual

A Open API oferece apenas POST /openapi/parse para uma URL. Não há endpoints de lote, capabilities, cache de idempotência ou limite de taxa.

Integre análise de mídia com um endpoint