API Reference

API reference

The Pendra REST API is OpenAI-compatible. Base URL:

https://api.pendra.ai

Most endpoints live under /api/v1. The Anthropic-compatible surface (/v1/messages) and the OpenAI Responses API (/v1/responses) are mounted at the /v1 root so the official Anthropic and OpenAI SDKs work without any base-URL surgery. Audio transcription answers on both paths.

Interactive Swagger UI is available at https://api.pendra.ai/api/v1/docs, ReDoc at /api/v1/redoc, and the raw OpenAPI schema at /api/v1/openapi.json.

Endpoints

Chat completions

POST /api/v1/chat/completions

OpenAI-compatible chat. Streaming and non-streaming.

Embeddings

POST /api/v1/embeddings

Vector embeddings for retrieval and RAG.

Rerank

POST /v1/rerank

Reorder documents by relevance to a query.

Images

POST /api/v1/images/generations

Generate an image from a prompt.

Audio transcription

POST /api/v1/audio/transcriptions

Whisper-class speech-to-text. Multipart upload.

Models & catalogue

GET /api/v1/models

List live models and the public Pendra catalogue.

Anthropic Messages

POST /v1/messages

Anthropic-compatible endpoint for Claude SDKs.

Responses (Codex)

POST /v1/responses

OpenAI-compatible Responses API for Codex.

Authentication

Every request needs a Pendra API key (pdr_sk_…), sent as a bearer token. The Anthropic-compatible /v1/messages endpoint also accepts the x-api-key header. See Authentication for full details.

Errors & rate limits

Pendra returns standard HTTP status codes. Errors carry a JSON body and a X-Request-Id response header you can paste to support. See Errors & rate limits.

Capabilities

New to a feature? The Capabilities guides walk through chat, thinking, tool calling, structured outputs, vision, OCR, embeddings, reranking, image generation, and audio transcription with worked examples. This reference is the field-by-field companion.

SDKs

Pendra ships OpenAI-shaped SDKs: Python and Node. The OpenAI and Anthropic SDKs also work — just change the base URL and API key.