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 |