运行
一次 run 是单个生成请求。当你调用 API 时，Runbase 会创建一个 run，将其发送到底层 AI 模型，并在结果准备好后返回。
每个 run 都会经历一个生命周期：
POST /api/v1/runs → pending → processing → succeeded (or failed)
Run 状态
| 状态 | 含义 |
|---|---|
pending | 已排队，等待 worker 处理 |
processing | 正在 AI 提供商处生成 |
succeeded | 生成完成 — output.urls 包含结果 |
failed | 生成失败 — error 描述出错原因 |
设计为异步
所有生成都是异步的。当你创建一个 run 时，API 会立即返回 status: "pending" 和一个 run ID。然后你轮询 GET /api/v1/runs/:id，直到状态变为 succeeded 或 failed。
周转时间取决于模型、提供商负载和输入复杂度：
- 图像模型 通常比视频模型完成得更快
- 视频模型 很大程度上取决于时长、分辨率和提供商队列等待时间
费用和退款
费用会在 run 创建时 从你的余额中扣除，而不是在完成时扣除。这会提前预留资金。
如果 run 失败，全部费用会自动退款到你的余额中。你不会为失败的生成付费。
模型
Runbase 是一个统一的网关，可连接来自多个提供商的模型。每个模型都有一个唯一 ID，格式为 provider/model-name（例如，openai/gpt-image-2、bytedance/seedance-2）。
所有模型都共享同一个双端点 API：
POST /api/v1/runs— 使用模型 ID 和输入创建一个 runGET /api/v1/runs/:id— 检查状态并获取结果
输入 schema 因模型而异（prompt、size、quality、image_urls 等参数不同），但请求/响应包装始终相同。
身份验证
每个 API 请求都需要在 Authorization header 中携带 API key，作为 Bearer token。密钥以 sk- 开头，可在 dashboard 中创建。详见 Authentication。
余额
Runbase 使用预付余额。你先为余额充值，然后每次 run 会根据模型定价从中扣除。详见 Billing。