Convert annotated text

Convert annotated text (with semantic tags) into clean, readable text.

This endpoint requires authentication. Include your API key in the Authorization header.

Request Body

Parameter	Type	Required	Description
`model`	`valsea-convert`	Yes	Model name. Always `valsea-convert`.
`annotated_text`	string	Yes	Annotated text to convert.
`response_format`	`json` \| `verbose_json`	No	Default: `json`
`semantic_tags`	array	No	Optional context — local expressions and meanings to guide the conversion.
`semantic_tags[].tag`	string	No	Semantic tag category (e.g. `price_objection`).
`semantic_tags[].phrase`	string	No	The local phrase the tag applies to.
`semantic_tags[].meaning`	string	No	Plain-English meaning of the phrase, used as context.

Code Examples

curl -X POST https://api.valsea.ai/v1/conversions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "valsea-convert",
    "annotated_text": "Your annotated text here..."
  }'

Response

Minimal (`json`)

Field	Type	Description
`converted_text`	string	The transcript rewritten into natural, fluent English.

Verbose (`verbose_json`)

Field	Type	Description
`converted_text`	string	The transcript rewritten into natural, fluent English.
`annotated_text`	string	Echoes the `annotated_text` from the request.

Errors

Status	Description
`400`	Invalid request — missing `annotated_text` or unsupported `model`
`401`	Missing or invalid API key
`402`	Insufficient credits
`500`	Conversion service not configured
`502`	Upstream AI service error

Convert annotated text

Request Body

Code Examples

Response

Minimal (json)

Verbose (verbose_json)

Errors

Minimal (`json`)

Verbose (`verbose_json`)