API Instagram Post caption translation
Состояние API
- Состояние за 24 ч
- Норма
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
Translate the caption of one Instagram post into target_language (default en), from its url or media_id. Returns the original text, the translation and the detected source_language.
Отправьте POST https://api.everyinfra.com/api/v1/social, указав в platform значение instagram, а в action — post_translation. Цена: $6.39 за 1 000 запросов ($0.006389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.
Промпт для ИИ
#Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Instagram Post caption translation (instagram/post_translation).
Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: instagram и action: post_translation, а параметры передайте в params.
- Обязательных параметров нет.
- Необязательные параметры:
- media_id: The numeric post ID (the id in post results). Pass this or url.
- target_language: The language to translate into, as a language code such as en, zh-CN, zh-TW, ja, ko, es, pt-BR, fr or de. Defaults to en. A caption already in that language comes back as it is.
- url: A post or Reel link, such as https://www.instagram.com/p/<shortcode>/ or https://www.instagram.com/reel/<shortcode>/. Pass url or media_id; when both are given, url is used.
- Возвращает один объект. Основные поля: media_id (The numeric post ID), shortcode (The post shortcode: the part of the pos…), url, author_username, text, translation (The machine translation), source_language (The detected language code of the origi…), target_language (The language code translated into: the…).
- Пример тела запроса:
{
"platform": "instagram",
"action": "post_translation",
"params": {
"url": "https://www.instagram.com/p/DbYmqpplO_N/"
}
}
- Цена: $6.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.
Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.Параметры запроса
#| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
platform | body | string | Да | instagram | Идентификатор платформы, фиксированное значение. |
action | body | string | Да | post_translation | Идентификатор возможности, фиксированное значение. |
media_id | body.params | string | Нет | - | The numeric post ID (the id in post results). Pass this or url. |
target_language | body.params | string | Нет | - | The language to translate into, as a language code such as en, zh-CN, zh-TW, ja, ko, es, pt-BR, fr or de. Defaults to en. A caption already in that language comes back as it is. |
url | body.params | string | Нет | - | A post or Reel link, such as https://www.instagram.com/p/<shortcode>/ or https://www.instagram.com/reel/<shortcode>/. Pass url or media_id; when both are given, url is used. |
Примеры кода
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "instagram",
"action": "post_translation",
"params": {
"url": "https://www.instagram.com/p/DbYmqpplO_N/"
}
}'Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.
Пример ответа
#{ "id": "req_…", "platform": "instagram", "action": "post_translation", "results": { "media_id": "3952078729724096461", "shortcode": "DbYmqpplO_N", "url": "https://www.instagram.com/reel/DbYmqpplO_N/", "author_username": "n•••a", "text": "The Sun and Moon are coming together to put on a show for Earth, and we'll be sharing it with you. 😎\n\nOn Aug. 12, a total solar eclipse will pass over Earth, and we'll be broadcasting it live along the path of totality. Check our link in bio to learn how to watch along with us!\n\n…", "translation": "The Sun and Moon are coming together to put on a show for Earth, and we'll be sharing it with you. 😎\n\nOn Aug. 12, a total solar eclipse will pass over Earth, and we'll be broadcasting it live along the path of totality. Check our link in bio to learn how to watch along with us!\n\n…", "source_language": "en", "target_language": "en", "platform": "instagram" }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Поля ответа
#Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.
| Поле | Значение |
|---|---|
media_id | The numeric post ID. oembed gives it as postID_authorID. |
shortcode | The post shortcode: the part of the post link after /p/ or /reel/. |
url | Ссылка на запись на платформе. |
author_username | Имя пользователя автора (@handle), обычно подходит для URL. |
text | Основной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы). |
translation | The machine translation. Absent when the post has no caption. |
source_language | The detected language code of the original text, such as en; und when it cannot be detected. |
target_language | The language code translated into: the target_language you passed, or en. |
platform | Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok). |
Ошибки и оплата
#- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.