OpenAI CLI: OpenAI REST API uchun rasmiy komandali interfeys

OpenAI CLI — bu OpenAI REST API uchun rasmiy komandali interfeys (CLI). Bu vosita dasturchilar va texnik mutaxassislar uchun OpenAI xizmatlariga oson kirish imkonini beradi. CLI Go tilida yozilgan va Homebrew orqali osonlik bilan o'rnatilishi mumkin.

O'rnatish va ishlatish

OpenAI CLI ni o'rnatish va ishlatish uchun Go tilining 1.26 yoki undan yuqori versiyasi kerak. CLI ni o'rnatish uchun quyidagi buyruqlarni bajaring:

brew install openai/tools/openai

• Homebrew orqali o'rnatish: brew install openai/tools/openai
• Go orqali o'rnatish: go install 'github.com/openai/openai-cli/cmd/openai@latest'

O'rnatishdan so'ng, CLI binariy fayli sizning Go bin direktoryasiga joylashtiriladi. Agar buyruqlar topilmasa, Go bin direktoryasini PATHga qo'shing:

go install 'github.com/openai/openai-cli/cmd/openai@latest'

export PATH="$PATH:$(go env GOPATH)/bin"

CLI birinchi marta ishga tushirilganda, tasvir tanlovchi uchun qisqa yo'llarni saqlaydi. Bu qisqa yo'llar keyingi Bash, zsh va fish sessiyalarida ishlatilishi mumkin.

# Add to your shell profile (.zshrc, .bashrc, etc.)
export PATH="$PATH:$(go env GOPATH)/bin"

Yangi versiyalarni tekshirish

CLI har kuni bir marta yangi versiyalarni tekshiradi. Agar yangi versiya mavjud bo'lsa, foydalanuvchi xabar oladi. Bu xabarni o'chirish uchun OPENAI_CLI_NO_UPDATE_CHECK=1 o'zgaruvchini belgilang.

./scripts/run args...

API kalitlari

Standart API endpointlariga kirish uchun API kalitini belgilang:

openai <resource> [subresource...] <command> [flags...]

export OPENAI_API_KEY="sk-..."

Admin endpointlariga kirish uchun admin API kalitini belgilang:

export OPENAI_API_KEY="sk-..."

openai responses create \
  --input "Say this is a test" \
  --model gpt-5.5

export OPENAI_ADMIN_KEY="sk-admin-..."

Komandalar va flaglar

CLI resursga asoslangan komandalar tuzilmasidan foydalanadi. Misol uchun, openai images generate --prompt "A tiny orange robot" buyrug'i tasvirlarni yaratadi va ularga ~/Downloads/gpt-images/ direktoryasiga saqlaydi.

export OPENAI_ADMIN_KEY="sk-admin-..."

openai admin organization usage completions \
  --start-time 1735689600 \
  --end-time 1735776000 \
  --bucket-width 1d

Har qanday buyruq uchun to'liq yordam sahifasini olish uchun --help flagini qo'shing. Misol uchun, openai images generate --help buyrug'i tasvir yaratish uchun barcha variantlarni ko'rsatadi.

openai help setup                  # Enter your API key safely
openai images generate --help      # Example and every image option
openai help images generate        # The same complete image help
openai --help                      # Command groups and global options

Fayllar bilan ishlash

CLI lokal fayllarni yuklash, uni metadata ni ko'rish va uni yuklab olish imkonini beradi. Misol uchun, openai files upload "upload space.txt" --purpose user_data buyrug'i faylni yuklaydi va uning metadata ni ko'rsatadi.

CLI tasvirlarni yaratish, tahrirlash va ko'rish uchun ham ishlatilishi mumkin. Misol uchun, openai images preview "path/to/image.png" buyrug'i saqlangan tasvirni qayta ko'rsatadi.

Xatolar

Xatolar standart xatolar oqimiga (stderr) amalga oshiriladigan xulosa bilan chiqariladi. API xatosini JSON formatida olish uchun --format-error json flagini qo'shing.

Asl manba: github.com