AI Core Docs

Русский

English

Русский

English

Appearance

AI Core CLI ​

ai-core — это релизный CLI-артефакт для вызова узконаправленных возможностей AI Core из процесса-хоста. Host отвечает за планирование, отмену, таймауты, политику перезапуска процессов, захват stdout/stderr и устойчивое хранилище.

Авторизация ​

Каждая операция, кроме --version и help, требует:

  • --license PATH: документ core.license.v1, подписанный Marketplace;
  • --license-key PATH: соответствующий закрытый ключ ML-KEM, в виде необработанных байтов или текста multibase-base64url.

CLI только передает эти входные данные. AI Core проверяет подпись, текущий срок действия и то, что закрытый ключ соответствует открытому ключу KEM в лицензии. Неверная или отсутствующая лицензия приводит к сбою до того, как Core выполнит операцию.

Команды релиза ​

Каждый релизный binary поддерживает:

sh
ai-core --version
ai-core help

Варианты builtin-speech-whisper и builtin-local-all дополнительно предоставляют прямое преобразование аудио в текст:

sh
ai-core transcribe-audio /path/to/input.wav \
  --license /secure/core.license.json \
  --license-key /secure/core.kem.key \
  --language ru

transcribe-audio записывает только транскрипт в stdout. Он принимает необязательные --format, --sample-rate-hz и --language; в противном случае формат берется из расширения имени файла. Whisper model определяется через SPEECH_WHISPER_MODEL, затем SPEECH_WHISPER_MODEL_DIR, затем платформенный default для ggml-large-v3-turbo.bin.

Если binary был собран без speech support, transcribe-audio не компилируется в него и не появляется в --help.

Интеграция с подпроцессом ​

rust
use tokio::process::Command;

let output = Command::new("/opt/ai-core/bin/ai-core")
    .arg("transcribe-audio")
    .arg("/data/input.wav")
    .arg("--license")
    .arg("/secure/core.license.json")
    .arg("--license-key")
    .arg("/secure/core.kem.key")
    .output()
    .await?;

if !output.status.success() {
    return Err(String::from_utf8_lossy(&output.stderr).into());
}
let transcript = String::from_utf8(output.stdout)?;

Выбирайте релизный артефакт, который соответствует целевой платформе, trust mode, версии AI Core и требуемой native capability. Релизные варианты публикуются в dist/cli/release/<variant>/ai-core командой make build-cli-release-all.

AI Core documentation site.