Référence API de Grok STT

Une seule clé API PopNow suffit pour appeler Grok STT depuis votre code. Vous trouverez ici les identifiants de modèle à envoyer, chaque champ d’entrée accepté, le coût d’une requête en crédits et une requête à coller telle quelle dans un terminal.

Les descriptions des paramètres proviennent du schéma d’entrée du modèle et ne sont disponibles qu’en anglais.

En bref

Éditeur: xAI
Résultat: Audio
À partir de: 0.01 crédits par seconde produite ($0.0001)
Durée habituelle: environ 7 s
Identifiants de modèle: xai/grok-stt/speech-to-text

1 crédit = 0,01 $. À l’acceptation, une tâche réserve le montant maximal possible, puis facture la consommation réelle à la fin, arrondie au crédit supérieur ; le reste est libéré. Une tâche en échec n’est pas facturée. Pour connaître le montant exact avant de lancer, appelez POST /api/v1/jobs/quote.

Transcription

xai/grok-stt/speech-to-text

Prix

Option	Crédits (par seconde produite)	Dollars US
`Par défaut`	0.01	$0.0001

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`audio_url`Obligatoire	`string (uri)`	—	—	Audio to transcribe: an uploaded MP3 or WAV, or a public URL to a common audio or video format. 1 second to 2 hours.
`language`Facultatif	`string`	—	ar, cs, da, nl, en, fil, fr, de, hi, id, it, ja, ko, mk, … (+11)	Spoken language. Leave empty to detect it; required when text_normalization is on.
`text_normalization`Facultatif	`boolean`	`false`	—	Write spoken numbers, prices, dates and units in digits. Needs language.
`keyterms`Facultatif	`array<object>`	`[]`	jusqu’à 100 éléments	Names and terms to spell the way you list them, up to 100.
`filler_words`Facultatif	`boolean`	`false`	—	Keep filler words such as um and uh in the transcript.
`multichannel`Facultatif	`boolean`	`false`	—	Transcribe each channel separately, one line per channel. Turn on when speakers are on separate channels.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans audio_url. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

POST /api/v1/jobs/createTask?wait=60

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "xai/grok-stt/speech-to-text",
  "input": {
    "audio_url": "https://media.popnow.ai/shortfilm/voices/Aoede-46e4c427.mp3"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"