Bir iş akışı çalıştırmasını başlat
Girdilerinizle bir iş akışı başlatın ve bir çalıştırma kimliği alın.
POST {base_url}/workflow-runsruns:write gerektirir.
İstek
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"
}
}| Gövde alanı | Gerekli | Anlamı |
|---|---|---|
org_id | evet | organizasyonunuz; anahtarınkiyle eşleşmelidir |
project_id | evet | çalışmanın ve varlıklarının yerleştirildiği tuval — Studio URL'sindeki kimliği, …/editor/<project_id>/canvas |
workflow_id | evet | çalıştırılacak iş akışı |
inputs | evet | her girdinin key değeriyle anahtarlanmış bir nesne |
idempotency_key | önerilir | yeniden denemeyi güvenli hale getirir — bkz. Kurallar |
workflow_version_id | hayır | girdileri okuduğunuz sürümü sabitler |
webhook_id | hayır | bu çalışmanın olaylarını kayıtlı tek bir uç noktaya gönderir — bkz. Webhooks |
name | hayır | çalışmanın Studio oturumunun başlığı; API: <name> olarak gösterilir. Tek satır, en fazla 250 karakter. Gönderilmezse iş akışının adı kullanılır |
Her girdi nasıl gönderilir
accepts | Gönder | allow_multiple ile |
|---|---|---|
value | dizenin, sayının veya boolean'ın kendisi | onlardan oluşan bir dizi |
url | dize olarak tek bir herkese açık HTTPS bağlantısı | bağlantılardan oluşan bir dizi |
option | bir options[].id, tam olarak verildiği gibi | kimliklerden oluşan bir dizi |
Yanıt
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"
}
}| Yanıt alanı | Anlamı |
|---|---|
id | çalışmanın kimliği. Onu sorgulayın ve kendi kaydınızda saklayın |
status | kabul edildiğinde queued |
chat_id | çalışmanın gerçekleştiği Studio oturumu. Çalışmayı izlemek veya sorduğu bir soruyu yanıtlamak için açın |
ingested | getirilen her dosya için bir giriş, gönderildiği sırayla. İstediğinizi gönderdiğinizi doğrulamak için kullanışlıdır |
poll_after_seconds | ilk sorgulama öncesi ne kadar bekleneceği |
expires_at | bitmemiş bir çalışmanın expired olarak terk edildiği zaman |
Her bağlantı getirilir ve doğrulanır önce 202'den önce. Kabul edilmiş olarak dönen bir çalışmanın dosyaları elindedir, bu yüzden kötü bir bağlantı on dakika sonra bir başarısızlık yerine hemen bir 400 olur.