Skip to main content
Repo dùng 5 API key, lưu trong file .env ở root. File mẫu là env.example.
.env đã nằm trong .gitignore. TUYỆT ĐỐI KHÔNG commit file này — sẽ lộ key.

​
Tạo file .env

cp env.example .env
Sau đó mở .env và điền giá trị từng biến.

​
Bảng các biến

BiếnVai tròBắt buộcLink tạo key
OPENAI_API_KEYEmbed text-embedding-3-small (asset index) + mọi skill dùng GPTCóplatform.openai.com/api-keys
GEMINI_API_KEYVision/multimodal analyzer cho asset index (image, video, audio)Cóaistudio.google.com/apikey
AUSYNCLAB_API_KEYSinh narration audio qua $ausynclab-voiceTuỳ chọnausynclab.io
AUSYNCLAB_VOICE_IDID voice mặc định cho TTSTuỳ chọnList voice trong AusyncLab dashboard
FAL_API_KEYSinh ảnh AI qua $fal-image-generator (model nano-banana, flux…)Tuỳ chọnfal.ai dashboard
Auto installer (setup/Install.command / Install.bat) sẽ prompt 2 key bắt buộc và tự ghi vào .env. AusyncLab và fal.ai key prompt sau, hoặc bỏ qua nếu không dùng voice TTS / AI image.
Script $fal-image-generator cũng nhận tên cũ FAL_KEY (alias) để tương thích với env mẫu của fal.ai chính thức — không cần đổi nếu bạn đã copy từ docs fal.

​
Ví dụ .env đầy đủ

OPENAI_API_KEY=sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
GEMINI_API_KEY=AIzaSyxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
AUSYNCLAB_API_KEY=ausx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
AUSYNCLAB_VOICE_ID=voice_001
FAL_API_KEY=fal-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

​
Verify key đã hoạt động

.venv/bin/python -c "import os; from openai import OpenAI; print(OpenAI(api_key=os.getenv('OPENAI_API_KEY')).models.list().data[0].id)"
Output: tên model đầu tiên (ví dụ gpt-4o). Nếu lỗi 401 → key sai/hết quota.
.venv/bin/python -c "import os, google.generativeai as g; g.configure(api_key=os.getenv('GEMINI_API_KEY')); print([m.name for m in g.list_models()][:3])"
Output: 3 model name đầu tiên. Nếu lỗi → key sai hoặc chưa enable Generative Language API trong AI Studio.
curl -s -H "Authorization: Key $(grep ^FAL_API_KEY .env | cut -d= -f2)" \
  https://queue.fal.run/fal-ai/nano-banana | head -50
Output: JSON schema model. Nếu 401 → key sai. Nếu 404 → đã verify được auth, model id ổn.

​
Lưu ý bảo mật

  • Mỗi key có quota riêng — kiểm tra dashboard nhà cung cấp trước khi index pool lớn.
  • Quay key (rotate) định kỳ; nếu nghi lộ → revoke ngay từ dashboard và sinh key mới.
  • Không paste key vào Issue, PR, hoặc chat public — dùng GitHub Secret nếu cần CI.

​
Bước tiếp theo

Cấu trúc dự án

Hiểu các thư mục skills/, jobs/, tools/, raw_assets/.

Sử dụng cơ bản

Drop file → search → status workflow.