OpenAI Responses API

If you build on the OpenAI Responses API, add Voxmin as a remote MCP tool. The model then calls Voxmin's tools itself, inside one API request, and spends from your Voxmin credits.

Before you start

• A Voxmin account with some credits.
• A personal token from AI Integrations. It starts with vxm_ and is shown only once, so copy it when you create it. For an app, make a token just for it, with a daily credit cap.
• An OpenAI API key.

Add Voxmin as a tool

Add an mcp tool to your request. Your Voxmin token goes in the tool's authorization field — the token itself, without Bearer:

curl https://api.openai.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "gpt-5",
    "tools": [
      {
        "type": "mcp",
        "server_label": "voxmin",
        "server_description": "Make pictures, songs, karaoke, lyric videos, voice covers and transcripts with Voxmin credits.",
        "server_url": "https://api.voxmin.com/auth/mcp",
        "authorization": "<your token>",
        "require_approval": "never"
      }
    ],
    "input": "What is my Voxmin balance?"
  }'

import OpenAI from 'openai';

const client = new OpenAI();

const response = await client.responses.create({
    model: 'gpt-5',
    tools: [
        {
            type: 'mcp',
            server_label: 'voxmin',
            server_description: 'Make pictures, songs, karaoke, lyric videos, voice covers and transcripts with Voxmin credits.',
            server_url: 'https://api.voxmin.com/auth/mcp',
            authorization: process.env.VOXMIN_TOKEN,
            require_approval: 'never'
        }
    ],
    input: 'Make a square picture of a lighthouse at dawn and give me the link.'
});

console.log(response.output_text);

Use any model that supports remote MCP tools. The Authorization: Bearer $OPENAI_API_KEY header is your OpenAI key, for OpenAI; the Voxmin token only ever goes in authorization.

Choosing what the model may do

• require_approval: "never" lets the model call Voxmin tools without stopping to ask, including the ones that spend credits. Every spending tool states its price in its description, and the token's daily credit cap is checked before anything is spent.
• { "never": { "tool_names": ["get_account", "get_prices", "get_job", "list_jobs"] } } skips approval only for the tools you list — here, the free look-ups — and asks for everything else.
• Leave out require_approval (or set it to "always") to get an mcp_approval_request item back for each call; approve it by sending an mcp_approval_response in your next request.
• allowed_tools limits the model to the tools you list — for example ["get_account", "get_prices", "generate_image", "get_image"] for an app that only makes pictures.

Check it works

Send the curl request above with your token in place of <your token>. The response's output has an mcp_list_tools item listing Voxmin's tools, an mcp_call item for get_account, and the model's answer with your credit balance.

Troubleshooting

See the overview for every tool, its price and how billing works.