apyhub
▣ ARTIFICIAL INTELLIGENCE · SMART GENERATION

Paraphrase Text API

What it does

Text Paraphraser rewrites content into a new phrasing while keeping the original meaning intact. Send the text you want paraphrased, and you get back a job ID plus a status URL to check when the result is ready.

Use the submit endpoint to pass content, with optional context to guide the rewrite, language to set the output language, max_length to constrain length, and voice_tone to steer style. The service processes the request asynchronously, so it works well for longer passages or batch content where you do not want to wait on a synchronous response.

When the job finishes, the status endpoint returns a result object containing paraphrase, along with the job status (queued, running, success, or failed). That makes it useful for content tooling, editorial workflows, and applications that need alternate wording for articles, product copy, summaries, or user-generated text without changing the underlying meaning.

If you need to generate a cleaner version of a sentence, adapt tone for a different audience, or localize phrasing into another language, Text Paraphraser gives you a focused paraphrasing workflow with a simple job-based response model.

▣ ENDPOINT 01 / 02
POST
Paraphrase Text - Submit Job
https://api.eu.apyverse.com/sharpapi/paraphrase-text/paraphrase

QUICKSTART

GUIDE

Quickstart

Submit text for paraphrasing with the required content field.

curl -X POST "https://api.eu.apyverse.com/sharpapi/paraphrase-text/paraphrase" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Please rewrite this paragraph in a clearer, more concise way."
  }'

What you'll get back

Returns a JSON object with two string fields: job_id is the unique identifier of the submitted job, and status_url is the URL to poll for the job’s status and result.

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status_url": "https://example.com/jobs/550e8400-e29b-41d4-a716-446655440000"
}
TRY ITLIVE · 50 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
Provide the content to paraphrase.
Provide additional context to improve paraphrasing accuracy.
Specify the language of the output.
Specify the maximum length of the paraphrased content.
Specify the voice tone of the output. Can be an adjective like `funny` or `joyous`, or even the name of a famous writer.

About this endpoint

What it does

Submits a paraphrasing job for the provided text content and returns job-tracking information so you can poll for the result later. The request sends the content to paraphrase plus optional context and style controls; the response contains the job identifier and a status URL.

Request Body

ParameterTypeMandatoryDescription
contentStringYesProvide the content to paraphrase.
contextStringNoProvide additional context to improve paraphrasing accuracy.
languageStringNoSpecify the language of the output. Default: English.
max_lengthNumberNoSpecify the maximum length of the paraphrased content. Minimum: 1.
voice_toneStringNoSpecify the voice tone of the output. Can be an adjective like funny or joyous, or even the name of a famous writer.

Response

Returns a JSON object with a job_id string field and a status_url string field. job_id is the unique identifier of the submitted job, and status_url is the URL to poll for the job's status and result.

AttributeTypeMandatoryDescription
job_idStringNoThe unique identifier of the submitted job. Format: UUID.
status_urlStringNoURL to poll for the job's status and result. Format: URI.

Notes

This endpoint kicks off an async job and returns immediately with a job identifier; the actual work runs in the background. Pair this call with the corresponding job_check endpoint — poll that until the status reaches a terminal state to retrieve the result. Use the job_id field from the response to track the job, and the status_url field to poll for updates.

Body

Name
Type
Description
bodyREQUIRED
object
—
▣ ENDPOINT 02 / 02
GET
Paraphrase Text - Check Job Status
https://api.eu.apyverse.com/sharpapi/paraphrase-text/summarize/job/status/:job_id

QUICKSTART

GUIDE

Quickstart

Check the status of a summarization job by its job ID.

curl -X GET "https://api.eu.apyverse.com/sharpapi/paraphrase-text/summarize/job/status/:job_id" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with a data object. Inside data, id is a UUID, type is the response type, and attributes contains the job type, status, and a result object with a paraphrase string when available.

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "api_job_result",
    "attributes": {
      "type": "content_paraphrase",
      "result": {
        "paraphrase": "..."
      },
      "status": "success"
    }
  }
}
TRY ITLIVE · 1 ATOM
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Checks the status of a paraphrase job by its job ID and returns the job result envelope when available.

Path Parameter(s)

AttributeTypeMandatoryDescription
job_idStringYesUUID that identifies the job.

Response

Returns a JSON object with a data object field. The data object contains the job id as a UUID string, the job type as a string, and an attributes object with type, result, and status fields.

AttributeTypeMandatoryDescription
dataObjectNoJob result wrapper object.
data.idStringNoUUID that identifies the job result.
data.typeStringNoResult resource type.
data.attributesObjectNoJob attributes object containing the result payload and status.
data.attributes.typeStringNoContent type for the paraphrase job result.
data.attributes.resultObjectNoResult object containing the paraphrased content.
data.attributes.result.paraphraseStringNoThe paraphrased version of the provided content.
data.attributes.statusENUMNoJob status. Allowed values: running, failed, queued, success.

Notes

Poll this endpoint with the job_id returned by the submit call. The data.attributes.status field cycles through transitional values (queued, running) before reaching a terminal state (success, failed). The result field data.attributes.result.paraphrase is only populated once status is success; treat it as absent otherwise.

Path parameters

Name
Type
Description
job_idREQUIRED
string
—
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Product
CatalogPricingQuickstartBecome a providerStatus (opens in new tab)
Company
AboutBlogCareers (opens in new tab)Contact
Legal
Terms of ServicePrivacy PolicyProvider terms
© 2026 APYHUB · BUILT FOR DEVELOPERS