跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

CometAPI CLI 会从 TOML 配置文件、环境变量和命令行标志中读取设置。当同一个设置可从多个来源提供时，优先级顺序为： CLI 标志 > 配置文件 > 环境变量 > 默认值

​
配置文件

位置：~/.config/cometapi/config.toml 运行设置向导以交互方式创建配置文件： 
cometapi init
或者使用 config 子命令管理单个设置： 
# View current configuration
cometapi config show

# Set a value
cometapi config set api_key sk-...

# Remove a value
cometapi config unset api_key

# Show the config file path
cometapi config path

​
可用设置

Config keyEnvironment variableDescription
api_keyCOMETAPI_KEYAPI 密钥（所有命令均必需）
access_tokenCOMETAPI_ACCESS_TOKEN用于账户级命令的访问令牌
base_urlCOMETAPI_BASE_URLAPI 基础 URL（默认值：https://api.cometapi.com/v1）
default_modelCOMETAPI_DEFAULT_MODELchat 的默认模型（回退值：gpt-5.4）
output_format—默认输出格式：table、json、yaml、csv 或 markdown

​
凭据

CLI 使用两种类型的凭据：

​
API key

所有命令都必需。API 密钥用于对发往 CometAPI 模型端点的请求进行身份验证。 在 CometAPI Console → API Keys 创建 API 密钥。 通过以下任一方式进行设置： 
read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY

​
Access token

可选。以下账户级命令需要访问令牌：account、stats、tokens、logs 和 tasks。 在 CometAPI Console → Personal Settings 生成访问令牌。 通过以下任一方式进行设置： 
export COMETAPI_ACCESS_TOKEN="your-access-token"

​
安全

CLI 采用以下安全实践：
  • API 密钥和访问令牌绝不会被记录日志或完整显示。在诊断输出中只会显示最后 4 个字符。
  • 配置文件会以受限权限（0600）创建——仅文件所有者可读。
  • 凭据绝不应提交到版本控制中。如适用，请将配置文件路径添加到你的 .gitignore。
你需要对使用你的 API 密钥所产生的所有用量和费用负责。请妥善保管你的密钥；如果你怀疑存在未授权访问，请轮换这些密钥。

​
故障排查

ErrorSolution
API key not configured运行 cometapi init 或设置 COMETAPI_KEY 环境变量
Connection failed运行 cometapi doctor 以诊断连接问题
Access token not configured仅 account/stats/tokens/logs/tasks 需要。运行 cometapi init 添加一个