# ============================================================
# WorldX 环境配置 / Environment Configuration
# ============================================================
# 除绘图模型可使用 Google 原生图片接口外，其余模型使用 OpenAI 兼容协议（chat/completions）。
# 你可以使用 OpenRouter、Google AI Studio、或任何兼容平台；绘图模型见 IMAGE_GEN_PROVIDER。
#
# All models use OpenAI-compatible chat/completions, except Image Generation can use Google's native image API.
# You can use OpenRouter, Google AI Studio, or any compatible platform; see IMAGE_GEN_PROVIDER for image generation.
# ============================================================

# --- 编排引擎 / Orchestrator ---
# 用于世界设计（角色、场景、规则等），建议使用推理模型。
# Used for world design (characters, scenes, rules). Recommend a reasoning model.
ORCHESTRATOR_BASE_URL=
ORCHESTRATOR_API_KEY=
ORCHESTRATOR_MODEL=

# --- 绘图模型 / Image Generation ---
# 用于生成地图和角色立绘，建议使用gemini-3.1-flash-image-preview或更强文生图模型。
# Used for map and character art. Recommend gemini-3.1-flash-image-preview or a stronger text-to-image model.
# 可选：openai-compatible（默认）或 google-native。Google AI Studio 图片生成请使用 google-native。
# Optional: openai-compatible (default) or google-native. Use google-native for Google AI Studio image generation.
IMAGE_GEN_PROVIDER=
IMAGE_GEN_BASE_URL=
IMAGE_GEN_API_KEY=
IMAGE_GEN_MODEL=

# --- 绘图审查 / Vision Review ---
# 用于审查生成的地图质量，建议使用gemini-3.1-pro-preview或更强多模态模型。
# Used for reviewing map quality. Recommend gemini-3.1-pro-preview or a stronger multimodal model.
VISION_BASE_URL=
VISION_API_KEY=
VISION_MODEL=

# --- 世界驱动 / Simulation Engine ---
# 用于驱动运行时角色行为（决策、对话、记忆），可使用任意模型。
# Powers runtime character behavior (decisions, dialogue, memory). Any model works.
SIMULATION_BASE_URL=
SIMULATION_API_KEY=
SIMULATION_MODEL=

# --- 生成调参 / Generation Tuning (可选 / Optional) ---
# MAP_IMAGE_SIZE_K=1
# STEP1_MAX_RETRIES=3
# STEP3_1_MAX_RETRIES=3
# STEP3_2_MAX_RETRIES=3
# STEP4_MAX_RETRIES=3

# ============================================================
# 示例：全部使用 OpenRouter
# Example: All OpenRouter
# 注册获取 API Key: https://openrouter.ai
# ============================================================
# ORCHESTRATOR_BASE_URL=https://openrouter.ai/api/v1
# ORCHESTRATOR_API_KEY=sk-or-v1-xxxx
# ORCHESTRATOR_MODEL=google/gemini-2.5-pro-preview
#
# IMAGE_GEN_BASE_URL=https://openrouter.ai/api/v1
# IMAGE_GEN_PROVIDER=openai-compatible
# IMAGE_GEN_API_KEY=sk-or-v1-xxxx
# IMAGE_GEN_MODEL=google/gemini-3.1-flash-image-preview
#
# VISION_BASE_URL=https://openrouter.ai/api/v1
# VISION_API_KEY=sk-or-v1-xxxx
# VISION_MODEL=google/gemini-3.1-pro-preview
#
# SIMULATION_BASE_URL=https://openrouter.ai/api/v1
# SIMULATION_API_KEY=sk-or-v1-xxxx
# SIMULATION_MODEL=google/gemini-2.5-flash-preview

# ============================================================
# 示例：全部使用 Google AI Studio
# Example: All Google AI Studio
# 获取 API Key: https://aistudio.google.com/apikey
# ============================================================
# ORCHESTRATOR_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai
# ORCHESTRATOR_API_KEY=AIzaSy...
# ORCHESTRATOR_MODEL=gemini-2.5-pro-preview
#
# IMAGE_GEN_PROVIDER=google-native
# IMAGE_GEN_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai
# IMAGE_GEN_API_KEY=AIzaSy...
# IMAGE_GEN_MODEL=gemini-3.1-flash-image-preview
#
# VISION_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai
# VISION_API_KEY=AIzaSy...
# VISION_MODEL=gemini-3.1-pro-preview
#
# SIMULATION_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai
# SIMULATION_API_KEY=AIzaSy...
# SIMULATION_MODEL=gemini-2.5-flash-preview