gaents

Agent marketplace and model API, curated on our own task tests; every call gets a signed proof.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
95%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~6,910Tokens (tool definitions)
~1.8 KBTypical response size
Significant attention impact (5.40% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "api": {
      "url": "https://api.gaents.com/mcp"
    }
  }
}

Remote endpoints

https://api.gaents.com/mcpstreamable-http

What it can do

Tool inventory

Tools (14)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢chat(model, max_tokens, temperature, messages)

Generates a chat completion from an OpenAI-style messages list with the model you name: a gaents/<family> alias (routed across providers, with failover) or an id from GET https://api.gaents.com/v1/models. Use it for open-ended generation, reasoning, summarising, classification or extraction from text you already have. Use catalogue instead to see the models and jobs on offer first. Use job_ner_gliner instead for entity spans with offsets from text. Returns an OpenAI chat.completion JSON {id, model, choices [{message {role, content}, finish_reason}], usage {prompt_tokens, completion_tokens}}. Cost: per token at the model's price in GET /v1/models, debited from your balance; the call is quoted on max_tokens up front and you pay only the tokens used. Auth: Authorization: Bearer <API key> (POST https://api.gaents.com/v1/accounts, $0.10 free credit); with no key the call returns a signed 402 quote payable in BSV. Errors (isError, error.code): 400 model_required/messages_required/unknown_param, 401 bad_api_key, 402 low balance, 403 escalation_required, 404 model_not_served, 503 no route can serve it (not charged).

Input Schema

{
  "type": "object",
  "properties": {
    "model": {
      "type": "string",
      "description": "Model to answer: a gaents/<family> alias or an id listed by GET https://api.gaents.com/v1/models.",
      "maxLength": 200,
      "minLength": 1,
      "examples": [
        "gaents/glm-flash"
      ]
    },
    "max_tokens": {
      "type": "integer",
      "description": "output token ceiling (the quote is priced on it)",
      "minimum": 1,
      "examples": [
        256
      ]
    },
    "temperature": {
      "type": "number",
      "description": "sampling temperature 0-2; lower is more deterministic (omitted = the model's default)",
      "minimum": 0,
      "maximum": 2,
      "examples": [
        0.2
      ]
    },
    "messages": {
      "type": "array",
      "minItems": 1,
      "description": "OpenAI chat messages, oldest first",
      "items": {
        "type": "object",
        "required": [
          "role",
          "content"
        ],
        "properties": {
          "role": {
            "type": "string",
            "enum": [
              "system",
              "user",
              "assistant",
              "tool"
            ]
          },
          "content": {
            "type": "string"
          }
        }
      },
      "examples": [
        [
          {
            "role": "user",
            "content": "Say hello in five words."
          }
        ]
      ]
    }
  },
  "required": [
    "model",
    "messages"
  ],
  "additionalProperties": false
}
🟢catalogue

Lists every module this server sells (chat model router, paid jobs, seller listings) with its path, MCP tool name, price, unit, params and whether it is available now. Free; no input. Use it first to choose a tool, or to check a price or availability before a paid call. Use chat instead to run a model. Returns JSON {clone_id, modules: [{kind, path, title, description, mcp_tool, available, params, price fields, facts}]}. Auth: none. Read-only; it has no error states of its own.

Input Schema

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}
⚪job_transcribe(media_url, max_results)

Transcribes the speech in one public audio or video file (direct https link to mp3, wav, m4a, ogg, flac, mp4, mov, webm and other FFmpeg formats) to plain text with Whisper small; the language is detected. Use it for podcasts, interviews, calls, lectures or voice notes hosted at a public URL. Use job_transcribe_premium instead when names, accents or noise make accuracy matter more than price. Use job_youtube_transcript instead for a YouTube video that has captions (cheaper). Returns JSON {items: [row], count, usable, units, charged_usd, receipt_quote_id}; each row: {url, status (ok; partial = stopped at max_results minutes; failed = not media, free), language, durationSeconds, text}. Cost: $0.06 per started audio minute, debited from your balance; only usable rows are charged, an empty or failed run is free. Auth: Authorization: Bearer <API key> (POST https://api.gaents.com/v1/accounts, $0.10 free credit); with no key the call returns a signed 402 quote payable in BSV. Errors (isError, error.code): 400 missing_param/bad_param, 401 bad_api_key, 402 low balance, 503 job_unavailable, 502 job_failed (refunded).

Input Schema

{
  "type": "object",
  "properties": {
    "media_url": {
      "type": "string",
      "description": "Direct https link to the audio or video file (not a web page that embeds it).",
      "pattern": "^(?:https://\\S{4,2000})$",
      "maxLength": 2000,
      "minLength": 1,
      "examples": [
        "https://gaents.com/static/testdata/transcriber-h2h-2026-11-18/clean_tts_a.mp3"
      ]
    },
    "max_results": {
      "type": "integer",
      "description": "Most started audio minutes to return and pay for (default 10, at most 120); the run stops there.",
      "minimum": 1,
      "maximum": 120,
      "examples": [
        10
      ],
      "default": 10
    }
  },
  "required": [
    "media_url"
  ],
  "additionalProperties": false
}
⚪job_transcribe_premium(media_url, max_results)

Transcribes the speech in one public audio or video file (direct https link to mp3, wav, m4a, ogg, flac, mp4, mov, webm and other FFmpeg formats) to plain text with the larger Whisper large-v3-turbo model; the language is detected. Use it when transcript accuracy matters: names, accents, noisy or multi-speaker audio. Use job_transcribe instead for clean speech at a lower price per minute. Use job_youtube_transcript instead for a YouTube video that has captions (cheaper). Returns JSON {items: [row], count, usable, units, charged_usd, receipt_quote_id}; each row: {url, status (ok; partial = stopped at max_results minutes; failed = not media, free), language, durationSeconds, text}. Cost: $0.1003 per started audio minute, debited from your balance; only usable rows are charged, an empty or failed run is free. Auth: Authorization: Bearer <API key> (POST https://api.gaents.com/v1/accounts, $0.10 free credit); with no key the call returns a signed 402 quote payable in BSV. Errors (isError, error.code): 400 missing_param/bad_param, 401 bad_api_key, 402 low balance, 503 job_unavailable, 502 job_failed (refunded).

Input Schema

{
  "type": "object",
  "properties": {
    "media_url": {
      "type": "string",
      "description": "Direct https link to the audio or video file (not a web page that embeds it).",
      "pattern": "^(?:https://\\S{4,2000})$",
      "maxLength": 2000,
      "minLength": 1,
      "examples": [
        "https://gaents.com/static/testdata/transcriber-h2h-2026-11-18/clean_tts_a.mp3"
      ]
    },
    "max_results": {
      "type": "integer",
      "description": "Most started audio minutes to return and pay for (default 10, at most 120); the run stops there.",
      "minimum": 1,
      "maximum": 120,
      "examples": [
        10
      ],
      "default": 10
    }
  },
  "required": [
    "media_url"
  ],
  "additionalProperties": false
}
🟢job_site_render(url, max_results)

Renders a website in a real headless browser (JavaScript run) and returns the visible text of its start page plus linked contact, about and team pages. Use it to read a company or product site whose content needs JavaScript, or to collect its contact and about pages in one call. Use job_doc_to_markdown instead when you already hold the HTML or document file. Returns JSON {items: [row], count, usable, units, charged_usd, receipt_quote_id}; each row: {url, final_url, http_status, title, text, emails, phones}. Cost: $0.013 per page rendered, debited from your balance; only usable rows are charged, an empty or failed run is free. Auth: Authorization: Bearer <API key> (POST https://api.gaents.com/v1/accounts, $0.10 free credit); with no key the call returns a signed 402 quote payable in BSV. Errors (isError, error.code): 400 missing_param/bad_param, 401 bad_api_key, 402 low balance, 503 job_unavailable, 502 job_failed (refunded).

Input Schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The site's https start URL, e.g. its home page.",
      "pattern": "^(?:https://\\S{4,500})$",
      "maxLength": 500,
      "minLength": 1,
      "examples": [
        "https://example.com/"
      ]
    },
    "max_results": {
      "type": "integer",
      "description": "Most page rendereds to return and pay for (default 3, at most 20); the run stops there.",
      "minimum": 1,
      "maximum": 20,
      "examples": [
        3
      ],
      "default": 3
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}
⚪job_youtube_transcript(video_url, max_results)

Fetches the caption transcript of one YouTube video (uploaded or auto-generated captions), as plain text with the caption language. Use it to read, quote or summarise what is said in a YouTube video. Use job_transcribe instead for a video with no captions (download the media to a direct link first) or audio outside YouTube. Use job_youtube_comments instead for what viewers say about the video. Returns JSON {items: [row], count, usable, units, charged_usd, receipt_quote_id}; each row: {videoId, url, status (ok; failed = captions off or video unavailable, free), language, isGenerated, durationSeconds, text}. Cost: $0.0033 per transcript, debited from your balance; only usable rows are charged, an empty or failed run is free. Auth: Authorization: Bearer <API key> (POST https://api.gaents.com/v1/accounts, $0.10 free credit); with no key the call returns a signed 402 quote payable in BSV. Errors (isError, error.code): 400 missing_param/bad_param, 401 bad_api_key, 402 low balance, 503 job_unavailable, 502 job_failed (refunded).

Input Schema

{
  "type": "object",
  "properties": {
    "video_url": {
      "type": "string",
      "description": "The video's URL: youtube.com/watch?v=..., youtube.com/shorts/... or youtu.be/... (11-character video id).",
      "pattern": "^(?:https://(www\\.|m\\.)?(youtube\\.com/(watch\\?v=|shorts/)|youtu\\.be/)[A-Za-z0-9_-]{11}\\S{0,100})$",
      "maxLength": 200,
      "minLength": 1,
      "examples": [
        "https://www.youtube.com/watch?v=jNQXAC9IVRw"
      ]
    },
    "max_results": {
      "type": "integer",
      "description": "Most transcripts to return and pay for (default 1, at most 1); the run stops there.",
      "minimum": 1,
      "maximum": 1,
      "examples": [
        1
      ],
      "default": 1
    }
  },
  "required": [
    "video_url"
  ],
  "additionalProperties": false
}
🟢job_google_trends(keyword, max_results)

Fetches Google Trends interest over the last 12 months, worldwide, for one search keyword: weekly relative interest (0-100, 100 = the peak) plus average, peak and latest values. Use it to see whether interest in a topic, product or brand is rising, falling or seasonal. Use job_youtube_search instead for what videos exist on a topic now, not search interest over time. Returns JSON {items: [row], count, usable, units, charged_usd, receipt_quote_id}; each row: {keyword, status (ok; failed = refused by Google, free), hasData, summary {average, peak, peakDate, latest}, interestOverTime [{date, values, isPartial}]}. Cost: $0.0015 per keyword result, debited from your balance; only usable rows are charged, an empty or failed run is free. Auth: Authorization: Bearer <API key> (POST https://api.gaents.com/v1/accounts, $0.10 free credit); with no key the call returns a signed 402 quote payable in BSV. Errors (isError, error.code): 400 missing_param/bad_param, 401 bad_api_key, 402 low balance, 503 job_unavailable, 502 job_failed (refunded).

Input Schema

{
  "type": "object",
  "properties": {
    "keyword": {
      "type": "string",
      "description": "One search term or phrase, as typed into Google (one line, up to 100 characters).",
      "pattern": "^(?:[^\\r\\n]{1,100})$",
      "maxLength": 100,
      "minLength": 1,
      "examples": [
        "solar panels"
      ]
    },
    "max_results": {
      "type": "integer",
      "description": "Most keyword results to return and pay for (default 1, at most 1); the run stops there.",
      "minimum": 1,
      "maximum": 1,
      "examples": [
        1
      ],
      "default": 1
    }
  },
  "required": [
    "keyword"
  ],
  "additionalProperties": false
}
🟡job_youtube_channel(channel_url, max_results)

Lists the latest videos of one YouTube channel, newest first, with title, URL, views, duration and publish time. Use it to monitor a channel's uploads or to pick its videos for transcripts or comments. Use job_youtube_search instead to find videos by topic across all channels. Use job_youtube_transcript instead for what is said inside one video. Returns JSON {items: [row], count, usable, units, charged_usd, receipt_quote_id}; each row: {rank, videoId, url, title, viewCount, duration, durationSeconds, publishedTimeText, channelName, channelHandle, subscriberCount}. Cost: $0.0002 per video row plus $0.0015 per run, debited from your balance; only usable rows are charged, an empty or failed run is free. Auth: Authorization: Bearer <API key> (POST https://api.gaents.com/v1/accounts, $0.10 free credit); with no key the call returns a signed 402 quote payable in BSV. Errors (isError, error.code): 400 missing_param/bad_param, 401 bad_api_key, 402 low balance, 503 job_unavailable, 502 job_failed (refunded).

Input Schema

{
  "type": "object",
  "properties": {
    "channel_url": {
      "type": "string",
      "description": "The channel's URL: youtube.com/@handle, /channel/UC..., /c/name or /user/name.",
      "pattern": "^(?:https://(www\\.)?youtube\\.com/(@[A-Za-z0-9._-]{1,100}|channel/UC[A-Za-z0-9_-]{22}|c/[A-Za-z0-9._-]{1,100}|user/[A-Za-z0-9._-]{1,100})/?)$",
      "maxLength": 200,
      "minLength": 1,
      "examples": [
        "https://www.youtube.com/@YouTube"
      ]
    },
    "max_results": {
      "type": "integer",
      "description": "Most video rows to return and pay for (default 30, at most 500); the run stops there.",
      "minimum": 1,
      "maximum": 500,
      "examples": [
        30
      ],
      "default": 30
    }
  },
  "required": [
    "channel_url"
  ],
  "additionalProperties": false
}
⚪job_youtube_comments(video_url, max_results)

Fetches the top-level comments on one YouTube video (no replies), ranked as YouTube ranks them, with author, likes and reply count. Use it for audience reaction, questions or sentiment on a video. Use job_youtube_transcript instead for what is said in the video itself. Returns JSON {items: [row], count, usable, units, charged_usd, receipt_quote_id}; each row: {rank, commentId, commentUrl, text, author, likes, replyCount, publishedTimeText, videoId, videoTitle}. Cost: $0.0001 per comment plus $0.0008 per run, debited from your balance; only usable rows are charged, an empty or failed run is free. Auth: Authorization: Bearer <API key> (POST https://api.gaents.com/v1/accounts, $0.10 free credit); with no key the call returns a signed 402 quote payable in BSV. Errors (isError, error.code): 400 missing_param/bad_param, 401 bad_api_key, 402 low balance, 503 job_unavailable, 502 job_failed (refunded).

Input Schema

{
  "type": "object",
  "properties": {
    "video_url": {
      "type": "string",
      "description": "The video's URL: youtube.com/watch?v=..., youtube.com/shorts/... or youtu.be/... (11-character video id).",
      "pattern": "^(?:https://(www\\.|m\\.)?(youtube\\.com/(watch\\?v=|shorts/)|youtu\\.be/)[A-Za-z0-9_-]{11}\\S{0,100})$",
      "maxLength": 200,
      "minLength": 1,
      "examples": [
        "https://www.youtube.com/watch?v=jNQXAC9IVRw"
      ]
    },
    "max_results": {
      "type": "integer",
      "description": "Most comments to return and pay for (default 100, at most 1000); the run stops there.",
      "minimum": 1,
      "maximum": 1000,
      "examples": [
        100
      ],
      "default": 100
    }
  },
  "required": [
    "video_url"
  ],
  "additionalProperties": false
}
🟢job_youtube_search(query, max_results)

Searches YouTube for one query and returns the ranked result videos with title, URL, channel, views, duration and date. Use it to find videos on a topic, or to see which channels rank for a query. Use job_youtube_channel instead for one known channel's uploads. Use job_google_trends instead for search interest over time. Returns JSON {items: [row], count, usable, units, charged_usd, receipt_quote_id}; each row: {rank, type, id, url, title, viewCount, date, duration, durationSeconds, channelName, channelUrl}. Cost: $0.0001 per result row plus $0.0009 per run, debited from your balance; only usable rows are charged, an empty or failed run is free. Auth: Authorization: Bearer <API key> (POST https://api.gaents.com/v1/accounts, $0.10 free credit); with no key the call returns a signed 402 quote payable in BSV. Errors (isError, error.code): 400 missing_param/bad_param, 401 bad_api_key, 402 low balance, 503 job_unavailable, 502 job_failed (refunded).

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The search text, as typed into YouTube (one line, up to 200 characters).",
      "pattern": "^(?:[^\\r\\n]{1,200})$",
      "maxLength": 200,
      "minLength": 1,
      "examples": [
        "how to bake sourdough bread"
      ]
    },
    "max_results": {
      "type": "integer",
      "description": "Most result rows to return and pay for (default 20, at most 200); the run stops there.",
      "minimum": 1,
      "maximum": 200,
      "examples": [
        20
      ],
      "default": 20
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}
⚪job_ocr_tesseract(image_b64, lang)

Extracts the printed text from one image (PNG, JPEG, TIFF or WebP, sent as base64) with Tesseract OCR 5, English, and reports Tesseract's mean word confidence. Use it for scans, screenshots, photos of printed pages or receipts, and scanned PDF pages saved as images. Use job_doc_to_markdown instead for a PDF or Office file that already has a text layer. Returns JSON {output: {text, chars, mean_confidence (0-100), lang, width, height}, empty, charged_usd, receipt_quote_id}. Cost: at most $0.00003134 per call (measured CPU time), debited from your balance; an empty result or failed run is free. Auth: Authorization: Bearer <API key> (POST https://api.gaents.com/v1/accounts, $0.10 free credit); with no key the call returns a signed 402 quote payable in BSV. Errors (isError, error.code): 400 missing_param/bad_param, 401 bad_api_key, 402 low balance, 429 busy (retry in seconds), 503 job_unavailable, 502 job_failed (refunded).

Input Schema

{
  "type": "object",
  "properties": {
    "image_b64": {
      "type": "string",
      "description": "The image file's bytes, base64-encoded (PNG, JPEG, TIFF or WebP), no data: prefix. (at most 3000000 bytes decoded)",
      "contentEncoding": "base64",
      "examples": [
        "iVBORw0KGgoAAAANSUhEUgAAASwAAAAwAQAAAACDZXqMAAAB70lEQVR42u2VsU5UQRSGvxk2cIvN7sQKza6cGB7AggIbuSYWdL6C+ATGxBgrBkNB5xsohQ+x5TUhgYJEY6vRI0SzHYuhmDUwx8KFvQEkxNiYcKqZ5Jt/zpn/5IwzLhH7nkvFFfb/Yf0+YOECbMh7UAVyugBzVCACHJ7Bfo4xY/6PIqmutjW61J3BiuNFA6MEATjbyGmyntuwhCOh334yLPthA1bX38Zh2Q97YWXEWbJ32t7cHExZ1Sy1vTHlzHgdZ7S9MaFtls3MBh5Hb7cnsv+JOz++7Pa6H59hd+PCYLfX/Xx9b+GkUre23UG/t7As252d1mrM9yirZmcnJMpYcyGoAM4Ds6N6UxVmiyKPzbIqZNGiwHIZggJEvi6SleSrcaU9PFIZzhOzFABxPQUvVrA1dmFxqaVaOiwTvSbPIbysllrqkntee7eI1NQyDWIoIkLBw/JErZzJ6LzDMo+9JiAuS5rJaombx2Y5egUqmiadh4HgIYpsgbii3iGLIApYBrTIsIwmqLWDx1HNHSA3PuA8c28kgX8VbW3uQMyOjsZqZTeotu9jme6aFh73LT6a7wZ1XGuU49yeNoXmNM4zfVvSBLzo3HrQaQqTzv02y50/LUX/5bSUU/vGeZDly6mN6qufPC9WTu0H7upf+CvsF9+I7SoYYIcEAAAAAElFTkSuQmCC"
      ]
    },
    "lang": {
      "type": "string",
      "description": "OCR language; only eng (English) is installed. Default eng.",
      "maxLength": 20,
      "minLength": 1,
      "enum": [
        "eng"
      ],
      "examples": [
        "eng"
      ]
    }
  },
  "required": [
    "image_b64"
  ],
  "additionalProperties": false
}
🟢job_doc_to_markdown(file_b64, filename)

Converts one document (PDF with a text layer, DOCX, PPTX, XLSX, XLS, HTML, CSV, JSON, XML, EPUB, TXT; sent as base64) to Markdown with Microsoft MarkItDown, keeping headings, lists and tables. Use it to feed a document's content to a model or search index as clean Markdown. Use job_ocr_tesseract instead for scanned PDFs or images without a text layer (they come back empty here, not charged). Use job_site_render instead for a live web page that needs JavaScript. Returns JSON {output: {markdown, chars, truncated, title}, empty, charged_usd, receipt_quote_id}. Cost: at most $0.00006268 per call (measured CPU time), debited from your balance; an empty result or failed run is free. Auth: Authorization: Bearer <API key> (POST https://api.gaents.com/v1/accounts, $0.10 free credit); with no key the call returns a signed 402 quote payable in BSV. Errors (isError, error.code): 400 missing_param/bad_param, 401 bad_api_key, 402 low balance, 429 busy (retry in seconds), 503 job_unavailable, 502 job_failed (refunded).

Input Schema

{
  "type": "object",
  "properties": {
    "file_b64": {
      "type": "string",
      "description": "The document file's bytes, base64-encoded, no data: prefix. (at most 3000000 bytes decoded)",
      "contentEncoding": "base64",
      "examples": [
        "PGgxPkV4YW1wbGU8L2gxPjxwPkhlbGxvIGZyb20gZ2FlbnRzLjwvcD4="
      ]
    },
    "filename": {
      "type": "string",
      "description": "The document's file name; its extension (pdf, docx, pptx, xlsx, xls, html, htm, csv, json, xml, epub, txt, md) picks the converter.",
      "pattern": "^(?:[A-Za-z0-9 ._()-]{1,100}\\.(pdf|docx|pptx|xlsx|xls|html|htm|csv|json|xml|epub|txt|md))$",
      "maxLength": 120,
      "minLength": 1,
      "examples": [
        "example.html"
      ]
    }
  },
  "required": [
    "file_b64",
    "filename"
  ],
  "additionalProperties": false
}
⚪job_ner_gliner(text, labels, threshold)

Finds named entities of the types you name (zero-shot: any label such as person, company, job title, product, email) in text, with GLiNER multi v2.1; works in many languages. Use it to pull people, organisations, places, dates or custom entity types out of text without training a model. Use chat instead when you need relations or reasoning about the entities, not just their spans. Returns JSON {output: {entities: [{text, label, start, end, score}], count, labels, threshold}, empty, charged_usd, receipt_quote_id}. Cost: quoted per call when the job is available; it is not available on this server right now (503). Auth: Authorization: Bearer <API key> (POST https://api.gaents.com/v1/accounts, $0.10 free credit); with no key the call returns a signed 402 quote payable in BSV. Errors (isError, error.code): 400 missing_param/bad_param, 401 bad_api_key, 402 low balance, 429 busy (retry in seconds), 503 job_unavailable, 502 job_failed (refunded).

Input Schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The text to search, up to 20000 characters; long text is processed in chunks.",
      "maxLength": 20000,
      "minLength": 1,
      "examples": [
        "Ada Lovelace worked with Charles Babbage in London in 1843."
      ]
    },
    "labels": {
      "type": "array",
      "description": "Entity types to find, in plain words. Default: person, organization, location, date.",
      "items": {
        "type": "string",
        "maxLength": 50
      },
      "minItems": 1,
      "maxItems": 25,
      "examples": [
        [
          "person",
          "organization",
          "location"
        ]
      ]
    },
    "threshold": {
      "type": "number",
      "description": "Minimum confidence (0.05-0.99) for an entity to be returned; lower finds more, with more false hits. Default 0.5.",
      "minimum": 0.05,
      "maximum": 0.99,
      "examples": [
        0.5
      ]
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false
}
⚪job_tts_piper(text, voice, speaker)

Speaks English text aloud with Piper TTS and returns a WAV file (base64, 22.05 kHz mono). Voices: en_US-ljspeech-medium (one female voice, public domain) and en_US-libritts_r-medium (904 speakers, CC BY 4.0). Use it for voice-overs, audio versions of short texts and spoken prompts. Use job_transcribe instead for the reverse: speech in an audio file to text. Returns JSON {output: {audio_b64 (WAV), format, bytes, sample_rate, duration_seconds, voice}, empty, charged_usd, receipt_quote_id}. Cost: at most $0.0001254 per call (measured CPU time), debited from your balance; an empty result or failed run is free. Auth: Authorization: Bearer <API key> (POST https://api.gaents.com/v1/accounts, $0.10 free credit); with no key the call returns a signed 402 quote payable in BSV. Errors (isError, error.code): 400 missing_param/bad_param, 401 bad_api_key, 402 low balance, 429 busy (retry in seconds), 503 job_unavailable, 502 job_failed (refunded).

Input Schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The English text to speak, up to 2000 characters.",
      "maxLength": 2000,
      "minLength": 1,
      "examples": [
        "Hello from gaents."
      ]
    },
    "voice": {
      "type": "string",
      "description": "Voice model. Default en_US-ljspeech-medium.",
      "maxLength": 40,
      "minLength": 1,
      "enum": [
        "en_US-ljspeech-medium",
        "en_US-libritts_r-medium"
      ],
      "examples": [
        "en_US-ljspeech-medium"
      ]
    },
    "speaker": {
      "type": "integer",
      "description": "Speaker number 0-903, used only with voice en_US-libritts_r-medium; omitted = the voice's default speaker.",
      "minimum": 0,
      "maximum": 903,
      "examples": [
        0
      ]
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded14 tools