Tone API icon

Tone API

Analyze tone, detect emotions, and rewrite text using the Tone API

Actions9

Adapt Text

AI-generated

Summary

Adapt text to suit a specified target audience by providing the original text and audience details via preset options, a custom string, or a structured profile.

Inputs

  • Text (required) — The text to adapt for the target audience, up to 10,000 characters.
  • Audience Mode (required) — Choose how to specify the target audience: Preset, Custom String, or Structured Profile.
  • Audience Preset — Select a built-in audience preset such as 'Frustrated Customer' or 'C-Suite Executive'; required if Audience Mode is 'Preset'.
  • Audience — Describe the target audience in plain text; required if Audience Mode is 'Custom String'.
  • Emotional State — Specify the emotional state of the target audience; required if Audience Mode is 'Structured'.
  • Communication Needs — Comma-separated list of communication needs like empathy or clear next steps; required if Audience Mode is 'Structured'.
  • Tone Guidance — Instructions for the ideal tone to use, e.g. 'warm but direct'; required if Audience Mode is 'Structured'.
  • Avoid — Comma-separated list of things to avoid in the adapted text, e.g. 'corporate jargon'; optional if Audience Mode is 'Structured'.

Output shape

a single JSON object containing the adapted text returned by the Tone API

The adapted text is returned as JSON in the node's output. The text input is validated to be at most 10,000 characters. The audience specification depends on the chosen mode. Errors will be returned in output if the API call fails and 'Continue On Fail' is enabled.

Examples

Example 1: Adapt text for a frustrated customer using a preset audience

Provide the original text and select 'Preset' as Audience Mode with 'Frustrated Customer' preset.

Example 2: Adapt text for a custom audience described as 'senior engineer, upset parent'

Provide the original text and set Audience Mode to 'Custom String', filling in the target audience description.

Example 3: Adapt text for a structured audience profile

Provide the original text and select 'Structured Profile', specifying the emotional state, communication needs, tone guidance, and optionally things to avoid.

Links

Discussion