Параметр
image_urlТип
URL
Значения
Public image URL
Цена
—
GetVibeAPIТема
Язык
3D
Hunyuan3D-2 API — как подключиться и оплачивать
Hunyuan3D-2 (Canvas): ориентировочная цена за время работы GPU; генерация временно недоступна.
Создайте нужный результат
hunyuan3d-2В каталоге для этой модели указана только минимальная цена.
Ввод: ИзображениеДля некоторых режимов необходимо прикрепить: source image
Что такое Hunyuan3D-2
Hunyuan3D-2 (Canvas): ориентировочная цена за время работы GPU; генерация временно недоступна.
Кратко о контракте
- Ввод
- 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-2","opts":{"image_url":"https://example.com/image_url.png"}}'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-2",
"opts": {
"image_url": "https://example.com/image_url.png"
}
}),
});
if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);Параметры запроса API
Параметры запросов к Hunyuan3D-2 через GetVibe API.
Параметр
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 | — |
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-2
Цена Hunyuan3D-2 уточняется: провайдер ещё не опубликовал первоначально подтверждённую цену для этого контракта. Генерация будет доступна после подтверждения цены.
README
Машиночитаемый контракт для Hunyuan3D-2 содержит схему запроса, операции, ограничения, примеры опроса и ответов.
# Hunyuan3D-2
Публичная модель: hunyuan3d-2
Создать задание: POST /api/media/generate
Проверить статус: GET /api/media/jobs/{jobId}
## Входные параметры
- `image_url` (URL): Public image URL; по умолчанию: —
- `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-2`: по умолчаниюЧасто задаваемые вопросы об API Hunyuan3D-2
Сколько стоит Hunyuan3D-2?
Цена Hunyuan3D-2: от $16.00 per model. Цена рассчитывается динамически по текущему обменному курсу.
Совместим ли он с OpenAI SDK?
Да, API полностью совместим с OpenAI. Просто измените base_url на https://getvibeapi.com/v1 и укажите свой ключ — остальной код останется без изменений.
Подключите Hunyuan3D-2 прямо сейчас
Регистрация занимает минуту, оплата по мере использования, готовый код уже выше.
Получить API-ключ