#持久对话运行

长时间或高价值的对话不应被进程重启或网络抖动打断。持久对话运行(chat run)把一次对话变成可恢复的服务端资源:创建时即时受理并幂等去重,事件流可断线重放,费用在运行中预估并校正。

#创建

curl --fail-with-body https://rcn.reelway.ai/v1/chat/runs \
  -H "api-key: $REELWAY_API_KEY" \
  -H "Idempotency-Key: order-20261102-001" \
  -d '{
    "model": "qwen3.6-35b-a3b-gguf-iq4xs",
    "messages": [
      {"role": "system", "content": "你是客服工单整理助手。"},
      {"role": "user", "content": "整理这通电话的要点: …"}
    ]
  }'

• 请求体与对话补全同形(messages/model/stream 等)。
• 202 返回 {chatRun},含 id、status 与初始事件序号。
• Idempotency-Key 作用域 chat.runs.create:同键同体重放返回首次响应;同键异体 422(1012)。
• stream 参数在 runs 语义下无意义(事件走 SSE),无需设置。

#事件流

GET /v1/chat/runs/{id}/events/stream

• SSE 帧:id: <seq>、event: <name>、data: <json>;Last-Event-ID 断线重放;15 秒 keep-alive;终态后服务端主动关流。
• 收到 run_status 快照帧时直接跳过(供消费方对账,内容与最新 GET 相同)。
• 终态事件:run_completed / run_failed / run_cancelled。

#事件类型

#查询与取消

• GET /v1/chat/runs 返回 {chatRuns[]},limit 归一上限 20;GET /v1/chat/runs/{id} 返回 {chatRun}。
• cancel 对非可取消态返回 409(1006)——先读状态再决定动作。
• confirm-cost 为 Sogni 兼容保留形状:当前引擎无「费用审批暂停」阶段,任何时刻调用都返回 409(1006)。未来引入费用审批时,该端点按 Sogni 语义激活。详见计费与成本控制。

#状态与生命周期

created → running → run_completed | run_failed | run_cancelled

run_failed 与 run_cancelled 的运行同样保留事件历史,可随时用 Last-Event-ID 回放对账。

#另见

• 对话补全 —— 无状态单次调用
• 生产集成 —— 无服务器模式下的轮询与恢复
• Reelway Intelligence 简介 —— 面向构建者的全景