渠道
Flow
rodin:flow默认价格
$0.133333 起 per model
GetVibeAPI主题
语言
3D
Rodin v2.5 API — 如何接入并付费
Rodin（Hyper3D）v2.5 — 复杂角色，高细节。输出 .glb/.usdz/.fbx/.obj/.stl。最多 5 张图像。
渠道对比
最近 7 天
| 渠道 | 价格 |
|---|---|
Flow rodin:flow默认 | $0.133333 起 per model |
组合你需要的输出结果
rodin:flow输入： 文本, 图像某些模式需要附加： source image
什么是 Rodin v2.5
Rodin（Hyper3D）v2.5 — 复杂角色，高细节。输出 .glb/.usdz/.fbx/.obj/.stl。最多 5 张图像。
契约概览
- 输入
- text, image
- 输出
- 3d
- 模式
- 异步（任务 + 轮询）
- 状态轮询
- 每 3 秒 · 最多 300 秒
优势
- 定价：按模型计费
- 输入：文本、图像
- 2 个可配置选项
- 用于媒体生成的单一 API 密钥
应用场景
- 游戏资产
- 产品可视化
- AR 对象
- 概念建模
API 契约
生成是异步的：先创建任务，然后轮询状态直至完成。
- 创建任务
- POST /api/media/generate
- 检查状态
- GET /api/media/jobs/{jobId}
- 输入
- text, image
- 输出
- 3d
- 轮询
- 每 3 秒 · 最多 300 秒
- 鉴权
- Authorization: Bearer sk-pv-…
请求示例
在 Bearer 请求头中传递密钥。API 会返回 jobId 用于轮询状态。
curl -sS https://getvibeapi.com/api/media/generate \
-H "Authorization: Bearer $GETVIBE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary '{"model":"rodin:flow","opts":{"mode":"image-to-3d","quality":"standard","image_url":"https://example.com/image_url.png","format":"glb","material":"PBR","tier":"Gen-2.5-High"}}'JavaScript
const response = await fetch('https://getvibeapi.com/api/media/generate', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.GETVIBE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "rodin:flow",
"opts": {
"mode": "image-to-3d",
"quality": "standard",
"image_url": "https://example.com/image_url.png",
"format": "glb",
"material": "PBR",
"tier": "Gen-2.5-High"
}
}),
});
if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);API 请求参数
通过 GetVibe API 向 Rodin v2.5 发起请求的参数。
参数
prompt必填类型
text
取值
text description
默认值
required
价格
—
参数
image_url类型
URL
取值
Public image URL
默认值
—
价格
—
参数
provider类型
option selection
取值
Flow (default)
默认值
Flow
价格
Included in the base price
参数
mode类型
option selection
取值
From image (default) · From text
默认值
From image
价格
Included in the base price
参数
endpoint_speed类型
option selection
取值
Fast (/fast) · Standard (default)
默认值
Standard
价格
Fast (/fast): $0.133333, Standard: $0.533333
参数
tier类型
option selection
取值
Extreme-Low (Fast, default) · High (Standard, default) (default) · Extreme-High (2× Standard)
默认值
高（标准，默认）
价格
Extreme-Low (Fast, default): $0.133333, High (Standard, default): $0.533333, Extreme-High (2× Standard): $1.066667
参数
format类型
option selection
取值
.glb (default) · .usdz · .fbx · .obj · .stl
默认值
.glb
价格
Included in the base price
参数
material类型
option selection
取值
PBR (default) · Shaded · PBR + Shaded · No textures
默认值
PBR
价格
Included in the base price
参数
quality必填类型
option selection
取值
fast
默认值
required
价格
Included in the base price
参数
input_urls类型
Array<URLs>, 0–5 items
取值
Public HTTP(S) URLs
默认值
—
价格
Included in the base price
参数
image_file_id类型
text
取值
Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…)
默认值
—
价格
Included in the base price
参数
image_base64类型
text
取值
Alternative to image_url: the file inline, as base64 or a data: URI
默认值
—
价格
Included in the base price
参数
input_file_ids类型
Array<strings>
取值
List of values
默认值
—
价格
Included in the base price
参数
input_base64类型
Array<strings>
取值
List of values
默认值
—
价格
Included in the base price
| 参数 | 类型 | 取值 | 默认值 | 价格 |
|---|---|---|---|---|
prompt必填 | text | text description | required | — |
image_url | URL | Public image URL | — | — |
provider | option selection | Flow (default) | Flow | Included in the base price |
mode | option selection | From image (default) · From text | From image | Included in the base price |
endpoint_speed | option selection | Fast (/fast) · Standard (default) | Standard | Fast (/fast): $0.133333, Standard: $0.533333 |
tier | option selection | Extreme-Low (Fast, default) · High (Standard, default) (default) · Extreme-High (2× Standard) | 高（标准，默认） | Extreme-Low (Fast, default): $0.133333, High (Standard, default): $0.533333, Extreme-High (2× Standard): $1.066667 |
format | option selection | .glb (default) · .usdz · .fbx · .obj · .stl | .glb | Included in the base price |
material | option selection | PBR (default) · Shaded · PBR + Shaded · No textures | PBR | Included in the base price |
quality必填 | option selection | fast | required | Included in the base price |
input_urls | Array<URLs>, 0–5 items | Public HTTP(S) URLs | — | Included in the base price |
image_file_id | text | Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…) | — | Included in the base price |
image_base64 | text | Alternative to image_url: the file inline, as base64 or a data: URI | — | Included in the base price |
input_file_ids | Array<strings> | List of values | — | Included in the base price |
input_base64 | Array<strings> | List of values | — | Included in the base price |
请求：POST https://getvibeapi.com/api/media/generate。价格以 USD 计。
Rodin v2.5 的价格
Rodin v2.5 的费用：从 $0.533333 per model。价格按当前汇率动态计算，最终扣费见 API 响应（priceRub）。以 USD 支付，无订阅。
默认请求的实际费用
若不传参数，请求将使用这些取值：Version and quality — High (Standard, default), Generation route — Standard, Mode — From image, Format — .glb。 该请求的费用为 $0.533333。
各渠道及所有参数组合的价格
每个渠道的每种参数组合价格。这正是成功生成时扣除的金额，与下方链接的机器可读价格表一致。
Flowrodin:flow$0.133333 起精确价格
| 生成路由 \ 网格细节（Rodin 层级） | 极低（快速，默认） | 高（标准，默认） | 极高（2×标准） |
|---|---|---|---|
| Fast (/fast) | $0.133333 | — | — |
| Standard | — | $0.533333 | $1.066667 |
所有组合（JSON）： /api/media/price-table?model=rodin%3Aflow
README
Rodin v2.5 的机器可读契约包含请求 schema、操作、限制、轮询和响应示例。
# Rodin v2.5
公开模型：rodin:flow
创建任务: POST /api/media/generate
检查状态: GET /api/media/jobs/{jobId}
## 输入参数
- `prompt` (text): text description; 默认: required
- `image_url` (URL): Public image URL; 默认: —
- `provider` (option selection): Flow (default); 默认: Flow
- `mode` (option selection): From image (default) · From text; 默认: From image
- `endpoint_speed` (option selection): Fast (/fast) · Standard (default); 默认: Standard
- `tier` (option selection): Extreme-Low (Fast, default) · High (Standard, default) (default) · Extreme-High (2× Standard); 默认: High (Standard, default)
- `format` (option selection): .glb (default) · .usdz · .fbx · .obj · .stl; 默认: .glb
- `material` (option selection): PBR (default) · Shaded · PBR + Shaded · No textures; 默认: PBR
- `quality` (option selection): fast; 默认: required
- `input_urls` (Array<URLs>, 0–5 items): Public HTTP(S) URLs; 默认: —
- `image_file_id` (text): Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…); 默认: —
- `image_base64` (text): Alternative to image_url: the file inline, as base64 or a data: URI; 默认: —
- `input_file_ids` (Array<strings>): List of values; 默认: —
- `input_base64` (Array<strings>): List of values; 默认: —
## 公开变体
- `rodin:flow`: Flow关于 Rodin v2.5 API 的常见问题
Rodin v2.5 的价格是多少？
Rodin v2.5 的价格：从 $0.533333 per model。价格按当前汇率动态计算。
是否兼容 OpenAI SDK？
是的，API 完全兼容 OpenAI。只需将 base_url 改为 https://getvibeapi.com/v1 并设置密钥——其余代码不变。