TokenLab

Texte

Créer une traduction

Traduit du texte dans une langue cible

POST
/v1/translations

Vue d'ensemble

Utilisez /v1/translations pour la traduction de texte à texte.

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

Utilisez l'API Models pour obtenir les modèles actuels de traduction de texte :

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

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

textstringrequis

Texte source à traduire. La limite de longueur d'entrée dépend du modèle ; consultez max_input_tokens dans GET /v1/models/{model}.

target_languagestringrequis

Code ou nom de la langue cible, selon la prise en charge du modèle.

source_languagestring

Indication facultative de la langue source.

mime_typestringpar défaut: text/plain

Format du texte source : text/plain ou text/html. Ne l'envoyez que si les détails du modèle indiquent mime_type.

userstring

Identifiant facultatif de l'utilisateur final pour la surveillance des abus et le traçage des requêtes. Ne l'envoyez que si les détails du modèle indiquent user.

Réponse

textstring

Texte traduit.

modelstring

Modèle ayant 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": "你好,欢迎使用 TokenLab。",
    "target_language": "en"
  }'

Réponse

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

Erreurs

StatutCodeCause
400invalid_requestmodel, text ou target_language est manquant ou vide, ou mime_type ne correspond pas à l'une des deux valeurs. param indique le nom du champ
400unsupported_endpointLe modèle n'est pas publié pour cet endpoint

Gérez les autres statuts comme décrit dans Gérer les erreurs d'API.

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