/api/v1/messagesText generation
Create conversational and structured text results.
Read endpoint guidance{ } Oppermind Developer API
Learn the implemented v1 contract for text, image and video generation, then use the existing Developer console for keys, usage, billing, webhooks and team access.
One request
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 '{"input":"Summarise this plan for an executive audience."}'Store opmd_sk_... only on your server. Keys are shown once in the Developer console.
stream: true is rejected with OPMD_MODEL_005. Video responses are synchronous and proxy downloads remain authenticated.Stable v1 surface
Use the same authentication and reliability conventions across every endpoint.
/api/v1/messagesCreate conversational and structured text results.
Read endpoint guidance/api/v1/imagesGenerate image results with authenticated delivery.
Read endpoint guidance/api/v1/videosCreate synchronous video results and retrieve them securely.
Read endpoint guidanceProduction integration
Idempotency keys are retained for 24 hours. Deprecations include headers and a minimum 180-day runway.
Reuse the same 8–255 character Idempotency-Key for the same logical operation.
Read the guideHandle structured OPMD_* errors, 429 responses and authenticated media URLs.
Read the guideRead X-API-Version, Deprecation and Sunset headers; monitor the changelog.
Read the guideGuided learning
Start with a secure key and finish with retries, usage controls, version tracking and a tested integration.