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-runsGerektirir runs:write.
İ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",
"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ışı |
girdiler | evet | her girdinin anahtarıyla anahtarlanmış bir nesne anahtar |
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 |
Her girdi nasıl gönderilir
kabul eder | Gönder | ile allow_multiple |
|---|---|---|
değer | 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 |
seçenek | bir options[].id, tam olarak verildiği gibi | kimliklerden oluşan bir dizi |
Yanıt
202 Kabul Edildi
{
"run": {
"id": "0192f3d0-6c31-7a52-b4e8-3f9d1a7c5e20",
"status": "kuyrukta",
"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 |
durum | kuyrukta kabul üzerine |
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 |
alınan | 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ışma olarak terk edildiğinde süresi dolmuş |
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.