Referencia de comandos de la CLI
Corresponde a la versión publicada 0.14.1 de @evolinkai/cli. Usa evolink —help o evolink COMMAND —help —json para ver la ayuda de la versión que tienes instalada. Los comandos de negocio admiten —json. Sustituye MODEL_ID, QUOTE_ID, TASK_ID y UPLOAD_ID por los valores reales devueltos.Autenticación, diagnóstico y habilidades
Consulta la instalación.
Valores de agent: all/codex/claude-code/cursor/gemini/opencode/copilot/openclaw/hermes; el valor predeterminado es all. Aun así, el asistente debe verificar que detecta la habilidad.
La salida de
setup, doctor y auth login incluye update (status, update_available, latest_version, command); los demás comandos imprimen un aviso en stderr como máximo una vez al día cuando hay una versión más reciente. Define EVOLINK_CLI_UPDATE_CHECK=0 para desactivar las comprobaciones; consulta Cómo saber si hay una versión nueva.
Modelos, entradas y documentación
La búsqueda en la documentación usa el índice oficial de referencias de modelos incluido en el paquete, no un rastreo en vivo del sitio web. La recomendación se basa en las entradas documentadas, las palabras clave y las preferencias editoriales de la plataforma, no en una clasificación de popularidad. Los precios unitarios no son cotizaciones de tareas.
Cotizaciones y generación
Crea input.json con los parámetros reales del modelo y obtén una cotización gratuita:
Una cotización obtenida correctamente devuelve quote_id, es válida durante 24 horas desde la estimación (
expires_at) y queda vinculada al inicio de sesión, al backend, al modelo y a las entradas exactas. La generación vuelve a leer las reglas de precios antes de enviar: la misma entrada se envía si el precio es el aprobado o uno inferior, también con reglas posteriores; un precio más alto falla con price_changed, una entrada modificada con quote_input_changed y una cotización caducada con quote_expired. En esos casos no se envía nada y hacen falta una cotización y una aprobación nuevas. Las estimaciones fallidas o rechazadas por el tope no son cotizaciones utilizables. Una estimación a la que le falta el uso facturable falla indicando cada valor que falta y la opción con la que se proporciona, y no guarda ninguna cotización. Muestra las especificaciones, el rango de costo y las advertencias, espera la aprobación explícita y elige el comando correspondiente:
quote_superseded, que indica la cotización actual o su tarea. Una cotización cuyo envío ya ha empezado no se puede actualizar (submission_already_started); en su lugar, recupera su tarea. Una actualización que se ejecuta mientras otra sustituye la misma cotización devuelve quote_refresh_conflict.
Una cotización creada con --inputs-file cubre todo el lote: generate --quote QUOTE_ID --confirm envía todas las entradas de una vez (hasta 10 simultáneas) y devuelve, sin esperar, el identificador de la tarea o el error de cada entrada; --wait sirve para una sola tarea. Recoge los resultados con tasks batch --ids.
Solo cuando el usuario haya dicho explícitamente que no hace falta estimar ni confirmar:
--skip-estimate envía sin cotización, también con --inputs-file: el precio no se comprueba, la tarea se cobra según el uso real y el resultado lo indica (estimate_skipped). Una entrada no válida se sigue rechazando, y un --max-cost-usd explícito se sigue aplicando: una solicitud que supere ese tope, o cuyo precio no se pueda comparar con él, no se envía. --skip-estimate no se puede combinar con --quote ni con --confirm. El comando guarda un registro con su propio identificador de solicitud y devuelve un quote_id para tasks resume.
—wait espera a la tarea existente. El tiempo de espera es de 1–86400 segundos, predeterminado: 1800. Que se agote el tiempo de espera o pulsar Ctrl-C no cancela la tarea en el servidor. El tiempo de espera abarca todas las lecturas, los reintentos y las pausas; al llegar al límite, wait_timeout indica el último estado verificado y su read_at, o status_check: unverified cuando no se pudo leer el estado más reciente. Las estimaciones completas usan de forma predeterminada su máximo cotizado en las comprobaciones del envío. Consulta las limitaciones del presupuesto.
Tareas, lotes y recuperación
El filtro por tiempo solo afecta a la página seleccionada. El historial abarca toda la cuenta, no solo este chat. Una página vacía no demuestra que no haya habido envío; total se calcula antes del filtro local por tiempo. En el modo por lotes, los identificadores son 1–50 valores separados por comas.
Si tienes el identificador de la tarea, usa get/wait. Si se perdió la respuesta de un envío, reanuda la cotización original con su identificador de solicitud y su inicio de sesión. En un lote,
tasks resume --quote QUOTE_ID completa las entradas que no se enviaron; las entradas aceptadas devuelven sus tareas originales sin un nuevo cargo. tasks resume repite el envío con el identificador de solicitud solo dentro de las 23 horas posteriores a su primer envío (EvoLink lo conserva durante 24 horas); después lo rechaza con recovery_window_passed. También sigue la regla de las cotizaciones: con una cotización caducada (quote_expired) o un precio más alto (price_changed) no se envía nada. En todos esos casos, comprueba con tasks batch o tasks list qué se envió correctamente y estima solo el resto como una generación o un lote nuevos. Si los registros se han perdido o han caducado, o si la cuenta ha cambiado, revisa el historial o la consola antes de crear otra solicitud facturable. La CLI no tiene ningún comando de cancelación.
Saldo y uso de las tareas
Subidas y descarga de originales
JSON, códigos de salida y configuración
—json escribe en stdout una sola línea JSON con schema_version:1 y ok. El progreso va a stderr. Los errores usan ok:false/error y un código de salida distinto de cero; con Ctrl-C, el comando suele salir con el código 130. Una tarea con status:failed no es lo mismo que un fallo al invocar una consulta. Comprueba primero el ok del comando y después el estado de la tarea. Los registros locales se guardan en ~/.evolink-media; las credenciales usan el almacenamiento seguro del sistema operativo. No copies este directorio para migrar el inicio de sesión ni borres los registros de cotización o de recuperación para arreglar un envío incierto. La opción avanzada —server selecciona el recurso de OAuth y la vinculación de identidad, de forma predeterminada https://mcp.evolink.ai/mcp, sin cambiar la ejecución REST. Mantén los valores predeterminados de producción de —api-url/—files-url; las URLs externas arbitrarias se rechazan. —token-stdin es un token de acceso de OAuth para un solo comando, no una clave API de la plataforma, y no sirve para setup. No pongas tokens en los argumentos de los comandos ni en los registros. No hay ningún comando genérico run, ni de chat de texto, cancelación, recarga de saldo, gestión de claves o archivo de alias personalizados. Usa la consola o la API correspondientes.Ruta de ejecución de la CLI y APIs
Desde la CLI 0.8.0, las solicitudes multimedia usan terminal o agente → EvoLink CLI → API REST de la plataforma. Las comprobaciones de las entradas, las referencias de modelos, la estimación y el formato de los resultados se ejecutan en local; la ejecución de negocio no llama a tools/call del MCP remoto.Comandos y operaciones del backend
El quote_id, —confirm y los archivos de recuperación de la CLI implementan un flujo de trabajo del cliente, no campos nuevos del backend. La versión publicada CLI 0.14.1 estima a partir de las reglas de precios públicas (tarifas de referencia, sin descuentos de cuenta). —max-cost-usd no es un tope de la liquidación final.
Solicitudes, recuperación y automatización
Guarda de forma persistente la cotización y el identificador de solicitud antes de enviar. REST usa los identificadores existentes Idempotency-Key / X-Evo-Run-Id. Si se pierde una respuesta, recupera el envío con la cotización original; no cambies de identidad, de entradas ni de identificadores para volver a enviar. Los registros del cliente, por sí solos, no demuestran una idempotencia uniforme del backend en todos los nodos de producción. Los scripts deben comprobar primero ok, después el estado de la tarea y, por último, los campos de resultados y de costo. Guarda el quote_id, el task_id y los manifiestos de descarga en lugar de depender de la última línea de la terminal. Los errores de consulta, las tareas fallidas y las descargas fallidas requieren un tratamiento distinto. No reintentes de forma incondicional los envíos de pago. Las sesiones de la CLI y del MCP nativo se gestionan por separado, pero el OAuth de la cuenta comparte actualmente los permisos, los límites y el estado de pausa deEvoLink MCP (OAuth). Para las conexiones nativas, usa la documentación aparte de MCP.