Einen Workflow-Lauf starten
Starten Sie einen Workflow mit Ihren Eingaben und erhalten Sie eine Ausführungs-ID zurück.
POST {base_url}/workflow-runsErfordert runs:write.
Anfrage
POST {base_url}/workflow-runs
Authorization: Bearer mor_live_…
Content-Type: application/json
{
"org_id": "0192f3c1-7a44-7d10-9b22-1e5c8f0a3b61",
"project_id": "0192f3c2-4b18-7e93-8c07-9d2a6f4e1c58",
"workflow_id": "0192f3c3-9d21-7c44-b8e1-5a7f2c9d4e10",
"workflow_version_id": "0192f3c4-1a02-7bb3-9f40-2c6e8d1a5b77",
"idempotency_key": "story-48213-v2",
"name": "Story 48213",
"inputs": {
"story_document": "https://cdn.example.com/stories/48213.pdf",
"character_sheets": [
"https://cdn.example.com/chars/48213-a.png",
"https://cdn.example.com/chars/48213-b.png"
],
"episode_count": 8,
"tone": "thriller"
}
}| Body-Feld | Erforderlich | Bedeutung |
|---|---|---|
org_id | ja | Ihre Organisation; muss mit dem Schlüssel übereinstimmen |
project_id | ja | die Canvas, in der der Lauf und seine Assets landen — die ID in ihrer Studio-URL, …/editor/<project_id>/canvas |
workflow_id | ja | der auszuführende Workflow |
inputs | ja | ein Objekt, dessen Schlüssel jeweils dem key einer Eingabe entsprechen |
idempotency_key | empfohlen | macht einen erneuten Versuch sicher — siehe Konventionen |
workflow_version_id | nein | fixiert die Version, aus der Sie die Eingaben gelesen haben |
webhook_id | nein | sendet die Ereignisse dieses Laufs an einen registrierten Endpunkt — siehe Webhooks |
name | nein | der Titel der Studio-Sitzung des Laufs, angezeigt als API: <name>. Eine Zeile, höchstens 250 Zeichen. Ohne Angabe wird der Name des Workflows verwendet |
So senden Sie jede Eingabe
accepts | Senden | Mit allow_multiple |
|---|---|---|
value | die Zeichenkette, Zahl oder der boolesche Wert selbst | ein Array davon |
url | ein öffentlicher HTTPS-Link als Zeichenkette | ein Array von Links |
option | eine options[].id, genau wie angegeben | ein Array von IDs |
Antwort
202 Accepted
{
"run": {
"id": "0192f3d0-6c31-7a52-b4e8-3f9d1a7c5e20",
"status": "queued",
"workflow_id": "0192f3c3-9d21-7c44-b8e1-5a7f2c9d4e10",
"workflow_version_id": "0192f3c4-1a02-7bb3-9f40-2c6e8d1a5b77",
"project_id": "0192f3c2-4b18-7e93-8c07-9d2a6f4e1c58",
"chat_id": "0192f3c6-2e75-7b14-9a63-7c4e2d8f1b09",
"ingested": [
{ "input": "story_document", "bytes": 184320, "mime_type": "application/pdf" },
{ "input": "character_sheets", "bytes": 962144, "mime_type": "image/png" },
{ "input": "character_sheets", "bytes": 883021, "mime_type": "image/png" }
],
"poll_after_seconds": 60,
"expires_at": "2026-09-23T04:10:00Z"
}
}| Antwortfeld | Bedeutung |
|---|---|
id | die Lauf-ID. Fragen Sie sie ab und führen Sie sie in Ihrem eigenen Datensatz mit |
status | queued bei Annahme |
chat_id | die Studio-Sitzung, in der der Lauf stattfindet. Öffnen Sie sie, um den Lauf zu beobachten oder eine Frage zu beantworten, die er stellt |
ingested | ein Eintrag pro abgerufener Datei, in der gesendeten Reihenfolge. Nützlich, um zu bestätigen, dass Sie das Richtige gesendet haben |
poll_after_seconds | wie lange vor der ersten Abfrage gewartet werden soll |
expires_at | wenn ein unvollendeter Lauf als expired aufgegeben wird |
Jeder Link wird abgerufen und verifiziert vor der 202. Ein Lauf, der als akzeptiert zurückkommt, hat seine Dateien bereits vorliegen, sodass ein fehlerhafter Link ein sofortiger 400 statt eines Fehlers zehn Minuten später ist.