Zum Inhalt
HALOWERK

Medienwerk

ringtone cut

Takes an audio or video file and returns a ringtone: the part from start_seconds for length_seconds (at most 30, the iPhone limit), with a short fade-in and a fade-out, normalised to a loud but undistorted level, as M4R for iPhone or MP3 and Ogg for Android. Only use material you have the rights to. Runs locally with ffmpeg; nothing leaves this machine and nothing is stored. Output inline as base64, max 8 MB. Billing per started audio minute; a longer file than declared is refused and.

POST https://medien.halowerk.com/v1/ringtone-cut

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
sourceobjectJaThe recording. Either url or content_base64.
duration_minutesintegerJaLength in started minutes — this is what you are billed for.
start_secondsnumberNein
length_secondsnumberNein
output_formatstringNein
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "source",
    "duration_minutes"
  ],
  "additionalProperties": false,
  "properties": {
    "source": {
      "type": "object",
      "additionalProperties": false,
      "description": "The recording. Either url or content_base64.",
      "properties": {
        "url": {
          "type": "string",
          "maxLength": 2048,
          "description": "Public http(s) URL of the file."
        },
        "content_base64": {
          "type": "string",
          "maxLength": 12000000,
          "description": "The file inline, base64. Larger files by url."
        },
        "filename": {
          "type": "string",
          "maxLength": 260
        }
      }
    },
    "duration_minutes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 15,
      "description": "Length in started minutes — this is what you are billed for."
    },
    "start_seconds": {
      "type": "number",
      "minimum": 0,
      "maximum": 900,
      "default": 0
    },
    "length_seconds": {
      "type": "number",
      "minimum": 3,
      "maximum": 30,
      "default": 25
    },
    "output_format": {
      "type": "string",
      "enum": [
        "m4r",
        "mp3",
        "ogg"
      ],
      "default": "m4r"
    }
  }
}

Originalschema öffnen

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →