telnyx-code-examples/extract-structured-json-with-ai-python at main · team-telnyx/telnyx-code-examples

name	extract-structured-json-with-ai
title	Extract Structured JSON with AI
description	Extract structured JSON from support tickets, emails, leads, or incident reports with Telnyx AI Inference.
language	python
framework	flask
telnyx_products	AI Inference

Extract structured JSON from support tickets, emails, leads, or incident reports with Telnyx AI Inference.

Telnyx API Endpoints Used

AI Inference: POST /v2/ai/chat/completions - API reference

Architecture

  Unstructured text
        |
        v
  Flask API validates request
        |
        v
  Telnyx AI Inference extracts JSON
        |
        v
  Structured JSON response

Environment Variables

Copy .env.example to .env and fill in:

Variable	Type	Example	Required	Description	Where to get it
`TELNYX_API_KEY`	`string`	`KEY0123456789ABCDEF`	yes	Telnyx API v2 key	Portal
`AI_MODEL`	`string`	`moonshotai/Kimi-K2.6`	no	Telnyx AI Inference model name	Models
`HOST`	`string`	`127.0.0.1`	no	Local server host	-
`PORT`	`integer`	`5000`	no	Local server port	-

Setup

git clone https://github.com/team-telnyx/telnyx-code-examples.git
cd telnyx-code-examples/extract-structured-json-with-ai-python
cp .env.example .env
pip install -r requirements.txt
python app.py

API Reference

`POST /extract`

Extract structured data from text. If you do not provide a schema, the app uses a default support-ticket schema.

curl -X POST http://localhost:5000/extract \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Account: Acme Health. Production verification jobs started failing after an API key rotation. Users cannot finish signup. Logs show 401 errors."
  }'

Response:

{
  "model": "moonshotai/Kimi-K2.6",
  "result": {
    "company": "Acme Health",
    "category": "authentication",
    "priority": "urgent",
    "summary": "Production verification jobs are failing after an API key rotation.",
    "affected_environment": "production",
    "affected_region": "unknown",
    "customer_impact": "Users cannot finish signup.",
    "error_codes": ["401"],
    "suspected_cause": "The new API key may be invalid or missing required permissions.",
    "requested_action": "Check API key configuration and permissions."
  }
}

`GET /sample`

Returns sample text and the default schema.

`GET /health`

Returns service status and configured model.

Troubleshooting

Issue	Cause	Fix
`401 Unauthorized`	Invalid or missing Telnyx API key	Verify `TELNYX_API_KEY` in `.env`
`400 Bad Request`	Missing `text` or invalid `schema`	Send a non-empty `text` string and a JSON object schema
`502 Model response was not valid JSON`	The selected model did not return parseable JSON	Retry with the default model or simplify the schema

Related Examples

Resources

Why Telnyx

Telnyx is an AI Communications Infrastructure platform - voice, messaging, SIP, AI, and IoT on one private, global network.

推荐订阅源

Hacker News - Newest: "AI"