Voguesly API 使用指南

穩定提供 OpenAI 上游轉發，支援 API Key、OAuth 與多客戶端接入。

Base URL：https://api.voguesly.com
Models：/v1/models
Responses：/v1/responses
聯絡客服：Telegram: @samseah

1) API Key 測試

KEY='你的 API Key'

curl -sS https://api.voguesly.com/v1/models \
  -H "Authorization: Bearer $KEY"

curl -sS https://api.voguesly.com/v1/responses \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "input": "只回覆 test ok",
    "store": false
  }'

2) Codex CLI 一鍵配置

bash << 'SETUP_SCRIPT'
mkdir -p ~/.codex
[ -f ~/.codex/config.toml ] && cp ~/.codex/config.toml ~/.codex/config.toml.bak
cat > ~/.codex/config.toml << 'CODEX_CONFIG'
model_provider = "voguesly"
model = "gpt-5.4"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"

[model_providers.voguesly]
name = "voguesly"
base_url = "https://api.voguesly.com"
wire_api = "responses"
requires_openai_auth = true
CODEX_CONFIG

cat > ~/.codex/auth.json << 'CODEX_AUTH'
{
  "OPENAI_API_KEY": "你的 API Key"
}
CODEX_AUTH
echo "✅ Done!"
SETUP_SCRIPT

3) VSCode (Cursor) / Codex App

客戶端均可直接使用 OpenAI 兼容方式接入：

Endpoint：https://api.voguesly.com
API Key：填你的 Voguesly Key
Model：可先選 gpt-5.4（穩定）

若插件需要完整路徑，填 https://api.voguesly.com/v1 亦可。

4) 常見問題

INVALID_API_KEY：通常是 Key 字串格式錯誤或含多餘字元。
Upstream request failed：上游暫時不可用或模型映射未生效。
OAuth 看不到入口：請確認後台已啟用 Google OAuth 並填好回調 URL。