Texte
Créer une traduction
Traduit du texte dans une langue cible
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
ID du modèle de traduction renvoyé par /v1/models?recommended_for=translation.
Texte source à traduire. La limite de longueur d'entrée dépend du modèle ; consultez max_input_tokens dans GET /v1/models/{model}.
Code ou nom de la langue cible, selon la prise en charge du modèle.
Indication facultative de la langue source.
text/plainFormat du texte source : text/plain ou text/html. Ne l'envoyez que si les détails du modèle indiquent mime_type.
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
Texte traduit.
Modèle ayant généré la traduction.
Langue source détectée ou acceptée par le modèle.
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
{
"text": "Hello, welcome to TokenLab.",
"model": "doubao-seed-translation",
"source_language": "zh",
"target_language": "en"
}Erreurs
| Statut | Code | Cause |
|---|---|---|
400 | invalid_request | model, 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 |
400 | unsupported_endpoint | Le 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 Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
Emplacement: header
En-têtes
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