Barevalue

Account details: credit balance, minutes available and any limits on the account.

// inputSchema
{
  "type": "object",
  "required": [],
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Barevalue API key (bv_sk_...). Get one with barevalue_register. Omit when the connection already sends an Authorization: Bearer header."
    }
  }
}

Service health, queue depth and expected processing times. No API key needed.

// inputSchema
{
  "type": "object",
  "required": [],
  "properties": {}
}

The show notes, the transcript and the edit summary of a finished order as text you can read and pass on, so no file has to be downloaded and parsed. Call it once barevalue_status reports "done". Use include to fetch only what you need: the transcript of a long episode is large.

// inputSchema
{
  "type": "object",
  "required": [
    "order_id"
  ],
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Barevalue API key (bv_sk_...). Get one with barevalue_register. Omit when the connection already sends an Authorization: Bearer header."
    },
    "include": {
      "type": "string",
      "description": "Optional comma-separated list of summary, show_notes, transcript. All three when omitted."
    },
    "order_id": {
      "type": "number",
      "description": "Order ID"
    }
  }
}

Check whether the account can cover an AI editing order of a given length before submitting it. Nothing is charged.

// inputSchema
{
  "type": "object",
  "required": [
    "duration_minutes"
  ],
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Barevalue API key (bv_sk_...). Get one with barevalue_register. Omit when the connection already sends an Authorization: Bearer header."
    },
    "duration_minutes": {
      "type": "number",
      "description": "Audio length in minutes (1-60)"
    }
  }
}

Tell us whether your user is happy with a finished order. Ask them, then send their answer: our team is told and it is how the editing gets better. Sending it again for the same order replaces the earlier answer, comment included.

// inputSchema
{
  "type": "object",
  "required": [
    "order_id",
    "rating"
  ],
  "properties": {
    "issues": {
      "type": "array",
      "items": {
        "enum": [
          "audio_quality",
          "wrong_cuts",
          "missed_cuts",
          "intro_outro",
          "fades",
          "too_aggressive",
          "too_minimal",
          "metadata",
          "clips",
          "show_notes",
          "other"
        ],
        "type": "string"
      },
      "description": "Optional: what was wrong"
    },
    "rating": {
      "enum": [
        "positive",
        "negative"
      ],
      "type": "string",
      "description": "Whether your user is happy with the edit"
    },
    "api_key": {
      "type": "string",
      "description": "Barevalue API key (bv_sk_...). Get one with barevalue_register. Omit when the connection already sends an Authorization: Bearer header."
    },
    "comment": {
      "type": "string",
      "description": "Optional: what they said, in their words (max 2000 characters)"
    },
    "order_id": {
      "type": "number",
      "description": "Order ID"
    }
  }
}

Recent orders on the account with their status.

// inputSchema
{
  "type": "object",
  "required": [],
  "properties": {
    "page": {
      "type": "number",
      "description": "Page number (default 1)"
    },
    "status": {
      "enum": [
        "pending",
        "processing",
        "completed",
        "failed"
      ],
      "type": "string",
      "description": "Filter by status"
    },
    "api_key": {
      "type": "string",
      "description": "Barevalue API key (bv_sk_...). Get one with barevalue_register. Omit when the connection already sends an Authorization: Bearer header."
    },
    "per_page": {
      "type": "number",
      "description": "Results per page (default 20, max 100)"
    }
  }
}

Current pricing, plans, supported formats and capabilities. No API key needed.

// inputSchema
{
  "type": "object",
  "required": [],
  "properties": {}
}

Create a Barevalue account and get a working API key in one call. No password and no email click needed before the first order. Pass the email address of the person you are acting for; they receive a verification link. Until they click it the account can use a small free allowance (see "allowance" in the result); after it, the full free monthly allowance. Use the returned api_key on every other tool.

// inputSchema
{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Email address of the person the account is for"
    },
    "last_name": {
      "type": "string",
      "description": "Optional last name of that person"
    },
    "agent_name": {
      "type": "string",
      "description": "Optional name of the agent or app creating the account, e.g. \"Claude\", \"ChatGPT\""
    },
    "first_name": {
      "type": "string",
      "description": "Optional first name of that person"
    }
  }
}

Re-edit a finished order with new instructions, for example "keep the story about the dog, it was cut" or "the intro music is too loud". It creates a new order from the original recording and returns its order_id: poll barevalue_status on that. It uses the same minutes from the allowance as the original order, so confirm with your user first. Say everything that should be different in one request. It returns the edited audio; ask in the instructions if the show notes or clips should be made again.

// inputSchema
{
  "type": "object",
  "required": [
    "order_id",
    "instructions"
  ],
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Barevalue API key (bv_sk_...). Get one with barevalue_register. Omit when the connection already sends an Authorization: Bearer header."
    },
    "order_id": {
      "type": "number",
      "description": "The finished order to change (the original, not an earlier revision)"
    },
    "instructions": {
      "type": "string",
      "description": "What to change, in plain language (10 to 2000 characters)"
    }
  }
}

Status of an order. While processing it reports the current step, percentage and estimated seconds remaining. When status is "done" it lists each file with its kind (edited_audio, clip, show_notes, transcript and others) and a download URL valid for 24 hours, says what the edit changed, and says what is not included and why. When status is "failed" it says why and what to do next.

// inputSchema
{
  "type": "object",
  "required": [
    "order_id"
  ],
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Barevalue API key (bv_sk_...). Get one with barevalue_register. Omit when the connection already sends an Authorization: Bearer header."
    },
    "order_id": {
      "type": "number",
      "description": "Order ID to check"
    }
  }
}

Order AI podcast editing for an audio file at a public URL. This is the simplest way to order. The file is downloaded, edited (noise, levels, filler words, dead air), and returned with a transcript and show notes. Audio only, one file with one audio track, up to 60 minutes. Returns an order_id; poll barevalue_status until status is "done". For a file on this machine that has no link, call barevalue_upload first and pass its upload_id here in place of file_url.

// inputSchema
{
  "type": "object",
  "required": [
    "podcast_name",
    "episode_name"
  ],
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Barevalue API key (bv_sk_...). Get one with barevalue_register. Omit when the connection already sends an Authorization: Bearer header."
    },
    "file_url": {
      "type": "string",
      "description": "Direct, publicly downloadable URL of the audio file (not a landing page). Give this or upload_id, not both."
    },
    "upload_id": {
      "type": "string",
      "description": "The upload_id from barevalue_upload, once the file has been uploaded. Give this or file_url, not both."
    },
    "host_names": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional host names (max 5), used to label speakers"
    },
    "guest_names": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional guest names (max 10)"
    },
    "episode_name": {
      "type": "string",
      "description": "Name of this episode"
    },
    "podcast_name": {
      "type": "string",
      "description": "Name of the podcast"
    },
    "episode_number": {
      "type": "string",
      "description": "Optional episode number, digits only (e.g. \"42\"). Anything else is ignored."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Optional UUID. Send the same value when retrying so the order is not created twice. Generated when omitted."
    },
    "duration_minutes": {
      "type": "number",
      "description": "Optional audio length in minutes if known. The real length is measured after download."
    },
    "special_instructions": {
      "type": "string",
      "description": "Optional instructions for the editor, e.g. \"Remove the sponsor read\", \"Keep the blooper at the end\""
    }
  }
}

Everything that happened on the account since you last asked: an order was received, is ready, or failed and why, or the email address was confirmed. It carries what our emails say, so your user does not need to watch an inbox. Pass the cursor from the previous result as since. Without since it covers the last 24 hours. An update can come back on two consecutive calls: each has an id that never changes, so skip the ones you have already handled.

// inputSchema
{
  "type": "object",
  "required": [],
  "properties": {
    "since": {
      "type": "string",
      "description": "The cursor returned by the previous call, or an ISO 8601 date and time"
    },
    "api_key": {
      "type": "string",
      "description": "Barevalue API key (bv_sk_...). Get one with barevalue_register. Omit when the connection already sends an Authorization: Bearer header."
    }
  }
}

For a recording that is a file on the machine you are running on and has no link. Returns an upload_id and a ready curl command: run the command with the path to the file (it answers 204 when the upload worked), then call barevalue_submit_url with upload_id in place of file_url. One audio file, up to 750 MB and 60 minutes. The upload link works for 15 minutes and the upload can be ordered once. If the recording already has a direct link, skip this and pass the link to barevalue_submit_url.

// inputSchema
{
  "type": "object",
  "required": [
    "filename"
  ],
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Barevalue API key (bv_sk_...). Get one with barevalue_register. Omit when the connection already sends an Authorization: Bearer header."
    },
    "filename": {
      "type": "string",
      "description": "Name of the file, with its extension, e.g. \"episode-12.mp3\""
    },
    "size_bytes": {
      "type": "number",
      "description": "Optional size of the file in bytes, to be told at once if it is too large"
    }
  }
}

Check an audio file at a URL before ordering: confirms it can be downloaded, measures its length and checks it is speech and not music or silence. Nothing is charged.

// inputSchema
{
  "type": "object",
  "required": [
    "file_url"
  ],
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Barevalue API key (bv_sk_...). Get one with barevalue_register. Omit when the connection already sends an Authorization: Bearer header."
    },
    "file_url": {
      "type": "string",
      "description": "Direct, publicly downloadable URL of the audio file"
    }
  }
}