API de Voice Go

Todas las peticiones se hacen por HTTPS a la URL base siguiente. Los cuerpos son JSON (multipart/form-data al subir un archivo para transcribir); la respuesta de texto a voz es el propio archivo de audio.

https://www.voicego.net/api/v1

Envíe su clave de API en la cabecera Authorization en cada petición. Las claves empiezan por vg_live_. También se acepta la cabecera X-API-Key.

Authorization: Bearer vg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

POST/api/v1/tts

Locuta el texto con la voz elegida y devuelve el archivo de audio. Cada petición correcta descuenta de su cuota mensual tantos caracteres como tenga el texto.

Parámetros

curl -X POST https://www.voicego.net/api/v1/tts \
  -H "Authorization: Bearer $VOICEGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Şirketimizi aradığınız için teşekkür ederiz.",
    "voice": "yeliz",
    "format": "wav_8k"
  }' \
  --output anons.wav

Respuesta

Una respuesta correcta es el propio archivo de audio con estado 200 (Content-Type: audio/mpeg o audio/wav). Cabeceras de respuesta:

• X-Characters — Caracteres descontados de la cuota en esta petición
• X-Quota-Limit · X-Quota-Used · X-Quota-Remaining — Cuota mensual, uso de este mes y caracteres restantes

GET/api/v1/voices

Devuelve las voces que puede usar. Las voces HD con expressive: true admiten emociones, instrucciones y etiquetas.

curl https://www.voicego.net/api/v1/voices -H "Authorization: Bearer $VOICEGO_API_KEY"

{
  "voices": [
    {
      "id": "yeliz",
      "name": "Yeliz",
      "names": { "en": "Amelia", "es": "Julia" },
      "gender": "female",
      "language": "tr-TR",
      "quality": "hd",
      "expressive": true
    }
  ]
}

POST/api/v1/transcribe

Transcribe una grabación de audio o vídeo, separa a los hablantes e indica el inicio y el final de cada segmento. Cada petición correcta descuenta de su tiempo mensual de transcripción la duración de la grabación (en segundos, redondeada hacia arriba).

Puede enviar el archivo de dos formas: suba archivos de hasta 4 MB directamente en el campo "file" con multipart/form-data; para archivos mayores, indique en un cuerpo JSON la dirección https descargable del archivo en "url" (p. ej. un enlace firmado y temporal de su almacenamiento). Se admiten los formatos de audio y vídeo habituales como MP3, WAV, M4A, OGG, FLAC, MP4, MOV y WEBM.

Parámetros

# 4 MB'a kadar dosya: doğrudan yükleme
curl -X POST https://www.voicego.net/api/v1/transcribe \
  -H "Authorization: Bearer $VOICEGO_API_KEY" \
  -F "file=@gorusme.mp3" \
  -F "language=tr" \
  -F "speakers=2"

# Büyük dosya: indirilebilir adres, SRT altyazı olarak
curl -X POST https://www.voicego.net/api/v1/transcribe \
  -H "Authorization: Bearer $VOICEGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://depo.ornek.com/egitim-videosu.mp4",
    "language": "tr",
    "format": "srt"
  }' \
  --output altyazi.srt

Respuesta

Respuesta en formato json; con txt y srt la respuesta es el propio archivo de texto. Cabeceras de respuesta:

• X-Billed-Seconds — Segundos descontados de su tiempo de transcripción en esta petición
• X-Transcription-Limit-Seconds · X-Transcription-Used-Seconds · X-Transcription-Remaining-Seconds — Tiempo mensual de transcripción, uso de este mes y tiempo restante (segundos)

{
  "text": "Merhaba, Voice Go'ya hoş geldiniz. Teşekkürler, sizi dinliyorum.",
  "language": "tur",
  "duration_seconds": 6.84,
  "billed_seconds": 7,
  "speakers": ["speaker_1", "speaker_2"],
  "segments": [
    { "speaker": "speaker_1", "start": 0.12, "end": 2.9, "text": "Merhaba, Voice Go'ya hoş geldiniz." },
    { "speaker": "speaker_2", "start": 3.4, "end": 6.7, "text": "Teşekkürler, sizi dinliyorum." }
  ]
}

La petición se acepta mientras le quede tiempo y se transcribe la grabación completa; si es más larga que su tiempo restante, la diferencia también se contabiliza. Las grabaciones largas pueden tardar unos minutos; configure un tiempo de espera de al menos 5 minutos.

GET/api/v1/usage

Devuelve su cuota mensual de caracteres, su tiempo de transcripción, su uso y cuándo se renuevan. Las cuotas se comparten con el estudio y se renuevan el día 1 de cada mes (UTC).

{
  "characters": { "limit": 500000, "used": 128450, "remaining": 371550 },
  "transcription_seconds": { "limit": 36000, "used": 5420, "remaining": 30580 },
  "period": { "resets_at": "2026-11-01T00:00:00.000Z" }
}

Con las voces HD puede añadir etiquetas en el texto para pausas, susurros, risas y más. En las voces que no las admiten, se eliminan sin leerse.

"text": "Kampanyamız başladı! [pause] Detaylar için bire basın."

Los errores se devuelven como JSON: { "error": { "code": "...", "message": "..." } }. Los mensajes están en inglés.

{
  "error": {
    "code": "quota_exceeded",
    "message": "Your monthly character quota has been used up."
  }
}

• Hasta 2500 caracteres por petición.
• Hasta 60 peticiones de texto a voz y 10 de transcripción por minuto por clave. Si se supera, se devuelve 429.
• Las subidas directas para transcribir están limitadas a 4 MB; envíe los archivos mayores con url.
• Su cuenta tiene una cuota mensual de caracteres y un tiempo de transcripción; el estudio y la API comparten la misma cuota.
• Contacte con su gestor de cuenta para ampliar la cuota.

• Use su clave de API solo en el servidor; nunca la incluya en código de navegador o de aplicaciones móviles.
• Si cree que su clave se ha filtrado, avísenos; la revocaremos de inmediato y le daremos una nueva.
• Las claves se guardan solo como hash cifrado; nadie, ni siquiera nosotros, puede ver su clave.
• Los textos y grabaciones que envía solo se procesan para generar el audio y las transcripciones, y nunca se usan para entrenar modelos de IA.
• Las grabaciones enviadas para transcribir y sus transcripciones no se guardan en los servidores de Voice Go; el resultado solo se le devuelve a usted.