Gemini 3.1 Flash TTS Text to Speech API

set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"

REQUEST_BODY=$(cat <<'JSON'
{
  "model": "google/gemini-3.1-flash/text-to-speech",
  "input": {
    "text": "Actor: [whispers] You're early. The curtain isn't up yet.\nDirector: Same words again. This time, you've been waiting years to see them.\nActor: [excitement] You're early! The curtain isn't up yet!\nDirector: [laughs] There it is. Keep that smile. We're ready.",
    "style_instructions": "An intimate theatre rehearsal. Actor shifts from a secretive whisper to delighted recognition. Director is calm, warm and lightly amused. Keep both voices distinct; do not read speaker labels or tags aloud.",
    "speakers": [
      {
        "speaker_id": "Actor",
        "voice": "Puck"
      },
      {
        "speaker_id": "Director",
        "voice": "Kore"
      }
    ],
    "language_code": "English (US)",
    "temperature": 1,
    "output_format": "mp3"
  }
}
JSON
)

SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data "$REQUEST_BODY")

TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
if [ -z "$TASK_ID" ]; then
  printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
  exit 1
fi

while true; do
  STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
    --url "https://api.vidgo.ai/api/generate/status/$TASK_ID" \
    --header "Authorization: Bearer $VIDGO_API_KEY")
  STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')

  case "$STATUS" in
    finished)
      printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
      break
      ;;
    failed)
      printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
      exit 1
      ;;
    not_started|running)
      sleep 2
      ;;
    *)
      printf 'Unexpected task status: %s
' "$STATUS" >&2
      exit 1
      ;;
  esac
done