---
title: "Named fields as guaranteed-valid JSON ($0.03)"
method: POST
path: "/v1/ai/extract"
---

# Named fields as guaranteed-valid JSON ($0.03)

`POST /v1/ai/extract`

## Request

- Base URL: `https://soren.com`
- URL: `https://soren.com/v1/ai/extract`
- Auth: none declared

POST the text (raw body, max 24,000 chars) with fields=comma,separated,names (max 12). Guarantee, checked server-side BEFORE charging: valid JSON, every requested field present, null when the text does not contain it, values never invented.

## Query parameters

- `fields` string, required

## Response `200`

Result.

- object

## Other responses

- `400`: Missing/invalid fields or empty body.
- `402`: Payment required.
- `413`: Input over 24,000 characters.
- `502`: Valid output could not be produced. Nothing charged.

---

[API](https://skmtc.dev/soren/apis/soren-free-games-api.md) · [All operations](https://skmtc.dev/soren/apis/soren-free-games-api/llms.txt) · [OpenAPI document](https://skmtc.dev/soren/apis/soren-free-games-api/revisions/00402cfcf30d?raw)