Channel
Flow
hunyuan3d:flowdefaultPrice
from $0.213333 per model
GetVibeAPITheme
Language
3D
Hunyuan3D v2 API — how to connect and pay
Hunyuan3D v2 (Tencent) — image → 3D mesh (.glb).
Channel comparison
last 7 days
| Channel | Price |
|---|---|
Flow hunyuan3d:flowdefault | from $0.213333 per model |
Build the result you need
hunyuan3d:flowInput: ImageSome modes require you to attach: source image, seed for reproducibility, guidance (0–20), steps (1–50), octree resolution (1–1024)
What is Hunyuan3D v2
Hunyuan3D v2 (Tencent) — image → 3D mesh (.glb).
Contract at a glance
- Input
- image
- Output
- 3d
- Mode
- async (job + polling)
- Status polling
- every 3 s · up to 300 s
Strengths
- Pricing: per model
- Inputs: image
- One API key for media generation
Where it is used
- Game assets
- Product visualization
- AR objects
- Concept modeling
API contract
Generation runs asynchronously: create a job, then poll its status until completion.
- Create job
- POST /api/media/generate
- Check status
- GET /api/media/jobs/{jobId}
- Input
- image
- Output
- 3d
- Polling
- every 3 s · up to 300 s
- Authentication
- Authorization: Bearer sk-pv-…
Example request
Pass your key in the Bearer header. The API returns jobId for polling the status.
curl -sS https://getvibeapi.com/api/media/generate \
-H "Authorization: Bearer $GETVIBE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary '{"model":"hunyuan3d:flow","opts":{"image_url":"https://example.com/image_url.png","textured_mesh":false}}'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": "hunyuan3d:flow",
"opts": {
"image_url": "https://example.com/image_url.png",
"textured_mesh": false
}
}),
});
if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);API request parameters
Parameters for requests to Hunyuan3D v2 via the GetVibe API.
Parameter
image_urlType
URL
Values
Public image URL
Default
—
Price
—
Parameter
providerType
option selection
Values
Flow (default)
Default
Flow
Price
Included in the base price
Parameter
textured_meshType
yes/no
Values
Yes · No (default)
Default
No
Price
Yes: $0.64, No: $0.213333
Parameter
seedType
text / number
Values
any value
Default
—
Price
Included in the base price
Parameter
guidance_scaleType
text / number
Values
any value
Default
—
Price
Included in the base price
Parameter
num_inference_stepsType
text / number
Values
any value
Default
—
Price
Included in the base price
Parameter
octree_resolutionType
text / number
Values
any value
Default
—
Price
Included in the base price
Parameter
image_file_idType
text
Values
Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…)
Default
—
Price
Included in the base price
Parameter
image_base64Type
text
Values
Alternative to image_url: the file inline, as base64 or a data: URI
Default
—
Price
Included in the base price
| Parameter | Type | Values | Default | Price |
|---|---|---|---|---|
image_url | URL | Public image URL | — | — |
provider | option selection | Flow (default) | Flow | Included in the base price |
textured_mesh | yes/no | Yes · No (default) | No | Yes: $0.64, No: $0.213333 |
seed | text / number | any value | — | Included in the base price |
guidance_scale | text / number | any value | — | Included in the base price |
num_inference_steps | text / number | any value | — | Included in the base price |
octree_resolution | text / number | any value | — | 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 |
Request: POST https://getvibeapi.com/api/media/generate. Prices in USD.
Price of Hunyuan3D v2
The cost of Hunyuan3D v2: from $0.213333 per model. The price is calculated dynamically at the current exchange rate, and the final charge is shown in the API response (priceRub). Payment in USD, no subscriptions.
What a default request costs
With no parameters sent, the request uses these values: With texture — No. That request costs $0.213333.
Channels and prices for every parameter combination
For every channel, the price of every parameter combination. It is exactly the amount a successful generation is charged, and the same figure as in the machine-readable table linked below.
Flowhunyuan3d:flowfrom $0.213333exact prices
| With texture | No | Yes |
|---|---|---|
| Flow | $0.213333 | $0.64 |
Every combination as JSON: /api/media/price-table?model=hunyuan3d%3Aflow
README
The machine-readable contract for Hunyuan3D v2 contains the request schema, operations, limits, polling and response examples.
# Hunyuan3D v2
Public model: hunyuan3d:flow
Create job: POST /api/media/generate
Check status: GET /api/media/jobs/{jobId}
## Input parameters
- `image_url` (URL): Public image URL; default: —
- `provider` (option selection): Flow (default); default: Flow
- `textured_mesh` (yes/no): Yes · No (default); default: No
- `seed` (text / number): any value; default: —
- `guidance_scale` (text / number): any value; default: —
- `num_inference_steps` (text / number): any value; default: —
- `octree_resolution` (text / number): any value; default: —
- `image_file_id` (text): Alternative to image_url: the id of your own file from POST /v1/files (file-pv-…); default: —
- `image_base64` (text): Alternative to image_url: the file inline, as base64 or a data: URI; default: —
## Public variants
- `hunyuan3d:flow`: FlowFAQ about the Hunyuan3D v2 API
How much does Hunyuan3D v2 cost?
The price of Hunyuan3D v2: from $0.213333 per model. The price is calculated dynamically at the current exchange rate.
Is it compatible with the OpenAI SDK?
Yes, the API is fully OpenAI-compatible. Just change base_url to https://getvibeapi.com/v1 and set your key — the rest of the code stays the same.