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
| Scope | Capacidad |
|---|---|
accounts:read | Inspeccionar cuentas, capacidades y configuración de TikTok |
media:write | Reservar, finalizar y gestionar subidas |
posts:read | Listar publicaciones, validar borradores y observar el estado |
posts:write | Crear y editar borradores |
posts:publish | Publicar, programar, cancelar y reintentar entregas |
usage:read | Leer el uso y la información del plan del espacio de trabajo |
webhooks:manage | Registrar, 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.