Python

pip install requests

import json
import requests

messages = [
    {
        "role": "system",
        "content": "You are helping inside a Python and TypeScript voice agent repo.",
    },
    {
        "role": "user",
        "content": "The transcript may include LangGraph, QdrantVectorCache, RAGPipelineConfig, and api.voiceos.dev.",
    },
]

with open("sample.mp3", "rb") as audio:
    response = requests.post(
        "https://beta.api.voiceos.com/v1/audio/transcriptions",
        files={"file": ("sample.mp3", audio, "audio/mpeg")},
        data={
            "messages": json.dumps(messages),
            "languages": json.dumps(["en", "ja"]),
            "dictionary": json.dumps(["VoiceOS", "ASR"]),
            "response_format": "json",
        },
        timeout=60,
    )

response.raise_for_status()
result = response.json()

print("Transcript:", result["text"])

try:
    response.raise_for_status()
except requests.HTTPError:
    print(response.status_code)
    print(response.json())
    raise