# The Parallel Task Group API

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
import httpx
from parallel.types import TaskRunCreateParams

client = httpx.Client(
    base_url="https://api.parallel.ai",
    headers={"x-api-key": "your-api-key"},
)

# 1. Create a task-group shell
group_resp = client.post("/v1/tasks/groups", json={}).json()
taskgroup_id = group_resp["taskgroup_id"]

# 2. Initiate runs in that group
questions = [
    "What is the capital of France?",
    "What is the capital of Germany?",
]
run_resp = client.post(
    f"/v1/tasks/groups/{taskgroup_id}/runs",
    json={
        "inputs": [
            TaskRunCreateParams(input=q, processor="lite")
            for q in questions
        ]
    },
).json()

print("Initial status:", run_resp["status"])

# 3. Stream live events for this run
events_url = f"/v1/tasks/groups/{taskgroup_id}/events"

with client.stream("GET", events_url) as stream:
    for chunk in stream.iter_text():
        if chunk.strip():  # ignore keep-alive blanks
            print("Event:", chunk)``` 
import httpx
from parallel.types import TaskRunCreateParams
 
client = httpx.Client(
    base_url="https://api.parallel.ai",
    headers={"x-api-key": "your-api-key"},
)
 
# 1. Create a task-group shell
group_resp = client.post("/v1/tasks/groups", json={}).json()
taskgroup_id = group_resp["taskgroup_id"]
 
# 2. Initiate runs in that group
questions = [
    "What is the capital of France?",
    "What is the capital of Germany?",
]
run_resp = client.post(
    f"/v1/tasks/groups/{taskgroup_id}/runs",
    json={
        "inputs": [
            TaskRunCreateParams(input=q, processor="lite")
            for q in questions
        ]
    },
).json()
 
print("Initial status:", run_resp["status"])
 
# 3. Stream live events for this run
events_url = f"/v1/tasks/groups/{taskgroup_id}/events"
 
with client.stream("GET", events_url) as stream:
    for chunk in stream.iter_text():
        if chunk.strip():  # ignore keep-alive blanks
            print("Event:", chunk)
```