SuperAPI AI 工具集

astria-api

编程与开发

查看项目

更新于 10-15 17:20

技能介绍

用途:通过内置 astria 命令行工具调用 Astria API,管理 tune(微调模型,也称 reference)、prompt、pack(GUI 中称 Template),并生成图像与视频。所有操作走 CLI,自动处理认证、API 基址与工作区范围,输出为 stdout 上的 JSON。

认证与配置:凭据来自环境变量或 ~/.astria/config.json(由 astria login 写入)。未认证时提示用户运行 astria login(需 API key)。用 astria whoami 查看当前账号。支持类似 AWS CLI 的 profile:astria --profile <name> ... 或 ASTRIA_PROFILE 环境变量,各 profile 存于 ~/.astria/config.<name>.json。

主要能力:astria models 查看图像与视频模型目录(含 tune id、分辨率、默认模型),--refresh 强制刷新;astria tunes list/get/create/update 管理 tune,create 支持 --image-url 与 --image(可重复),--name 为类别名,--model-type 默认 faceid;astria prompts list/get/update 管理 prompt,支持多种过滤;astria generate 生成图像,支持 --model、--num-images、--aspect-ratio、--resolution、--input-image、--seed、--pack-id、--wait;astria video 生成视频,图像阶段渲染首帧,再由视频模型按 --video-prompt 动画化,支持 --first-frame/--last-frame/--input-video、--duration、--video-model;astria download 按 prompt id 下载渲染产物(图片或 mp4);astria packs 管理 pack;astria workspaces/landing 管理落地页;astria cache refresh 生成本地快照与 SQLite 查询层,cache get/find/uses/stats 只读本地缓存;astria api 作为原始 API 逃生通道。

用法要点:prompt 中用 <model_type:id:1> name 引用 tune,name 必须紧跟其后;-w/--workspace 可指定或跨工作区;列表命令支持 --limit/--offset,默认按 id 降序。

限制:视频模型与费用按资料所列,成本随时长线性增长;motion-control 类模型必须提供 --input-video;--resolution 仅对列出分辨率的模型有效;缓存默认一天有效。资料未提供的内容暂未说明。