SSE Format

event: progress
data: {"message":"Processing..."}

event: complete
data: {"config":{...},"response":{...}}

{
  "message": "Analyzing chart structure..."
}

{
  "config": { ... },
  "response": {
    "message": "Changed to bar chart",
    "steps": ["Changed type", "Updated colors"]
  }
}

{
  "error": "Invalid configuration",
  "code": "VALIDATION_ERROR",
  "retryable": false
}

import requests
import json

response = requests.post(
    'https://agents.graphy.dev/api/v0/generate',
    headers={
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_API_KEY'
    },
    json={'config': config, 'userPrompt': prompt},
    stream=True
)

event_type = None

for line in response.iter_lines():
    if not line:
        continue

    decoded = line.decode('utf-8')

    if decoded.startswith('event:'):
        event_type = decoded[6:].strip()
    elif decoded.startswith('data:'):
        data = json.loads(decoded[5:].strip())

        if event_type == 'progress':
            print(f"Progress: {data['message']}")
        elif event_type == 'complete':
            print(f"Done: {data['config']}")
        elif event_type == 'error':
            print(f"Error: {data['error']}")

curl -N https://agents.graphy.dev/api/v0/generate ...

response = requests.post(..., stream=True)

response = requests.post(url, ..., timeout=(5, 120))