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",
"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 |
Eingaben | ja | ein Objekt, dessen Schlüssel jeweils dem Schlüssel |
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 |
So senden Sie jede Eingabe
akzeptiert | Senden | Mit allow_multiple |
|---|---|---|
Wert | 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 Akzeptiert
{
"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 |
eingelesen | 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 abgelaufen |
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.