106 lines
2.2 KiB
Markdown
106 lines
2.2 KiB
Markdown
---
|
|
title: Translation
|
|
description: Represents the result of machine translating some status content
|
|
menu:
|
|
docs:
|
|
parent: entities
|
|
aliases: [
|
|
"/api/entities/Translation",
|
|
"/api/entities/translation",
|
|
]
|
|
---
|
|
|
|
## Examples
|
|
|
|
Translation of status with content warning and media
|
|
|
|
```json
|
|
{
|
|
"content": "<p>Hello world</p>",
|
|
"spoiler_text": "Greatings ahead",
|
|
"media_attachments": [
|
|
{
|
|
"id": 22345792,
|
|
"description": "Status author waving at the camera"
|
|
}
|
|
],
|
|
"poll": null,
|
|
"detected_source_language": "es",
|
|
"provider": "DeepL.com"
|
|
}
|
|
```
|
|
|
|
Translation of status with poll:
|
|
```json
|
|
{
|
|
"content": "<p>Should I stay or should I go?</p>",
|
|
"spoiler_text": "",
|
|
"media_attachments": [],
|
|
"poll": [
|
|
{
|
|
"id": 34858,
|
|
"options": [
|
|
{
|
|
"title": "Stay"
|
|
},
|
|
{
|
|
"title": "Go"
|
|
}
|
|
]
|
|
}
|
|
],
|
|
"detected_source_language": "ja",
|
|
"provider": "DeepL.com"
|
|
}
|
|
```
|
|
|
|
|
|
## Attributes
|
|
|
|
### `content` {#content}
|
|
|
|
**Description:** HTML-encoded translated content of the status.\
|
|
**Type:** String (HTML)\
|
|
**Version history:**\
|
|
4.0.0 - added
|
|
|
|
### `spoiler_warning` {#spoiler_warning}
|
|
|
|
**Description:** The translated spoiler warning of the status.\
|
|
**Type:** String\
|
|
**Version history:**\
|
|
4.2.0 - added
|
|
|
|
### `poll` {#poll}
|
|
|
|
**Description:** The translated poll options of the status.\
|
|
**Type:** Array\
|
|
**Version history:**\
|
|
4.2.0 - added
|
|
|
|
### `media_attachments` {#media_attachments}
|
|
|
|
**Description:** The translated media descriptions of the status.\
|
|
**Type:** Array\
|
|
**Version history:**\
|
|
4.2.0 - added
|
|
|
|
### `detected_source_language` {#detected_source_language}
|
|
|
|
**Description:** The language of the source text, as auto-detected by the machine translation provider.\
|
|
**Type:** String (ISO 639 language code)\
|
|
**Version history:**\
|
|
4.0.0 - added
|
|
|
|
### `provider` {#provider}
|
|
|
|
**Description:** The service that provided the machine translation.
|
|
**Type:** String\
|
|
**Version history:**\
|
|
4.0.0 - added
|
|
|
|
## See also
|
|
|
|
{{< page-relref ref="methods/statuses#translate" caption="POST /api/v1/statuses/:id/translate" >}}
|
|
|
|
{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/translation_serializer.rb" caption="app/serializers/rest/translation_serializer.rb" >}} |