OppermindDocs
Try Oppermind
Sign inTry Oppermind

{ } Oppermind Developer API

Build with Lato.
Ship with confidence.

Learn the implemented v1 contract for text generation with images, documents and tools, plus image and video generation, then use the existing Developer console for keys, usage, billing, webhooks and team access.

Take the API quickstart Open Developer console

One request

Your first Lato API result.

Keep API keys server-side. Send a bearer key, JSON content and a stable idempotency key for retryable operations.

curl https://oppermind.com/api/v1/messages \
  -H "Authorization: Bearer $OPPERMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: request-2026-09-02-001" \
  -d '{"model":"oppermind-lato-1","max_tokens":1024,"messages":[{"role":"user","content":"Summarise this plan for an executive audience."}]}'

Store opmd_sk_... only on your server. Keys are shown once in the Developer console.

Current contractstream: true is rejected with OPMD_MODEL_005. Requests can be up to 31 MB with up to 2000 messages, output defaults to 16384 tokens and goes up to 128000, and each key can send 120 requests per minute. Every text response reports its charge in billing.charged_aud. Video responses are synchronous and proxy downloads remain authenticated.

Stable v1 surface

Text, files, image and video.

Use the same authentication and reliability conventions across every endpoint.

POST/api/v1/messages

Text generation

Send text, images and documents, call functions and built-in tools, and get the Oppermind native response.

Read endpoint guidance
POST/api/v1/chat/completions

Chat Completions format

Use an existing Chat Completions client by changing the base URL and the model.

Read endpoint guidance
POST/api/v1/responses

Responses format

Send stateless Responses API requests with input items and function calls.

Read endpoint guidance

Production integration

Design for retries and change.

Idempotency keys are retained for 24 hours. Deprecations include headers and a minimum 180-day runway.

Idempotency

Reuse the same Idempotency-Key of 8 to 255 characters for the same logical operation.

Read the guide

Errors and limits

Handle structured OPMD_* errors, 429 responses and authenticated media URLs.

Read the guide

Versioning

Read X-API-Version, Deprecation and Sunset headers; monitor the changelog.

Read the guide

Guided learning

From first request to production.

Start with a secure key and finish with retries, usage controls, version tracking and a tested integration.

Take the production course Open the real Developer console