Python SDK

pip install openai

from openai import OpenAI

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

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MAVERA_API_KEY"],
    base_url="https://app.mavera.io/api/v1",
)

response = client.responses.create(
    model="mavera-1",
    input="What are the latest trends in AI?",
    instructions="You are a helpful assistant.",
    extra_body={"persona_id": "YOUR_PERSONA_ID"},
)

print(response.output[0].content[0].text)
print(f"Credits used: {response.usage.credits_used}")

with client.responses.stream(
    model="mavera-1",
    input="Write a short story",
    extra_body={"persona_id": "YOUR_PERSONA_ID"},
) as stream:
    for event in stream:
        if event.type == "response.output_text.delta":
            print(event.delta, end="", flush=True)

response = client.responses.create(
    model="mavera-1",
    input="How do millennials feel about remote work?",
    extra_body={
        "persona_id": "YOUR_PERSONA_ID",
        "analysis_mode": True,
        "reasoning_effort": "high",
    },
)

analysis = response.analysis
print(f"Confidence: {analysis['confidence']}/10")

import requests

headers = {"Authorization": "Bearer mvra_live_your_key_here"}
base_url = "https://app.mavera.io/api/v1"

# List personas
response = requests.get(f"{base_url}/personas", headers=headers)
personas = response.json()["data"]

# Mave Agent
response = requests.post(
    f"{base_url}/mave/chat",
    headers=headers,
    json={"message": "Analyze the EV market"}
)
result = response.json()

# Create Focus Group
response = requests.post(
    f"{base_url}/focus-groups",
    headers=headers,
    json={
        "name": "Product Feedback",
        "sample_size": 50,
        "persona_ids": ["persona_1", "persona_2"],
        "questions": [...]
    }
)

import asyncio
from openai import AsyncOpenAI

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

async def main():
    response = await client.responses.create(
        model="mavera-1",
        input="Hello!",
        extra_body={"persona_id": "YOUR_PERSONA_ID"},
    )
    print(response.output[0].content[0].text)

asyncio.run(main())

from openai import APIError, AuthenticationError, RateLimitError

try:
    response = client.responses.create(...)
except AuthenticationError:
    print("Invalid API key")
except RateLimitError:
    print("Rate limited - implement backoff")
except APIError as e:
    if e.status_code == 402:
        print("Insufficient credits")
    else:
        print(f"API error: {e}")

from openai import OpenAI

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

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

# mavera_chat.py — run with: python mavera_chat.py "Your question here"
# Requires: pip install openai requests
import os
import sys
import requests
from openai import OpenAI

def main():
    api_key = os.environ.get("MAVERA_API_KEY")
    if not api_key:
        print("Set MAVERA_API_KEY environment variable")
        sys.exit(1)

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

    # List personas and pick first
    import requests
    resp = requests.get(
        "https://app.mavera.io/api/v1/personas",
        headers={"Authorization": f"Bearer {api_key}"},
    )
    personas = resp.json().get("data", [])
    if not personas:
        print("No personas found")
        sys.exit(1)
    persona_id = personas[0]["id"]
    print(f"Using persona: {personas[0]['name']}\n")

    # Chat
    question = sys.argv[1] if len(sys.argv) > 1 else "What matters most to you when choosing a product?"
    response = client.responses.create(
        model="mavera-1",
        input=question,
        extra_body={"persona_id": persona_id},
    )

    print(response.output[0].content[0].text)
    print(f"\nCredits used: {response.usage.credits_used}")

if __name__ == "__main__":
    main()