# Show HN： GoModel--一个基于 Go 语言的开源 AI 网关 - 来源：Hacker News 热门（buzzing.cc 中文翻译） - 作者：santiago-pl - 发布时间：2026-04-22 02:18 - AIHOT 链接：https://aihot.virxact.com/items/cmo8z07ya00g3slc2ttg870y3 - 原文链接：https://github.com/ENTERPILOT/GOModel ## AI 摘要 开源项目 GoModel 基于 Go 语言构建，提供 AI 网关功能，代码已发布至 GitHub。该项目于 4 月 21 日在 Hacker News 的 Show HN 板块亮相，获得 102 个赞。GoModel 旨在利用 Go 语言的高并发特性，为 AI 应用提供统一的模型接入和管理层，简化多模型服务的集成与调用流程。 ## 正文 GoModel - AI Gateway in Go A fast and lightweight AI gateway written in Go, providing a unified OpenAI-compatible API for OpenAI, Anthropic, Gemini, DeepSeek, xAI, Groq, OpenRouter, Z.ai, Azure OpenAI, Oracle, Ollama, and more. Quick Start with Docker Step 1: Start GoModel container docker run --rm -p 8080:8080 \ -e LOGGING_ENABLED=true \ -e LOGGING_LOG_BODIES=true \ -e LOG_FORMAT=text \ -e LOGGING_LOG_HEADERS=true \ -e OPENAI_API_KEY="your-openai-key" \ enterpilot/gomodel Pass only the provider credentials or base URL you need (at least one required): docker run --rm -p 8080:8080 \ -e OPENAI_API_KEY="your-openai-key" \ -e ANTHROPIC_API_KEY="your-anthropic-key" \ -e GEMINI_API_KEY="your-gemini-key" \ -e VERTEX_PROJECT="your-gcp-project" \ -e VERTEX_LOCATION="us-central1" \ -e VERTEX_AUTH_TYPE="gcp_adc" \ -e DEEPSEEK_API_KEY="your-deepseek-key" \ -e GROQ_API_KEY="your-groq-key" \ -e OPENROUTER_API_KEY="your-openrouter-key" \ -e ZAI_API_KEY="your-zai-key" \ -e XAI_API_KEY="your-xai-key" \ -e AZURE_API_KEY="your-azure-key" \ -e AZURE_BASE_URL="https://your-resource.openai.azure.com/openai/deployments/your-deployment" \ -e AZURE_API_VERSION="2024-10-21" \ -e ORACLE_API_KEY="your-oracle-key" \ -e ORACLE_BASE_URL="https://inference.generativeai.us-chicago-1.oci.oraclecloud.com/20231130/actions/v1" \ -e ORACLE_MODELS="openai.gpt-oss-120b,xai.grok-3" \ -e OLLAMA_BASE_URL="http://host.docker.internal:11434/v1" \ -e VLLM_BASE_URL="http://host.docker.internal:8000/v1" \ enterpilot/gomodel ⚠️ Avoid passing secrets via -e on the command line - they can leak via shell history and process lists. For production, use docker run --env-file .env to load API keys from a file instead. -e docker run --env-file .env Step 2: Make your first API call curl http://localhost:8080/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5-chat-latest", "messages": [{"role": "user", "content": "Hello!"}] }' That's it! GoModel automatically detects which providers are available based on the credentials you supply. Supported LLM Providers Example model identifiers are illustrative and subject to change; consult provider catalogs for current models. Feature columns reflect gateway API support, not every individual model capability exposed by an upstream provider. Provider Credential Example Model Chat /responses Embed Files Batches Passthru OpenAI OPENAI_API_KEY gpt-5.5 ✅ ✅ ✅ ✅ ✅ ✅ Anthropic ANTHROPIC_API_KEY claude-sonnet-4-20250514 ✅ ✅ ❌ ❌ ✅ ✅ Google Gemini GEMINI_API_KEY gemini-2.5-flash ✅ ✅ ✅ ✅ ✅ ❌ Vertex AI VERTEX_PROJECT + VERTEX_LOCATION google/gemini-2.5-flash ✅ ✅ ✅ ❌ ❌ ❌ DeepSeek DEEPSEEK_API_KEY deepseek-v4-pro ✅ ✅ ❌ ❌ ❌ ✅ Groq GROQ_API_KEY llama-3.3-70b-versatile ✅ ✅ ✅ ✅ ✅ ❌ OpenRouter OPENROUTER_API_KEY google/gemini-2.5-flash ✅ ✅ ✅ ✅ ✅ ✅ Z.ai ZAI_API_KEY (ZAI_BASE_URL optional) glm-5.1 ✅ ✅ ✅ ❌ ❌ ✅ xAI (Grok) XAI_API_KEY grok-4 ✅ ✅ ✅ ✅ ✅ ❌ Alibaba Cloud Model Studio (Bailian) BAILIAN_API_KEY (BAILIAN_BASE_URL optional) qwen3-max ✅ ✅ ✅ ✅ ✅ ✅ MiniMax MINIMAX_API_KEY (MINIMAX_BASE_URL optional) MiniMax-M3 ✅ ✅ ✅ ❌ ❌ ✅ Xiaomi MiMo XIAOMI_API_KEY (XIAOMI_BASE_URL optional) mimo-v2.5-pro ✅ ✅ ❌ ❌ ❌ ✅ Azure OpenAI AZURE_API_KEY + AZURE_BASE_URL (AZURE_API_VERSION optional) gpt-5 ✅ ✅ ✅ ✅ ✅ ✅ Oracle ORACLE_API_KEY + ORACLE_BASE_URL openai.gpt-oss-120b ✅ ✅ ❌ ❌ ❌ ❌ Ollama OLLAMA_BASE_URL llama3.2 ✅ ✅ ✅ ❌ ❌ ❌ vLLM VLLM_BASE_URL (VLLM_API_KEY optional) meta-llama/Llama-3.1-8B-Instruct ✅ ✅ ✅ ❌ ❌ ✅ Amazon Bedrock BEDROCK_BASE_URL (region or endpoint) + AWS credentials anthropic.claude-3-5-haiku-20241022-v1:0 ✅ ✅ ❌ ❌ ❌ ❌ /responses OPENAI_API_KEY gpt-5.5 ANTHROPIC_API_KEY claude-sonnet-4-20250514 GEMINI_API_KEY gemini-2.5-flash VERTEX_PROJECT VERTEX_LOCATION google/gemini-2.5-flash DEEPSEEK_API_KEY deepseek-v4-pro GROQ_API_KEY llama-3.3-70b-versatile OPENROUTER_API_KEY google/gemini-2.5-flash ZAI_API_KEY ZAI_BASE_URL glm-5.1 XAI_API_KEY grok-4 BAILIAN_API_KEY BAILIAN_BASE_URL qwen3-max MINIMAX_API_KEY MINIMAX_BASE_URL MiniMax-M3 XIAOMI_API_KEY XIAOMI_BASE_URL mimo-v2.5-pro AZURE_API_KEY AZURE_BASE_URL AZURE_API_VERSION gpt-5 ORACLE_API_KEY ORACLE_BASE_URL openai.gpt-oss-120b OLLAMA_BASE_URL llama3.2 VLLM_BASE_URL VLLM_API_KEY meta-llama/Llama-3.1-8B-Instruct BEDROCK_BASE_URL anthropic.claude-3-5-haiku-20241022-v1:0 ✅ Supported ❌ Unsupported For Z.ai's GLM Coding Plan, set ZAI_BASE_URL=https://api.z.ai/api/coding/paas/v4. Xiaomi MiMo TTS (mimo-v2.5-tts*) and ASR (mimo-v2.5-asr) are served through /v1/audio/speech and /v1/audio/transcriptions (translated to MiMo's chat-completions audio dialect) as well as directly via chat completions; for 1M context append [1m] to the model ID and list it in XIAOMI_MODELS. Configured model lists are available for every provider with _MODELS, for example OPENROUTER_MODELS=openai/gpt-oss-120b,anthropic/claude-sonnet-4 or ORACLE_MODELS=openai.gpt-oss-120b,xai.grok-3. DeepSeek defaults to https://api.deepseek.com; set DEEPSEEK_BASE_URL only when using a compatible proxy or alternate DeepSeek endpoint. By default, CONFIGURED_PROVIDER_MODELS_MODE=fallback uses those lists only when upstream /models is unavailable or empty. Set CONFIGURED_PROVIDER_MODELS_MODE=allowlist to expose only configured models for providers that define a list, skipping their upstream /models calls. For vLLM, set VLLM_API_KEY only if the upstream server was started with --api-key. To register multiple instances of the same provider type without config.yaml, use suffixed env vars such as OPENAI_EAST_API_KEY and OPENAI_EAST_BASE_URL; add OPENAI_EAST_MODELS to configure that instance's model list. This registers provider openai-east with type openai. Vertex AI follows the same suffix pattern — VERTEX_US_PROJECT registers provider vertex-us. Vertex project and location env vars must match the instance prefix: for a suffixed instance such as VERTEX_US_PROJECT, also set VERTEX_US_LOCATION and any other suffixed settings for that instance, rather than the generic VERTEX_PROJECT / VERTEX_LOCATION. VERTEX_AUTH_TYPE defaults to Application Default Credentials (gcp_adc). ZAI_BASE_URL=https://api.z.ai/api/coding/paas/v4 mimo-v2.5-tts* mimo-v2.5-asr /v1/audio/speech /v1/audio/transcriptions [1m] XIAOMI_MODELS _MODELS OPENROUTER_MODELS=openai/gpt-oss-120b,anthropic/claude-sonnet-4 ORACLE_MODELS=openai.gpt-oss-120b,xai.grok-3 https://api.deepseek.com DEEPSEEK_BASE_URL CONFIGURED_PROVIDER_MODELS_MODE=fallback /models CONFIGURED_PROVIDER_MODELS_MODE=allowlist /models VLLM_API_KEY --api-key config.yaml OPENAI_EAST_API_KEY OPENAI_EAST_BASE_URL OPENAI_EAST_MODELS openai-east openai VERTEX_US_PROJECT vertex-us VERTEX_US_PROJECT VERTEX_US_LOCATION VERTEX_PROJECT VERTEX_LOCATION VERTEX_AUTH_TYPE gcp_adc Alternative Setup Methods Running from Source Prerequisites: Go 1.26.4+ Create a .env file: cp .env.template .env Create a .env file: .env cp .env.template .env Add your API keys to .env (at least one required). Add your API keys to .env (at least one required). .env Start the server: make run Start the server: make run Docker Compose Infrastructure only (Redis, PostgreSQL, MongoDB, Adminer - no image build): docker compose up -d # or: make infra Full stack (adds GoModel + Prometheus; builds the app image): cp .env.template .env # Add your API keys to .env docker compose --profile app up -d # or: make image Service URL GoModel API http://localhost:8080 Adminer (DB UI) http://localhost:8081 Prometheus http://localhost:9090 Building the Docker Image Locally docker build -t gomodel . docker run --rm -p 8080:8080 --env-file .env gomodel API Endpoints OpenAI-Compatible API Endpoint Method Description /v1/chat/completions POST Chat completions (streaming supported) /v1/responses POST OpenAI Responses API /v1/conversations POST Create a conversation (gateway-managed) /v1/conversations/{id} GET Retrieve a conversation /v1/conversations/{id} POST Replace conversation metadata in full /v1/conversations/{id} DELETE Delete a conversation /v1/embeddings POST Text embeddings /v1/models GET List available models /v1/files POST Upload a file (OpenAI-compatible multipart) /v1/files GET List files /v1/files/{id} GET Retrieve file metadata /v1/files/{id} DELETE Delete a file /v1/files/{id}/content GET Retrieve raw file content /v1/batches POST Create a native provider batch (OpenAI-compatible schema; inline requests supported where provider-native) /v1/batches GET List stored batches /v1/batches/{id} GET Retrieve one stored batch /v1/batches/{id}/cancel POST Cancel a pending batch /v1/batches/{id}/results GET Retrieve native batch results when available /v1/chat/completions /v1/responses /v1/conversations /v1/conversations/{id} /v1/conversations/{id} /v1/conversations/{id} /v1/embeddings /v1/models /v1/files /v1/files /v1/files/{id} /v1/files/{id} /v1/files/{id}/content /v1/batches requests /v1/batches /v1/batches/{id} /v1/batches/{id}/cancel /v1/batches/{id}/results Anthropic-Compatible API Endpoint Method Description /v1/messages POST Anthropic Messages API through translated model routing (streaming supported) /v1/messages/count_tokens POST Heuristic Anthropic Messages input token estimate /v1/messages /v1/messages/count_tokens Provider Passthrough Endpoint Method Description /p/{provider}/... GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS Provider-native passthrough with opaque upstream responses /p/{provider}/... Admin Endpoints Endpoint Method Description /admin/dashboard GET Admin dashboard UI /admin/runtime/config GET Admin runtime configuration /admin/cache/overview GET Cache statistics overview /admin/usage/summary GET Aggregate token usage statistics /admin/usage/daily GET Per-period token usage breakdown /admin/usage/models GET Usage breakdown by model /admin/usage/user-paths GET Usage breakdown by user path /admin/usage/log GET Paginated usage log entries /admin/audit/detail GET Detailed audit entry information /admin/audit/log GET Paginated audit log entries /admin/audit/conversation GET Conversation thread around one audit entry /admin/providers/status GET Provider availability status /admin/runtime/refresh POST Refresh runtime configuration /admin/models GET List models with provider type /admin/models/categories GET List model categories /admin/model-overrides GET List model overrides /admin/model-overrides PUT Create/update model override /admin/model-overrides DELETE Remove model override /admin/auth-keys GET List authentication keys /admin/dashboard /admin/runtime/config /admin/cache/overview /admin/usage/summary /admin/usage/daily /admin/usage/models /admin/usage/user-paths /admin/usage/log /admin/audit/detail /admin/audit/log /admin/audit/conversation /admin/providers/status /admin/runtime/refresh /admin/models /admin/models/categories /admin/model-overrides /admin/model-overrides /admin/model-overrides /admin/auth-keys Legacy alias: Until 2026-08-09, all admin endpoints are also reachable under /admin/api/v1/*. Legacy responses include Deprecation: true and Sunset: Sun, 09 Aug 2026 00:00:00 GMT headers. The endpoint formerly at /admin/api/v1/dashboard/config moved to /admin/runtime/config on the new prefix. Legacy alias: Until 2026-08-09, all admin endpoints are also reachable under /admin/api/v1/*. Legacy responses include Deprecation: true and Sunset: Sun, 09 Aug 2026 00:00:00 GMT headers. The endpoint formerly at /admin/api/v1/dashboard/config moved to /admin/runtime/config on the new prefix. /admin/api/v1/* Deprecation: true Sunset: Sun, 09 Aug 2026 00:00:00 GMT /admin/api/v1/dashboard/config /admin/runtime/config Operations Endpoints Endpoint Method Description /health GET Health check /metrics GET Prometheus metrics (experimental, when enabled) /swagger/index.html GET Swagger UI (when enabled) /health /metrics /swagger/index.html Gateway Configuration GoModel is configured through environment variables and an optional config.yaml. Environment variables override YAML values. See .env.template and config/config.example.yaml for the available options. config.yaml .env.template config/config.example.yaml Key settings: Variable Default Description PORT 8080 Server port BASE_PATH / Mount the gateway under a path prefix such as /g GOMODEL_MASTER_KEY (none) API key for authentication USER_PATH_HEADER X-GoModel-User-Path Header used to read/write request user_path values ENABLE_PASSTHROUGH_ROUTES true Enable provider-native passthrough routes under /p/{provider}/... ALLOW_PASSTHROUGH_V1_ALIAS true Allow /p/{provider}/v1/... aliases while keeping /p/{provider}/... canonical ENABLED_PASSTHROUGH_PROVIDERS openai,anthropic,openrouter,zai,vllm,deepseek Comma-separated list of enabled passthrough providers GEMINI_API_MODE native Gemini AI Studio upstream mode: native or openai_compatible VERTEX_API_MODE native Vertex AI Gemini upstream mode: native or openai_compatible USE_GOOGLE_GEMINI_NATIVE_API true Legacy global Gemini mode toggle used when per-provider *_API_MODE is unset STORAGE_TYPE sqlite Storage backend (sqlite, postgresql, mongodb) METRICS_ENABLED false Enable Prometheus metrics (experimental) LOGGING_ENABLED false Enable audit logging DASHBOARD_LIVE_LOGS_ENABLED true Stream realtime dashboard log previews with bounded replay DASHBOARD_LIVE_LOGS_BUFFER_SIZE 10000 Max in-memory live events retained; increase above ~1000 msgs/sec or bursty traffic DASHBOARD_LIVE_LOGS_REPLAY_LIMIT 1000 Max events replayed after reconnect; increase for longer reconnect windows DASHBOARD_LIVE_LOGS_HEARTBEAT_SECONDS 15 SSE heartbeat interval; lower when proxies need faster liveness checks GUARDRAILS_ENABLED false Enable the configured guardrails pipeline PORT 8080 BASE_PATH / /g GOMODEL_MASTER_KEY USER_PATH_HEADER X-GoModel-User-Path user_path ENABLE_PASSTHROUGH_ROUTES true /p/{provider}/...