API 目录

用账号密钥远程跑已固化的工作流。接口基址 https://flow.dianwu.ai；网站是 dianwu.ai；密钥前缀 dwflow_。

1. 准备密钥

登录后打开 API 密钥，生成一把密钥（只显示一次）。
在「工作流」里固化流程，记下工作流 ID（卡片上的 /api/v1/workflows/…/run）。

登录后可在此看到你的工作流 ID 列表。

2. 鉴权

所有业务 API 使用 Header：

Authorization: Bearer dwflow_你的密钥

3. 列出工作流

GET https://flow.dianwu.ai/api/workflows

curl "https://flow.dianwu.ai/api/workflows" \
  -H "Authorization: Bearer dwflow_xxx"

4. 远程运行某个工作流

POST https://flow.dianwu.ai/api/v1/workflows/你的工作流ID/run

Body 传表格列与行（JSON）。会按固化版式输出，并默认返回 Excel base64。

若工作流带运行参数或文件输入，请打开该工作流的运行页，在「远程 API 调用」里查看专属示例（参数与当前页面一致）。

curl -X POST "https://flow.dianwu.ai/api/v1/workflows/你的工作流ID/run" \
  -H "Authorization: Bearer dwflow_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "fileName": "orders.xlsx",
    "sheetName": "Sheet1",
    "columns": ["客户", "金额"],
    "rows": [
      {"客户": "甲", "金额": 1200},
      {"客户": "乙", "金额": 800}
    ],
    "excel": true
  }'

成功响应字段：

layout — 套用后的版式
preview — 预览行数、分组与合计
excelBase64 — xlsx 文件（可自行解码保存）
quota — 本月转换额度用量

5. 保存 Excel（Node 示例）

import fs from "fs";

const res = await fetch("https://flow.dianwu.ai/api/v1/workflows/你的工作流ID/run", {
  method: "POST",
  headers: {
    Authorization: "Bearer dwflow_xxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    columns: ["客户", "金额"],
    rows: [{ 客户: "甲", 金额: 1200 }],
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);
fs.writeFileSync(data.excelFileName, Buffer.from(data.excelBase64, "base64"));

6. 模型接口（按量 USD）

部分模型池模型可通过 OpenAI 兼容接口调用，按官网刊例折算 USD 后乘以充值档倍率扣余额。默认开放 DeepSeek 官网：deepseek-chat / deepseek-reasoner / deepseek-v4-flash / deepseek-v4-pro。

倍率：默认 ×1.5 · 累计充值满 $1,000（约 ¥7,200）→ ×1.3 · 满 $5,000（约 ¥3.6万）→ ×1.1。刊例 CNY 按实时中间价折算 USD（含约 1% 缓冲），可在 GET https://flow.dianwu.ai/api/v1/models 查看当前汇率。余额不足返回 402。请先在我的后台充值 USD。

GET https://flow.dianwu.ai/api/v1/models

curl "https://flow.dianwu.ai/api/v1/models" \
  -H "Authorization: Bearer dwflow_xxx"

POST https://flow.dianwu.ai/api/v1/chat/completions

curl -X POST "https://flow.dianwu.ai/api/v1/chat/completions" \
  -H "Authorization: Bearer dwflow_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role":"user","content":"你好"}]
  }'

成功响应额外含 billing（本次 USD 费用与余额）。

流式：设 "stream": true，响应为 OpenAI 兼容 SSE（text/event-stream）。流结束后按 usage 扣费（需上游返回 usage，或按输出长度粗估）。

curl -N -X POST "https://flow.dianwu.ai/api/v1/chat/completions" \
  -H "Authorization: Bearer dwflow_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "stream": true,
    "messages": [{"role":"user","content":"你好"}]
  }'

7. 错误码

401 — 未登录或密钥无效
402 — 月转换额度用尽，或模型余额不足
403 — 模型未开放接口调用
422 — 上传列与工作流不匹配（缺列）
404 — 工作流不存在或不属于该账号