TokenLab

Texte

Créer une traduction

Traduit du texte vers une langue cible

POST
/v1/translations

Aperçu

/v1/translations sert à la traduction texte vers texte.

Cet endpoint est différent de la traduction audio, qui accepte un fichier audio et renvoie toujours du texte en anglais.

Pour les workflows d'agent, commencez par découvrir les modèles de traduction actuellement recommandés :

curl "https://api.tokenlab.sh/v1/models?recommended_for=translation"

Envoyez ensuite explicitement le modèle choisi à /v1/translations.

recommended_for=translation s'applique uniquement à la traduction de texte (POST /v1/translations). Il ne s'applique pas à la traduction audio.

Corps de la requête

modelstringrequis

L'ID du modèle de traduction renvoyé par /v1/models?recommended_for=translation.

textstringrequis

Le texte source à traduire.

target_languagestringrequis

Code de langue ou nom de langue cible, selon le support du modèle.

source_languagestring

Indication facultative de la langue source.

mime_typestringpar défaut: text/plain

Format du texte source. Valeurs prises en charge : text/plain, text/html.

userstring

Identifiant facultatif de l'utilisateur final pour la surveillance des abus et le suivi des requêtes.

Réponse

textstring

Texte traduit.

modelstring

Modèle qui a généré la traduction.

source_languagestring | null

Langue source détectée ou acceptée par le modèle.

target_languagestring

Langue cible utilisée pour la requête.

Requête

curl -X POST "https://api.tokenlab.sh/v1/translations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-translation",
    "text": "Bonjour, bienvenue sur TokenLab.",
    "target_language": "en"
  }'

Réponse

Response
{
  "text": "Hello, welcome to TokenLab.",
  "model": "doubao-seed-translation",
  "source_language": "fr",
  "target_language": "en"
}

Autorisation

BearerAuth
AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

En-têtes

X-TokenLab-Delivery-Policy?string

Politique de livraison par requête. Remplace les valeurs par défaut de la clé API et de l'espace de travail. Tente automatiquement TokenLab Verified en premier et peut basculer une fois vers Official uniquement avant la sortie, l'acceptation de la requête ou la création de ressource persistante.

Valeurs possibles

  • "auto"
  • "verified"
  • "official"

Corps de la requête

application/json

Réponse

application/json

application/json

application/json

application/json

application/json

application/json