Skip to main content
POST
/
style
/
transform
curl --request POST \
  --url https://vaeroapi.com/v1/style/transform \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "mode": "full",
  "messages": [
    {
      "role": "user",
      "content": "Write a blog post about Florence."
    }
  ],
  "model": "ftm-custom-name-0b5ace7e-ffb2-43cf-8a4d-0af17bc2b1d1",
  "full_mode_options": {
    "base_model": "claude-sonnet-4-6",
    "base_temperature": 0
  },
  "stream": false,
  "include_quality": false,
  "include_rouge": false,
  "include_compare_original": false,
  "include_distance": false,
  "skip_headings": false,
  "skip_h1": false
}
'
{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "ftm-custom-name-0b5ace7e-ffb2-43cf-8a4d-0af17bc2b1d1",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "The lazy dog was vaulted by a brown fox with the zoomies."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 12,
    "total_tokens": 21
  },
  "quality_analytics": {
    "rouge": {
      "rouge1": {
        "personalized": {
          "precision": 0.6875,
          "recall": 0.0006273883533907488,
          "fmeasure": 0.0012536326856231125
        },
        "unpersonalized": {
          "precision": 0.5833333333333334,
          "recall": 0.0003992471339759311,
          "fmeasure": 0.0007979481333713309
        },
        "personalization_improvement": {
          "precision": 0.1786,
          "recall": 0.5714,
          "fmeasure": 0.5711
        }
      },
      "rouge2": {
        "personalized": {
          "precision": 0.4,
          "recall": 0.00034223134839151266,
          "fmeasure": 0.0006838775859121217
        },
        "unpersonalized": {
          "precision": 0.18181818181818182,
          "recall": 0.00011407711613050422,
          "fmeasure": 0.00022801117254745484
        },
        "personalization_improvement": {
          "precision": 1.2,
          "recall": 2,
          "fmeasure": 1.9993
        }
      },
      "rougeL": {
        "personalized": {
          "precision": 0.6875,
          "recall": 0.0006273883533907488,
          "fmeasure": 0.0012536326856231125
        },
        "unpersonalized": {
          "precision": 0.5833333333333334,
          "recall": 0.0003992471339759311,
          "fmeasure": 0.0007979481333713309
        },
        "personalization_improvement": {
          "precision": 0.1786,
          "recall": 0.5714,
          "fmeasure": 0.5711
        }
      }
    },
    "sentence_length_stats": {
      "mean": {
        "personalized": 16,
        "unpersonalized": 12,
        "ground_truth": 15.157374100719425,
        "personalization_improvement": 0.7331
      },
      "median": {
        "personalized": 16,
        "unpersonalized": 12,
        "ground_truth": 14,
        "personalization_improvement": 0
      },
      "std_dev": {
        "personalized": 0,
        "unpersonalized": 0,
        "ground_truth": 8.524586718203045,
        "personalization_improvement": 0
      }
    },
    "word_length_stats": {
      "mean": {
        "personalized": 4.1875,
        "unpersonalized": 5.25,
        "ground_truth": 4.468670643122896,
        "personalization_improvement": 0.6401
      },
      "median": {
        "personalized": 4,
        "unpersonalized": 5,
        "ground_truth": 4,
        "personalization_improvement": 1
      },
      "std_dev": {
        "personalized": 2.3242942477233814,
        "unpersonalized": 2.520747243709029,
        "ground_truth": 2.4604427259371198,
        "personalization_improvement": -0.5571
      }
    },
    "readability": {
      "flesch_reading_ease": {
        "unpersonalized": 42.38,
        "personalized": 63.7,
        "ground_truth": 63.29,
        "personalization_improvement": 0.9804
      },
      "flesch_kincaid_grade": {
        "unpersonalized": 10.3,
        "personalized": 8.4,
        "ground_truth": 8.5,
        "personalization_improvement": 0.9444
      }
    },
    "function_word_frequency": {
      "jensen_shannon_distance": {
        "personalized": 0.6689444357441154,
        "unpersonalized": 0.7306543651658907,
        "personalization_improvement": 0.0845
      }
    },
    "pos_frequency": {
      "jensen_shannon_distance": {
        "personalized": 0.45509363085996124,
        "unpersonalized": 0.5559353944473231,
        "personalization_improvement": 0.1814
      }
    },
    "lexical_density": {
      "personalized": 0.5625,
      "unpersonalized": 0.6666666666666666,
      "ground_truth": 0.4917616488513553,
      "personalization_improvement": 0.5956
    },
    "sentence_structure_frequency": {
      "simple": {
        "personalized": 0,
        "unpersonalized": 1,
        "ground_truth": 0.4064748201438849
      },
      "compound": {
        "personalized": 0,
        "unpersonalized": 0,
        "ground_truth": 0.030575539568345324
      },
      "complex": {
        "personalized": 1,
        "unpersonalized": 0,
        "ground_truth": 0.5134892086330936
      },
      "compound-complex": {
        "personalized": 0,
        "unpersonalized": 0,
        "ground_truth": 0.04946043165467626
      },
      "fragment/unknown": {
        "personalized": 0,
        "unpersonalized": 0,
        "ground_truth": 0
      },
      "jensen_shannon_distance": {
        "personalized": 0.45652139629164,
        "unpersonalized": 0.519924367696954,
        "personalization_improvement": 0.1219
      }
    },
    "sentence_voice_frequency": {
      "active": {
        "personalized": 1,
        "unpersonalized": 1,
        "ground_truth": 0.9055755395683454
      },
      "passive": {
        "personalized": 0,
        "unpersonalized": 0,
        "ground_truth": 0.09442446043165467
      },
      "jensen_shannon_distance": {
        "personalized": 0.18410656144604748,
        "unpersonalized": 0.18410656144604748,
        "personalization_improvement": 0
      }
    },
    "punctuation": {
      "comma_density": {
        "personalized": 0,
        "unpersonalized": 0,
        "ground_truth": 0.3713057495969909
      },
      "semicolon_density": {
        "personalized": 0,
        "unpersonalized": 0,
        "ground_truth": 0.011821601289629231
      },
      "colon_density": {
        "personalized": 0,
        "unpersonalized": 0,
        "ground_truth": 0.04674905964535196
      },
      "period_density": {
        "personalized": 1,
        "unpersonalized": 1,
        "ground_truth": 0.5292853304674906
      },
      "question_mark_density": {
        "personalized": 0,
        "unpersonalized": 0,
        "ground_truth": 0.030628694250403012
      },
      "exclamation_mark_density": {
        "personalized": 0,
        "unpersonalized": 0,
        "ground_truth": 0.0016120365394948952
      },
      "parenthetical_density": {
        "personalized": 0,
        "unpersonalized": 0,
        "ground_truth": 0.008597528210639442
      },
      "jensen_shannon_distance": {
        "personalized": 0.4471617217138273,
        "unpersonalized": 0.4471617217138273,
        "personalization_improvement": 0
      }
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.vaero.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
mode
enum<string>
required

Use 'full' for end-to-end inference of a prompt.

Available options:
full
Example:

"full"

​
messages
object[]
required

Conversation history. Required when mode is 'full'.

Example:
[
  {
    "role": "user",
    "content": "Write a blog post about Florence."
  }
]
​
model
string
required

ID of the fine-tuned model to use.

Example:

"ftm-custom-name-0b5ace7e-ffb2-43cf-8a4d-0af17bc2b1d1"

​
full_mode_options
object

Options specific to 'full' mode.

​
stream
boolean
default:false

Whether to stream the response.

Example:

false

​
include_quality
boolean
default:false

Whether to include quality metrics in the response.

Example:

false

​
include_rouge
boolean
default:false

Whether to include rouge score in quality metrics. Only applies when include_quality is true.

Example:

false

​
include_compare_original
boolean
default:false

Whether to include original text for comparison to styled text.

Example:

false

​
include_distance
boolean
default:false

Whether to include distance metrics comparing the original and styled text.

Example:

false

​
skip_headings
boolean
default:false

When set to true, headings are not rewritten.

Example:

false

​
skip_h1
boolean
default:false

When set to true, H1 headings are not rewritten.

Example:

false

Response

A chat completion object.

​
id
string

ID of the chat completion.

Example:

"chatcmpl-123"

​
object
string

Type of the object, always 'chat.completion'.

Example:

"chat.completion"

​
created
integer

Unix timestamp for when the completion was created.

Example:

1677652288

​
model
string

Model used for the completion.

Example:

"ftm-custom-name-0b5ace7e-ffb2-43cf-8a4d-0af17bc2b1d1"

​
choices
object[]
​
usage
object
​
quality_analytics
object

Quality analytics comparing the styled text against the input text and training data. Only present when include_quality is true.