API · v1

Integrate ambivalence-structure analysis into your toolchain.

A single endpoint returns the full three-stage computational analysis: lexical-density timeline, peak concentration moments, dominant semantic-conflict themes, structured analytical summary, and the graduated alert layer. Supported languages: English, German, French, Spanish, Turkish, Japanese, Hebrew, and Persian.

Three tiers expose the API. Sandbox is web-only.

Professional
€25/ month
100 analyses included
  • Overage €0.25 per analysis
  • All eight languages, switchable per request
  • Basic API access
  • Interim analysis during live recording
  • Priority support
Request access
Enterprise
Custom
Negotiated annual volume
  • White-label and custom deployment
  • On-premise or private-cloud option
  • Defence, intelligence, and large-scale fit
  • Named support and SLA
Speak to the team

Sandbox access is available on request and runs the full three-stage computational pipeline on a single language for evaluation. Sandbox does not expose the API.

Submit a passage for analysis.

Method
POST
Auth
X-Session-Token
Encoding
application/json
# Submit a passage for ambivalence-structure analysis
curl -X POST https://api.llulllab.com/asge/v1/analyse \
  -H "X-Session-Token: $ASGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text":     "The text to analyse. Paste a transcript, an interview, a speech, or any natural-language passage.",
    "language": "en",
    "mode":     "text"
  }'

Request fields

FieldTypeDescription
textstring · requiredThe passage to analyse. Up to 10,000 words per submission. Line breaks segment temporal units.
languageenum · requiredOne of en, de, fr, es, tr, ja, he, fa.
modeenum · optionaltext (default) or microphone. The latter is reserved for sessions originating from a live recording context.
contextobject · optionalOptional metadata kept alongside the case record (source, author, date, location). Up to 4 KB.

Response shape

{
  "success": true,
  "analysis": {
    "pairs": [
      { "minute": 3, "type": "classic",    "context": "..." },
      { "minute": 7, "type": "contextual", "context": "..." }
    ],
    "trend": [
      { "minute": 1, "level": "low", "note": "..." }
      // minute-by-minute
    ],
    "peak_minute":      4,
    "dominant_theme":   "freedom ↔ constraint",
    "conflict_summary": "Two to three sentences naming the sustained tensions.",
    "alert_level":      3
  },
  "stats": {
    "word_count":    1820,
    "pair_count":    24,
    "classic_count": 17,
    "context_count": 7,
    "pairs_per_min": 2.4
  }
}

Response fields

FieldTypeDescription
successbooleanTrue when the three-stage computational pipeline completed.
analysis.pairsarrayEach entry: minute, type (classic or contextual), and a short context fragment.
analysis.trendarrayMinute-by-minute density with level (low, medium, high) and a one-line analytical note.
analysis.peak_minuteintegerThe minute index where ambivalence density is highest.
analysis.dominant_themestringThe dominant semantic-conflict theme, expressed as an opposition.
analysis.conflict_summarystringTwo to three sentences naming the sustained tensions across the passage.
analysis.alert_levelintegerGraduated alert from 1 to 4. Higher values correspond to denser concentrations.
statsobjectCounts and densities: words, pairs, classic and contextual splits, pairs per minute.

Six outcomes worth handling.

200 · success 400 · validation 401 · unauthenticated 413 · payload_too_large 429 · quota_exceeded 503 · transient_failure

Validation rejections, unauthenticated rejections, payload-size rejections, and rate-limit rejections do not consume quota. Transient failures auto-retry once and are not billed.

Quota behaviour.

Window
Tier-defined
Halts
Not billed
Failures
Not billed
Retries
Safe to retry

Quota window, rate limits, and overage handling are set per tier at access provisioning. The yearly plan applies a multi-month discount.

Documentation & contact.

The documentation page bundles the Integration Guide, the Methodology, and an Applications & Use Cases reference, all available as PDFs alongside the on-page reading.

For integration enquiries, sandbox access requests, or contract negotiations, contact [email protected].