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_model_service": "auto",
"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
}
}
}
}{
"error": "Invalid input data."
}{
"error": "Invalid API key."
}Styling
Style transform
Use fine-tuned model to style text.
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_model_service": "auto",
"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
}
}
}
}{
"error": "Invalid input data."
}{
"error": "Invalid API key."
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
- Full Mode
- Rewrite Mode
Use 'full' for end-to-end inference of a prompt.
Available options:
full Example:
"full"
Conversation history. Required when mode is 'full'.
Show child attributes
Show child attributes
Example:
[
{
"role": "user",
"content": "Write a blog post about Florence."
}
]
ID of the fine-tuned model to use.
Example:
"ftm-custom-name-0b5ace7e-ffb2-43cf-8a4d-0af17bc2b1d1"
Options specific to 'full' mode.
Show child attributes
Show child attributes
Whether to stream the response.
Example:
false
Whether to include quality metrics in the response.
Example:
false
Whether to include rouge score in quality metrics. Only applies when include_quality is true.
Example:
false
Whether to include original text for comparison to styled text.
Example:
false
Whether to include distance metrics comparing the original and styled text.
Example:
false
When set to true, headings are not rewritten.
Example:
false
When set to true, H1 headings are not rewritten.
Example:
false
Response
A chat completion object.
ID of the chat completion.
Example:
"chatcmpl-123"
Type of the object, always 'chat.completion'.
Example:
"chat.completion"
Unix timestamp for when the completion was created.
Example:
1677652288
Model used for the completion.
Example:
"ftm-custom-name-0b5ace7e-ffb2-43cf-8a4d-0af17bc2b1d1"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Quality analytics comparing the styled text against the input text and training data. Only present when include_quality is true.
Show child attributes
Show child attributes