Ana içeriğe atla
CometAPI CLI ayarları bir TOML config dosyasından, ortam değişkenlerinden ve komut satırı bayraklarından okur. Aynı ayar birden fazla kaynaktan sağlandığında, öncelik sırası şöyledir: CLI flags > config file > environment variables > defaults

Config dosyası

Konum: ~/.config/cometapi/config.toml Config dosyasını etkileşimli olarak oluşturmak için kurulum sihirbazını çalıştırın:
cometapi init
Veya config alt komutuyla tek tek ayarları yönetin:
# 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

Kullanılabilir ayarlar

Config keyEnvironment variableDescription
api_keyCOMETAPI_KEYAPI anahtarı (tüm komutlar için gereklidir)
access_tokenCOMETAPI_ACCESS_TOKENHesap düzeyindeki komutlar için access token
base_urlCOMETAPI_BASE_URLAPI temel URL’si (varsayılan: https://api.cometapi.com/v1)
default_modelCOMETAPI_DEFAULT_MODELchat için varsayılan model (geri dönüş: gpt-5.4)
output_formatVarsayılan çıktı biçimi: table, json, yaml, csv veya markdown

Kimlik bilgileri

CLI iki tür kimlik bilgisi kullanır:

API anahtarı

Tüm komutlar için gereklidir. API anahtarı, CometAPI model uç noktalarına yapılan isteklerin kimliğini doğrular. CometAPI Console → API Keys üzerinden bir API anahtarı oluşturun. Bunu şu yollardan biriyle ayarlayın:
export COMETAPI_KEY="<COMETAPI_KEY>"

Access token

İsteğe bağlıdır. Access token şu hesap düzeyindeki komutlar için gereklidir: account, stats, tokens, logs ve tasks. CometAPI Console → Personal Settings üzerinden bir access token oluşturun. Bunu şu yollardan biriyle ayarlayın:
export COMETAPI_ACCESS_TOKEN="your-access-token"

Güvenlik

CLI aşağıdaki güvenlik uygulamalarını kullanır:
  • API anahtarları ve access token’lar asla loglanmaz veya tam olarak gösterilmez. Tanılama çıktısında yalnızca son 4 karakter gösterilir.
  • Config dosyası kısıtlayıcı izinlerle (0600) oluşturulur — yalnızca dosya sahibi tarafından okunabilir.
  • Kimlik bilgileri asla sürüm kontrolüne commit edilmemelidir. Uygunsa config dosyası yolunu .gitignore dosyanıza ekleyin.
API anahtarlarınızla yapılan tüm kullanım ve oluşan ücretlerden siz sorumlusunuz. Anahtarlarınızı güvende tutun ve yetkisiz erişimden şüpheleniyorsanız anahtarlarınızı yenileyin.

Sorun giderme

ErrorSolution
API key not configuredcometapi init komutunu çalıştırın veya COMETAPI_KEY ortam değişkenini ayarlayın
Connection failedBağlantıyı teşhis etmek için cometapi doctor komutunu çalıştırın
Access token not configuredYalnızca account/stats/tokens/logs/tasks için gereklidir. Bir tane eklemek için cometapi init komutunu çalıştırın