OPENAI-COMPATIBLE SDK · NATIVE XY DNA REST API · REMOTE MCP

Oxyo Developer API & Secret Keys

Use your oxy_live_... API key to plug Oxyo's persistent XY Informational DNA and deterministic Verified Python Sandbox directly into any Python, TypeScript/Node.js, Go, cURL, LangChain, Vercel AI SDK, or OpenAI-compatible application.

🔑 Your API Keys

Pass via Authorization: Bearer oxy_live_... or X-API-Key: oxy_live_...
Base URL: https://oxyo.si/v1

⚡ 30-Second Quickstart


    


    
    

      
🧠 Models (`GET /v1/models`)

      

        

          oxyo-auto
          
Adaptive prefrontal router — automatically chooses direct recall, deep deliberation, or isolated Python execution per query.

        

        

          oxyo-verified
          
Forces deterministic Isolated Python Sandbox execution (`Decimal`, `csv`, `math`, `statistics`) before answering + XY DNA recall.

        

        

          oxyo-deep
          
Multi-step System-2 deliberation grounded in your contradiction-free XY Informational DNA vault.

        

        

          oxyo-fast
          
Lowest-latency direct synthesis with instant XY Informational DNA fact & episode retrieval.

        

      

    


    
    

      
▶ Live API Playground (`POST /v1/chat/completions`)

      

        Test a real API call directly from your browser using your active session or generated oxy_live_... key.
      

      

        
        
        
      

      
// Click "Send Request" to inspect the live JSON response from /v1/chat/completions

    


    
    

      
📡 Endpoint Reference


      

        POST
        /v1/chat/completions
        OpenAI-compatible Chat Completions (supports stream: true SSE, multimodal image_url, attachments, and oxyo verification metadata).
      


      

        GET
        /v1/models
        Lists available Oxyo models (`oxyo-auto`, `oxyo-verified`, `oxyo-deep`, `oxyo-fast`) for SDK auto-discovery.
      


      

        POST
        /api/v1/interact
        Native Oxyo interaction endpoint (`{"text", "mode", "thread_id", "attachments": [{"filename", "text_content"}]}`).
      


      

        POST
        /api/v1/beliefs
        Store a durable fact (`{"claim", "confidence"}`) — automatically detects & supersedes older contradicting claims in XY DNA.
      


      

        POST
        /api/v1/verify-code
        Execute pure deterministic Python (`{"code": "RESULT = ...", "timeout_s": 4.0}`) inside Oxyo's isolated sandbox.
      


      

        POST
        /api/v1/extract-file
        Multipart upload parser extracting clean text from `.csv`, `.json`, `.pdf`, `.docx`, `.xlsx`, `.zip`, code & logs.
      


      

        GET
        /api/v1/state
        Inspect active contradiction-free beliefs, superseded revision log, causal graph edges, skills, and 30-day usage allowance.
      


      

        POST
        /mcp
        Streamable HTTP JSON-RPC 2.0 Model Context Protocol endpoint for Cursor, Claude Code, Windsurf & VS Code.