AiVideoEditor
Empieza gratis
Menú

Revisada el 2026-11-10 · Versión de API 2026-11-09 · Leer Markdown

Autenticación y claves de producto

La UI de AiVideoEditor, la API REST y el adaptador MCP comparten los servicios del espacio de trabajo. Los clientes de la API usan una clave de producto, no un token OAuth de red social ni una credencial de base de datos. Crea las claves en /app/developers después de iniciar sesión en el espacio de trabajo correcto. Copia la clave en texto plano pk_v1_… una vez y guárdala en un gestor de secretos o en un entorno local protegido. AiVideoEditor conserva un hash y un prefijo de visualización.

Enviar una clave

curl --fail-with-body -sS \
  -H "Authorization: Bearer $PUBLISHER_KEY" \
  "$PUBLISHER_API_URL/api/v1/usage"

Usa HTTPS para un origen desplegado. Mantén las credenciales fuera de las URLs, del control de código fuente, de los prompts de chat, de las capturas de pantalla y de los registros. Las subidas directas al almacenamiento usan la URL firmada y las cabeceras devueltas; no reenvíes tu clave bearer de AiVideoEditor al almacenamiento.

Scopes y acceso a cuentas

ScopeCapacidad
accounts:readInspeccionar cuentas, capacidades y configuración de TikTok
media:writeReservar, finalizar y gestionar subidas
posts:readListar publicaciones, validar borradores y observar el estado
posts:writeCrear y editar borradores
posts:publishPublicar, programar, cancelar y reintentar entregas
usage:readLeer el uso y la información del plan del espacio de trabajo
webhooks:manageRegistrar, listar y eliminar endpoints de webhook

Los scopes son nombres exactos, no una jerarquía. Concede solo los que la integración necesite. Las claves también pueden restringir los IDs de cuenta accesibles. La membresía del espacio de trabajo, el rol efectivo, las restricciones de cuenta y el estado del plan siguen aplicando. Una clave con posts:publish no obtiene automáticamente acceso de escritura de borradores.

El conjunto de scopes por defecto de las claves omite posts:publish y webhooks:manage. Un agente solo de borradores puede preparar trabajo para revisión sin autoridad para enviarlo. Las claves no pueden crear otras claves ni cambiar la facturación.

Revocación y recuperación

Revoca una clave comprometida en la UI de desarrollador. Revisa primero su número de trabajos pendientes: la revocación pausa el trabajo no enviado como requires_action; no elimina borradores. Crea un reemplazo con el acceso apropiado y revisa el trabajo pendiente antes de reanudar. No asumas que la revocación puede recuperar un envío ya enviado externamente.

Un 401 significa que las credenciales están ausentes o son inválidas. Un 403 significa que el actor autenticado carece de permiso o de acceso a la cuenta. Reintentar repetidamente cualquiera de las dos respuestas no lo arreglará. Consulta errores y recuperación.