How ikhsan3adi/gemini-web2api works
gemini-web2api is a Go proxy that presents Gemini’s web interface through OpenAI-compatible and Google-native APIs. The main workflow accepts a client request, normalizes its model and prompt (including tools and images), uploads images when needed, calls Gemini, and returns a compatible response or stream. The graph preserves the distinct API adapters, multimodal support, and Gemini transport layer. Some internal call paths are unsampled; those links are documented by the README rather than inferred from package layout.
Main entry points: client.go Gemini Client · server.go HTTP App · chat.go Chat Completions · responses.go Responses API
Components 19
Runtime Setup
- Process Startup
main.go - Configuration
internal/config/config.go - HTTP App
internal/server/server.go
API Adapters
- Chat Completions
internal/server/chat.go - Responses API
internal/server/responses.go - Google API
internal/server/google.go
Request Conversion
- Model Catalog
internal/models/models.go - OpenAI Conversion
internal/format/openai.go - Google Conversion
internal/format/google.go - Responses Conversion
internal/format/responses.go
Multimodal Support
- Image Parsing
internal/format/openai.go - Page Tokens
internal/multimodal/tokens.go - Image Upload
internal/multimodal/upload.go
Gemini Integration
- Gemini Client
internal/gemini/client.go - RPC Payload
internal/gemini/payload.go - Cookie Authentication
internal/gemini/auth.go
Other components
- API Clients
- Gemini Web
- Image Hosts
Connections 27
- API Clients → HTTP App: submit requests
README.md - Process Startup → Configuration: loads settings
main.go - Process Startup → HTTP App: starts server
main.go - HTTP App → Chat Completions: routes chat
internal/server/server.go - HTTP App → Responses API: routes responses
internal/server/server.go - HTTP App → Google API: routes Google API
internal/server/server.go - Chat Completions → OpenAI Conversion: normalizes request
internal/server/chat.go - Responses API → Responses Conversion: converts input
internal/server/responses.go - Responses Conversion → OpenAI Conversion: normalizes messages
- Google API → Google Conversion: converts request
internal/server/google.go - Chat Completions → Model Catalog: resolves model
internal/server/chat.go - Responses API → Model Catalog: resolves model
internal/server/responses.go - Google API → Model Catalog: uses model catalog
internal/server/google.go - OpenAI Conversion → Image Parsing: extracts images
internal/format/openai.go - Image Parsing → Image Hosts: fetches image URLs
README.md - Chat Completions → Image Upload: uploads attachments
README.md - Responses API → Image Upload: uploads attachments
internal/server/responses.go - Image Upload → Page Tokens: uses upload tokens
- Image Upload → Gemini Web: uploads image data
internal/multimodal/upload.go - HTTP App → Gemini Client: creates client
internal/server/server.go - Chat Completions → Gemini Client: requests generation
README.md - Responses API → Gemini Client: requests generation
internal/server/responses.go - Google API → Gemini Client: requests generation
README.md - Gemini Client → RPC Payload: builds RPC payload
- Gemini Client → Gemini Web: sends generation requests
README.md - Gemini Client → Cookie Authentication: uses cookie auth
- Gemini Web → Gemini Client: returns generated output