openai

# 🧠 OpenAI

OpenAI API integration — chat completions, embeddings, image generation, audio transcription, file management, fine-tuning, and assistants via the OpenAI REST API.

## Features

- **Chat completions** — GPT-4o, GPT-5, o1 model responses
- **Embeddings** — text-embedding-3 for semantic search
- **Image generation** — DALL-E 3 image creation and editing
- **Audio transcription** — Whisper speech-to-text
- **Text-to-speech** — TTS with multiple voices
- **File management** — upload and manage files
- **Fine-tuning** — create and manage fine-tuning jobs
- **Assistants** — build and manage AI assistants
- **Moderation** — content moderation checks
- **Models** — list available models and details

## Requirements

| Variable | Required | Description |
|----------|----------|-------------|
| `OPENAI_API_KEY` | ✅ | API key/token for OpenAI |

## Quick Start

```bash
# Send chat completion
python3 {baseDir}/scripts/openai.py chat "Explain quantum computing in 3 sentences" --model gpt-4o
```

```bash
# Chat with system prompt
python3 {baseDir}/scripts/openai.py chat-system --system "You are a Python expert" "How do I use asyncio?"
```

```bash
# Generate embeddings
python3 {baseDir}/scripts/openai.py embed "The quick brown fox" --model text-embedding-3-small
```

```bash
# Generate an image
python3 {baseDir}/scripts/openai.py image "A sunset over mountains, oil painting style" --size 1024x1024
```



## Commands

### `chat`
Send chat completion.
```bash
python3 {baseDir}/scripts/openai.py chat "Explain quantum computing in 3 sentences" --model gpt-4o
```

### `chat-system`
Chat with system prompt.
```bash
python3 {baseDir}/scripts/openai.py chat-system --system "You are a Python expert" "How do I use asyncio?"
```

### `embed`
Generate embeddings.
```bash
python3 {baseDir}/scripts/openai.py embed "The quick brown fox" --model text-embedding-3-small
```

### `image`
Generate an image.
```bash
python3 {baseDir}/scripts/openai.py image "A sunset over mountains, oil...