Документация по использованию API для перефразирования текста от ReText.AI

Введение

API ReText.AI предоставляет возможность перефразировать текст с использованием современных методов обработки естественного языка. Данный API позволяет отправить запрос с текстом и получить его перефразированный вариант.

Основные функции

• Перефразирование текста
• Получение результата перефразирования по уникальному идентификатору задачи

Конечные точки API

1. Создание задачи на перефразирование текста

URL: https://api.retext.ai/public/api/process

Метод: POST

Заголовки:

• Content-type: application/json

Тело запроса:

{
    "method": "paraphrase",
    "api_token": "YOUR_API_TOKEN",
    "text": "Текст для перефразирования"
}

Пример запроса:

curl -X POST "https://api.retext.ai/public/api/process" -H "Content-type: application/json" --data '{
  "method": "paraphrase",
  "api_token": "YOUR_API_TOKEN",
  "text": "Figma попыталась решить четыре ключевые задачи. Первая — интерфейс не должен отвлекать от идей, над которыми работает дизайнер. Вторая — он должен оставаться интуитивно понятным даже при многообразии функций."
}' | jq

Пример ответа:

{
  "data": {
    "taskId": "ab43428b-8cc8-4785-a4f3-ccfb7bd8a60c"
  },
  "status": "ok"
}

2. Проверка статуса задачи и получение результата

URL: https://api.retext.ai/public/api/check

Метод: GET

Параметры запроса:

• taskId — уникальный идентификатор задачи, полученный на первом этапе

Пример запроса:

curl "https://api.retext.ai/public/api/check?taskId=ab43428b-8cc8-4785-a4f3-ccfb7bd8a60c" | jq

Пример ответа:

{
  "data": {
    "ready": true,
    "result": "Figma решила четыре основные задачи. Следующая рекомендация: дизайн интерфейса не должен отвлекать от разработки новых идей, которые будут реализованы дизайнером. При многообразии функций, он должен оставаться понятным."
  },
  "status": "ok"
}

Пример использования API на Python

import aiohttp
import asyncio

API_URL_PROCESS = "https://api.retext.ai/public/api/process"
API_URL_CHECK = "https://api.retext.ai/public/api/check"
API_TOKEN = "YOUR_API_TOKEN"

async def paraphrase_text(text):
    async with aiohttp.ClientSession() as session:
        # Step 1: Send the request to paraphrase
        async with session.post(API_URL_PROCESS, json={
            "method": "paraphrase",
            "api_token": API_TOKEN,
            "text": text,
        }) as response:
            response_data = await response.json()
            task_id = response_data["data"]["taskId"]

        # Step 2: Check status and get result
        paraphrased_text = None
        while True:
            async with session.get(API_URL_CHECK, params={"taskId": task_id}) as response:
                response_data = await response.json()
                if response_data["data"]["ready"]:
                    paraphrased_text = response_data["data"]["result"]
                    break
                await asyncio.sleep(1)  # wait before repeat

        return paraphrased_text

# Sample
text_to_paraphrase = "Figma попыталась решить четыре ключевые задачи. Первая — интерфейс не должен отвлекать от идей, над которыми работает дизайнер. Вторая — он должен оставаться интуитивно понятным даже при многообразии функций."
result = asyncio.run(paraphrase_text(text_to_paraphrase))
print("Paraphrased text:", result)

Этот пример демонстрирует, как можно использовать API для перефразирования текста на Python.