La structure du document est-elle conservée lors de la traduction ?

Oui. Les titres, les listes, les liens, la mise en forme et les segments de code sont conservés lors de la traduction et reproduits dans l'exportation. Ainsi, le fichier traduit s'intègre dans le même flux de travail que le document source.

Dois-je payer à nouveau si je relance un document inchangé ?

Non. Avec le comportement « uniquement les mises à jour », une exécution ne traite que les blocs dont la source a été modifiée depuis le dernier lancement. Relancer un document inchangé ne coûte rien, et une modification mineure ne coûte que quelques blocs.

Localiser un document Markdown via l'API

Maintenu par Vitalii VlasiukCo-founderPublié en juin 2026Mis à jour le 5 août 2026

Le Markdown est le format utilisé par la plupart des documents, articles d'aide et contenus de CMS. Envoyez-le tel quel à l'API, lancez un flux de travail pour vos différentes langues et récupérez le même contenu Markdown pour chaque langue, avec sa structure intacte.

Sur cette page

Comment envoyer du contenu Markdown ?

Utilisez POST /documents avec content_type: "markdown" et vos langues cibles. Transept segmente le document en blocs et crée une version pour chaque langue cible.

Ensuite, estimez et lancez le traitement comme décrit dans Automatiser Transept avec l'API ; l'exécution se déploie sur toutes les versions linguistiques en un seul appel.

# BASE="https://app.transept.ai/api/public/v1"; KEY from Settings → Developer
curl -s -X POST $BASE/documents \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"title": "Getting started", "content_type": "markdown", "source_language": "en",
       "target_languages": ["de", "fr"],
       "content": "# Getting started\n\nInstall the app, then…"}'
# → { document_id, language_group: [ {id, target_language}, … ] }

Comment récupérer les traductions ?

GET /documents/{id}/content?format=markdown sur chaque version linguistique renvoie le contenu Markdown tout en préservant sa structure. Les autres formats (json pour une lecture par bloc, docx, pdf, xliff, csv) sont répertoriés dans le tableau des formats de Automatiser Transept avec l'API.

curl -s "$BASE/documents/<de-version-id>/content?format=markdown" \
  -H "Authorization: Bearer $KEY"

Comment ne retraduire que ce qui a changé ?

Si la source est modifiée ultérieurement, utilisez le réalignement plutôt que la réimportation : l'appel POST /documents/{id}/resync-source conserve les blocs inchangés (ainsi que leurs traductions) et marque les blocs modifiés ou ajoutés comme obsolètes. Une exécution avec le comportement « uniquement les mises à jour » ne traite alors que ces derniers. C'est le pendant « prose » du delta indexé de Localiser un catalogue de chaînes via l'API ; le fonctionnement général est décrit dans Exécuter uniquement ce qui a changé.

# the source changed? re-align, then run only what went stale
curl -s -X POST $BASE/documents/<master>/resync-source \
  -H "Authorization: Bearer $KEY"

Questions fréquentes✦

La structure du document est-elle conservée lors de la traduction ?: Oui. Les titres, les listes, les liens, la mise en forme et les segments de code sont conservés lors de la traduction et reproduits dans l'exportation. Ainsi, le fichier traduit s'intègre dans le même flux de travail que le document source.
Dois-je payer à nouveau si je relance un document inchangé ?: Non. Avec le comportement « uniquement les mises à jour », une exécution ne traite que les blocs dont la source a été modifiée depuis le dernier lancement. Relancer un document inchangé ne coûte rien, et une modification mineure ne coûte que quelques blocs.

Continuer la lecture✦

Explorer les fonctionnalités✦

Un problème persiste ? Demandez à Literess dans l'application, ou écrivez à [email protected].