# Quick Setup Guide ## 1. Install Dependencies The dependencies are already installed, but if you need to reinstall: ```bash npm install ``` ## 2. Configure Your OpenAI API Key ### Option A: Create .env.local file (Recommended) Create a new file named `.env.local` in the root directory: ```bash # On Windows PowerShell New-Item -Path .env.local -ItemType File ``` Add your OpenAI API key to `.env.local`: ```env OPENAI_API_KEY=sk-proj-your_actual_api_key_here ``` ### Option B: Copy from example ```bash # On Windows PowerShell Copy-Item .env.local.example .env.local ``` Then edit `.env.local` and replace `your_openai_api_key_here` with your actual API key. ## 3. Get Your OpenAI API Key 1. Go to [OpenAI API Keys](https://platform.openai.com/api-keys) 2. Sign in to your OpenAI account 3. Click "Create new secret key" 4. Copy the key (it starts with `sk-proj-...`) 5. Paste it in your `.env.local` file **Important**: Make sure you have access to the Sora 2 API. This may require: - Joining a waitlist - Special API access approval - Sufficient API credits ## 4. Start the Development Server ```bash npm run dev ``` The application will be available at [http://localhost:3000](http://localhost:3000) ## 5. Verify Setup 1. Open your browser to [http://localhost:3000](http://localhost:3000) 2. If you see an orange warning about the API key, check your `.env.local` file 3. Try generating a test video with a simple prompt like: "A red ball bouncing on grass, sunny day" ## Troubleshooting ### "Failed to create video" error - Verify your API key is correct in `.env.local` - Ensure you have Sora 2 API access - Check your OpenAI account has sufficient credits ### Orange API key warning persists - Make sure `.env.local` file exists in the root directory - Verify the file contains: `OPENAI_API_KEY=sk-proj-...` - Restart the development server after creating/editing `.env.local` - The file name should be exactly `.env.local` (with the dot at the start) ### Port already in use - Next.js will automatically use the next available port (3001, 3002, etc.) - Or stop the existing process using port 3000 ## Next Steps Once setup is complete: 1. **Generate your first video**: Go to the Generate tab and create a video 2. **Explore the library**: View all your generated videos in the Library tab 3. **Try remixing**: Select a completed video and remix it with changes ## File Structure Check Make sure you have these key files: ``` sora2-api/ ├── .env.local # Your API key (create this) ├── .env.local.example # Template (already exists) ├── app/ │ ├── api/videos/ # API routes │ └── page.tsx # Main UI ├── components/ │ ├── video-generator.tsx │ ├── video-library.tsx │ └── video-remix.tsx └── package.json ``` ## Support If you encounter issues: 1. Check the main [README.md](./README.md) for detailed documentation 2. Review [OpenAI's Sora documentation](https://platform.openai.com/docs/api-reference/videos) 3. Verify your API key has the necessary permissions