Documentation / API reference API reference — all endpoints The full list of GetVibe API endpoints with method, path, description and auth type. Endpoints are grouped by category. The base address for /v1/* is https://getvibeapi.com/v1; for /api/* it is https://getvibeapi.com.
A machine-readable OpenAPI 3.0 spec is available at
/api/openapi — import it into Postman, Swagger UI or any OpenAPI-compatible tool.
The public catalogs /api/catalog, /api/media-catalog are available without a key — use them for storefronts, price calculations and model discovery before signing up.
Method Endpoint Description Auth POST /v1/chat/completions OpenAI-compatible chat endpoint. BearerPOST /v1/messages Anthropic Messages-format endpoint. The path for Claude Code and the Anthropic SDK. x-api-key / BearerPOST /v1/responses OpenAI Responses API. The path for the Codex CLI (wire_api = "responses"). BearerPOST /v1/messages/count_tokens Stub token-count endpoint for the Anthropic SDK / Claude Code (an estimate, not an exact tokenizer). x-api-key / Bearer
Method Endpoint Description Auth GET /v1/models Available models with type, modalities and endpoints. Media on request: ?type=image, ?all=true or /v1/models/all; one model: /v1/models/{id}. BearerGET /v1/pricing Canonical programmatic price source for text models, including live operator overrides. BearerPOST /v1/embeddings Text embeddings for search, RAG and clustering. BearerPOST /v1/decisionsEvaluate named questions against a state (text->decisions). Not a chat endpoint; billed on input tokens only. Bearer
Method Endpoint Description Auth POST /api/media/generate Async media generation (image/video/audio/music/3d). Returns a jobId to poll. BearerGET /api/media/jobs/{id} Poll the status of an async media generation job. BearerGET /api/media/file/{id}/{idx} Signed proxy URL for a result (HMAC in the sig query param). Keyless — for embedding in <img>/<video>. sig (HMAC)GET /api/media-catalog Public media-model catalog: kind, variants, params, fromRub, axes. public
Method Endpoint Description Auth GET /v1/balance Remaining prepaid balance in USD. BearerGET /v1/generations Usage history with route / address_as (public route), request_id and pagination. BearerGET /v1/generations/{id} A single usage-history entry by id (from the /v1/generations response or the x-pv-generation-id header). BearerGET /v1/usage Per-key usage statistics with route and address_as fields. BearerGET /api/key/usage Per-key summary: balance, today/month spend, request count. Bearer / x-api-key
Method Endpoint Description Auth ANY x-getvibe-route / x-getvibe-model Response headers for trusted reveal/debug clients only: the public :alias and address_as of the winning route. response headers
Method Endpoint Description Auth GET /v1/keysList of API keys for the account. BearerPOST /v1/keysNot available via the API. Create and manage keys only in the dashboard (Keys section). — (UI only)
Method Endpoint Description Auth GET /api/webhooks Current webhook URLs (mediaWebhookUrl, balanceWebhookUrl). Dashboard session only. session (dashboard)PATCH /api/webhooks Set or clear mediaWebhookUrl / balanceWebhookUrl. Dashboard session only. session (dashboard)
Method Endpoint Description Auth GET /api/catalogPublic text-model catalog (no auth). Used by the site for the storefront. publicGET /api/media-catalog Public media-model catalog (kinds, per-unit prices, params, axes). public
