---
title: "Translate an ordered list of narrations (free)"
method: POST
path: "/v1/generate/translate"
---

# Translate an ordered list of narrations (free)

`POST /v1/generate/translate`

## Request

- Base URL: `https://api.ffmpeg-micro.com`
- URL: `https://api.ffmpeg-micro.com/v1/generate/translate`
- Auth: HTTP bearer

Translate scene narrations into another language, preserving count and order, so the images built for the source language can be reused and a re-voice costs speech tokens only. Free; rate limited to 60/min per key.

## Request body

- GenerateTranslateRequest
  - `texts` string[], required
  - `language` string, required: ISO 639-1 target language, e.g. `fr`

## Response `200`

Translations, same length and order as `texts`

- GenerateTranslateResponse
  - `texts` string[]
  - `language` string
  - `tokens_charged` number

## Other responses

- `400`: Invalid input
- `401`: Missing/invalid API key
- `429`: Per-API-key rate limit exceeded (free routes 60/min, paid routes 30/min); see `x-ratelimit-*` headers
- `502`: The provider failed; any tokens spent were refunded unless `refund` says otherwise

---

[API](https://skmtc.dev/ffmpeg-micro/apis/ffmpeg-micro-api.md) · [All operations](https://skmtc.dev/ffmpeg-micro/apis/ffmpeg-micro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ffmpeg-micro/apis/ffmpeg-micro-api/revisions/64bb930ff345?raw)