SDKs Overview

OpenAI SDK Compatibility

Mavera’s Responses API is fully compatible with OpenAI SDKs. This means you can use the official OpenAI libraries in any language — just change the base URL and use client.responses.create().

Python

Official OpenAI Python SDK

JavaScript/TypeScript

Official OpenAI Node.js SDK

Go

go-openai or REST

Quick Setup

from openai import OpenAI

client = OpenAI(
    api_key="mvra_live_your_key_here",
    base_url="https://app.mavera.io/api/v1",
)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "mvra_live_your_key_here",
  baseURL: "https://app.mavera.io/api/v1",
});

import "github.com/sashabaranov/go-openai"

config := openai.DefaultConfig("mvra_live_your_key_here")
config.BaseURL = "https://app.mavera.io/api/v1"
client := openai.NewClientWithConfig(config)

curl -X POST https://app.mavera.io/api/v1/responses \
  -H "Authorization: Bearer mvra_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"model": "mavera-1", "persona_id": "YOUR_PERSONA_ID", "input": "..."}'

Mavera-Specific Fields

While the base API is OpenAI-compatible, Mavera adds specific fields:

Field	Description	How to Pass
`persona_id`	ID of persona to use	Python: `extra_body` in `responses.create()`, JS: direct field
`analysis_mode`	Enable structured analysis	Python: `extra_body` in `responses.create()`, JS: direct field
`reasoning_effort`	Control reasoning depth	Python: `extra_body` in `responses.create()`, JS: direct field

Example with Mavera Fields

response = client.responses.create(
    model="mavera-1",
    input="Hello",
    extra_body={
        "persona_id": "YOUR_PERSONA_ID",
        "analysis_mode": True,
    },
)

const response = await client.responses.create({
  model: "mavera-1",
  input: "Hello",
  // @ts-ignore - Mavera custom field
  persona_id: "YOUR_PERSONA_ID",
  analysis_mode: true,
});

REST API

For non-Chat endpoints (Mave, Focus Groups, etc.), use REST directly:

import requests

headers = {"Authorization": "Bearer mvra_live_your_key_here"}

# Mave Agent
response = requests.post(
    "https://app.mavera.io/api/v1/mave/chat",
    headers=headers,
    json={"message": "Analyze market trends"}
)

# Focus Groups
response = requests.post(
    "https://app.mavera.io/api/v1/focus-groups",
    headers=headers,
    json={...}
)

Language Support

Language	SDK	Notes
Python	`openai`	Full support via `extra_body`
JavaScript	`openai`	Full support
TypeScript	`openai`	Full support with types
Go	`go-openai`	Requires custom fields
Ruby	`ruby-openai`	Requires custom fields
PHP	`openai-php`	Requires custom fields
Any	REST	Full control

For languages without first-class Mavera support, you can always use the REST API directly.

Getting Started

Core Concepts

Features

SDKs & Libraries

OpenAI SDK Compatibility

Python

JavaScript/TypeScript

Go

Quick Setup

Mavera-Specific Fields

Example with Mavera Fields

REST API

Language Support

​OpenAI SDK Compatibility

Python

JavaScript/TypeScript

Go

​Quick Setup

​Mavera-Specific Fields

​Example with Mavera Fields

​REST API

​Language Support

OpenAI SDK Compatibility

Quick Setup

Mavera-Specific Fields

Example with Mavera Fields

REST API

Language Support