Method	Path	Description	Cost
POST	/stt/url	Transcribes a WAV audio file from a URL into text. Send the source file URL and language, and the response returns the transcription as a string.	$0.31 default	View details

POST/stt/url

$0.31 default

Description

Transcribes a WAV audio file from a URL into text. Send the source file URL and language, and the response returns the transcription as a string.

Documentation

Transcribe WAV from URL to text

**Method:** POST
**Apiosk URL:** https://gateway.apiosk.com/apyhub-speech-to-text/stt/url
**Request content type:** application/json
**Response content type:** application/json

What it does

Transcribes a WAV audio file from a URL into text. Send the source file URL and language, and the response returns the transcription as a string.

Request Body

| Parameter | Type | Mandatory | Description |
| --------- | ------ | --------- | ---------------------------------------------- |
| url | String | Yes | The WAV file URL to transcribe. Must be a valid URI. |
| language | String | Yes | The language code for transcription, such as en-US. |

Response

Returns a JSON object with a data string field containing the transcription result.

Quickstart

Send the audio file URL and its language code to transcribe speech to text.

bash
curl -X POST "https://gateway.apiosk.com/apyhub-speech-to-text/stt/url" \
-H "PAYMENT-SIGNATURE: $PAYMENT_SIGNATURE" \
-H "Content-Type: application/json" \
-d '{
"url": "https://assets.apyhub.com/samples/sample.wav",
"language": "en-US"
}'

What you'll get back

Returns a JSON object with a data string field containing the transcribed text.

json
{
"data": "Hello, this is a sample transcription."
}

Payment and authentication

Do not send an apy-token. Apiosk injects the APYHub credential server-side. The first unpaid request returns HTTP 402 Payment Required with a PAYMENT-REQUIRED header. Sign an accepted USDC payment and retry the same request with the proof in PAYMENT-SIGNATURE (or use an Apiosk/x402-aware agent client that performs this exchange automatically).

The $PAYMENT_SIGNATURE placeholder in the example is the signed proof obtained from that initial 402 response.

Source

Parameter definitions and limits were synchronized from [APYHub's official documentation](https://apyhub.com/apyhub/service/transcribe-speech-to-text) on 2026-07-18.

Pricing

$0.31 default

Authentication

Pay per request through Apiosk using x402. Do not send an apy-token; the gateway injects the selected APYHub key server-side.

Request schema

{
  "properties": {
    "language": {
      "example": "en-US",
      "type": "string"
    },
    "url": {
      "example": "https://assets.apyhub.com/samples/sample.wav",
      "format": "uri",
      "type": "string"
    }
  },
  "required": [
    "url",
    "language"
  ],
  "type": "object"
}

Response schema

{
  "properties": {
    "data": {
      "type": "string"
    }
  },
  "type": "object"
}

Headers

{
  "properties": {
    "PAYMENT-SIGNATURE": {
      "description": "Signed x402 v2 payment proof. Obtain the payment requirements from the initial HTTP 402 response.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Example request

{
  "language": "en-US",
  "url": "https://assets.apyhub.com/samples/sample.wav"
}

Example response

{
  "data": "Hello, this is a sample transcription."
}

Links

External documentation ↗

Convert Speech to Text API