Канал
Flow
hunyuan3d:flowпо умолчаниюЦена
от $0.213333 per model
GetVibeAPIТема
Язык
3D
Hunyuan3D v2 API — как подключиться и оплачивать
Hunyuan3D v2 (Tencent) — изображение → 3D-меш (.glb).
Сравнение каналов
за 7 дней
| Канал | Цена |
|---|---|
Flow hunyuan3d:flowпо умолчанию | от $0.213333 per model |
Создайте нужный результат
hunyuan3d:flowВвод: ИзображениеДля некоторых режимов необходимо прикрепить: source image, seed for reproducibility, guidance (0–20), steps (1–50), octree resolution (1–1024)
Что такое Hunyuan3D v2
Hunyuan3D v2 (Tencent) — изображение → 3D-меш (.glb).
Кратко о контракте
- Ввод
- image
- Выход
- 3d
- Режим
- асинхронный (задание + опрос)
- Опрос статуса
- каждые 3 с · до 300 с
Преимущества
- Цена: за модель
- Входные данные: изображение
- Один API-ключ для генерации медиа
Где используется
- Игровые ассеты
- Визуализация продуктов
- Объекты дополненной реальности
- Концептуальное моделирование
Контракт API
Генерация выполняется асинхронно: создайте задание, затем опрашивайте его статус до завершения.
- Создать задание
- POST /api/media/generate
- Проверить статус
- GET /api/media/jobs/{jobId}
- Ввод
- 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":"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
Параметры запросов к Hunyuan3D v2 через GetVibe API.
Параметр
image_urlТип
URL
Значения
Public image URL
По умолчанию
—
Цена
—
Параметр
providerТип
option selection
Значения
Flow (default)
По умолчанию
Flow
Цена
Included in the base price
Параметр
textured_meshТип
yes/no
Значения
Yes · No (default)
По умолчанию
Нет
Цена
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
| Параметр | Тип | Значения | По умолчанию | Цена |
|---|---|---|---|---|
image_url | URL | Public image URL | — | — |
provider | option selection | Flow (default) | Flow | Included in the base price |
textured_mesh | yes/no | Yes · No (default) | Нет | 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 |
Запрос: POST https://getvibeapi.com/api/media/generate. Цены указаны в USD.
Цена Hunyuan3D v2
Стоимость Hunyuan3D v2: от $0.213333 per model. Цена рассчитывается динамически по текущему обменному курсу, а итоговая сумма списания указывается в ответе API (priceRub). Оплата в USD, без подписок.
Сколько стоит запрос по умолчанию
Если параметры не переданы, используются следующие значения: With texture — No. Стоимость такого запроса — $0.213333.
Каналы и цены для каждой комбинации параметров
Для каждого канала указана цена каждой комбинации параметров. Именно эта сумма списывается за успешную генерацию и совпадает со значением в расположенной ниже машиночитаемой таблице.
Flowhunyuan3d:flowот $0.213333точные цены
| С текстурой | Нет | Да |
|---|---|---|
| Flow | $0.213333 | $0.64 |
Все комбинации в формате JSON: /api/media/price-table?model=hunyuan3d%3Aflow
README
Машиночитаемый контракт для Hunyuan3D v2 содержит схему запроса, операции, ограничения, примеры опроса и ответов.
# Hunyuan3D v2
Публичная модель: hunyuan3d:flow
Создать задание: POST /api/media/generate
Проверить статус: GET /api/media/jobs/{jobId}
## Входные параметры
- `image_url` (URL): Public image URL; по умолчанию: —
- `provider` (option selection): Flow (default); по умолчанию: Flow
- `textured_mesh` (yes/no): Yes · No (default); по умолчанию: No
- `seed` (text / number): any value; по умолчанию: —
- `guidance_scale` (text / number): any value; по умолчанию: —
- `num_inference_steps` (text / number): any value; по умолчанию: —
- `octree_resolution` (text / number): any value; по умолчанию: —
- `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; по умолчанию: —
## Публичные варианты
- `hunyuan3d:flow`: FlowЧасто задаваемые вопросы об API Hunyuan3D v2
Сколько стоит Hunyuan3D v2?
Цена Hunyuan3D v2: от $0.213333 per model. Цена рассчитывается динамически по текущему обменному курсу.
Совместим ли он с OpenAI SDK?
Да, API полностью совместим с OpenAI. Просто измените base_url на https://getvibeapi.com/v1 и укажите свой ключ — остальной код останется без изменений.
Подключите Hunyuan3D v2 прямо сейчас
Регистрация занимает минуту, оплата по мере использования, готовый код уже выше.
Получить API-ключ