模型 - Runbase Docs

Runbase 通过单一 API 提供来自多个提供商的顶级图像和视频生成模型访问。

浏览模型

访问模型页面查看所有可用模型及其定价、功能和示例输出。每个模型都有专门的详情页，其中包括：

Playground — 在编写任何代码之前，先在浏览器中测试模型
定价 — 按次或按秒计费
示例 — 带提示词的示例输出
API 参考 — 模型特定的输入参数和代码示例

Playground

每个模型页面顶部都包含一个交互式 Playground。登录后，输入提示词，然后点击 Run model，即可在几秒内看到结果。这是在将模型集成到你的应用之前评估其质量和速度的最快方式。

模型 ID 格式

每个模型都有一个格式为 provider/model-name 的 ID，例如：

openai/gpt-image-2 — 图像生成
bytedance/seedance-2 — 视频生成
google/veo-3 — 视频生成

可用模型及其 ID 的完整列表在模型页面。模型会定期添加——请在那里查看最新信息。

输入参数

每个模型都定义了自己的输入 schema。常见参数包括：

prompt (string) — 要生成内容的文本描述
aspect_ratio (string) — 输出尺寸，例如 "1:1"、"16:9"
quality (string) — 生成质量等级
image_urls (string[]) — 参考图像的 URL（在支持的情况下）

请参阅每个模型的详情页，了解完整的输入 schema 和可用选项。

使用模型

将模型 ID 和输入对象传递给创建 run 端点：

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedream-5-lite",
    "input": {
      "prompt": "A mountain landscape at sunset, oil painting"
    }
  }'

如果你传入无效的模型 ID，你会收到 400 model_not_found 错误。如果输入不符合该模型的 schema，你会收到 400 invalid_input，其中会说明问题所在。

图像模型与视频模型

图像模型 会在 output.urls 中返回一个或多个图像 URL。生成时间因模型、提供商负载和输入复杂度而异。
视频模型 会在 output.urls 中返回一个视频 URL。生成时间因模型、时长、分辨率和提供商负载而异。

两者的 API 形态是相同的——唯一的区别在于输出 URL 指向的内容。