Генерация 3D-объектов · meshy

Meshy-6

meshy-6

Meshy-6 — генерация 3d-объектов от meshy, доступная через единый Ranvik API. Поддерживаемые возможности: async, text_to_3d.

от 224 ₽ / запрос

Карточка модели

Технические характеристики

МодальностьГенерация 3D-объектов

Провайдерmeshy

СтатусАктивна

ID для запросовmeshy-6

Возможности

Async
Text-to-3D

Цены

Единица	Цена
за запрос · per request	224 ₽

Цены указаны в рублях. Списываются с баланса проекта при каждом успешном запросе.

Поддерживаемые параметры

Параметры передаются вендору как есть (pure proxy) — мы не валидируем их у себя на стороне. Если вендор не примет — вернётся его ошибка.

Параметр	Тип	Диапазон / values	Default	Описание
`positivePrompt`	string	max: 600	—	Текстовый промпт описывающий желаемый 3D-объект. примеры значений Примеры Стилизованный фэнтези-меч с рунами на лезвии и кожаной рукояткой.
`inputs.images`	array of strings	min: 1 · max: 4	—	Изображения для image-to-3D (UUID / URL / Data URI / Base64). 1..4 шт. примеры значений Примеры [ "https://example.com/front.png", "https://example.com/back.png" ]
`inputs.referenceImages`	array of strings	min: 1 · max: 1	—	Reference-изображение для texture guidance. Только 1 шт. Несовместимо с settings.texturePrompt. примеры значений Примеры [ "https://example.com/texture-ref.jpg" ]
`settings.autoSize`	boolean	—	false	AI-оценка real-world высоты объекта. Требуется для settings.origin.
`settings.decimation`	integer	min: 1 · max: 4	—	Уровни polycount (1 = Ultra, 4 = Low). Несовместимо с polyCount. Требует remesh=true.
`settings.hdTexture`	boolean	—	false	4K base texture (4096×4096) вместо стандартного разрешения.
`settings.imageEnhancement`	boolean	—	true	Оптимизация входных изображений. ТРЕБУЕТ inputs.images.
`settings.meshType`	enum	standard, lowpoly	standard	Тип меша: standard или lowpoly.
`settings.moderation`	boolean	—	false	Включить content screening.
`settings.origin`	enum	bottom, center	bottom	Точка origin модели. ТРЕБУЕТ settings.autoSize=true.
`settings.pbr`	boolean	—	false	Генерировать PBR maps (metallic, roughness, normal, emission). ТРЕБУЕТ settings.texture=true.
`settings.polyCount`	integer	min: 100 · max: 300000	30000	Целевое количество полигонов (100..300000). Несовместимо с settings.decimation. Требует remesh=true.
`settings.pose`	enum	none, a-pose, t-pose	none	Поза для персонажа: none / a-pose / t-pose.
`settings.remesh`	boolean	—	false	Включить remesh-фазу. Требуется для topology / polyCount / decimation.
`settings.removeLighting`	boolean	—	true	Удалить highlights и shadows с текстуры.
`settings.symmetry`	enum	off, auto, on	auto	Поведение симметрии модели.
`settings.texture`	boolean	—	true	Генерировать ли текстуры. Требуется для pbr.
`settings.texturePrompt`	string	max: 600	—	Промпт для guidance текстуры (отдельно от positivePrompt). Несовместим с inputs.referenceImages.
`settings.topology`	enum	triangle, quad	triangle	Топология меша: triangle (универсально) или quad (для DCC-пайплайнов). Требует remesh=true.
`numberResults`	integer	min: 1 · max: 4	1	Сколько вариаций сгенерировать.
`outputType`	enum	URL, base64Data, dataURI	URL	Формат доставки.
`outputFormat`	enum	GLB	GLB	Формат 3D-файла. Поддерживается только GLB (Binary glTF — geometry + textures + materials).
`webhookURL`	string	—	—	URL для POST-уведомления при готовности. примеры значений Примеры https://yourapp.com/webhooks/runware
`uploadEndpoint`	string	—	—	Presigned URL для автозагрузки готового .glb. примеры значений Примеры https://bucket.s3.amazonaws.com/result.glb?X-Amz-Signature=...

Параметры ответа

Что возвращает API. У медиа-моделей формат зависит от режима: sync — сразу результат, async — task_id для опроса через GET /v1/tasks/{id}. Эта модель работает только в async-режиме.

Async (HTTP 202)

HTTP 202. 3D-генерация всегда async (несколько минут).

Поле	Тип	Значения
`id`	string	—
`object`	string	object3d.task
`status`	enum	queued, processing, completed, failed
`model`	string	—
`created`	integer	—

Опрос статуса (GET /v1/tasks/{id})

GET /v1/tasks/{id}.

Поле	Тип	Значения	Описание
`id`	string	—
`status`	enum	queued, processing, completed, failed, canceled
`modality`	string	object3d
`model`	string	—
`data`	array	—	Каждый элемент: `url`— string · CDN URL .glb (binary glTF — geometry + textures + PBR materials).
`error`	string	—

Пример запроса

import requests, json

r = requests.post(
    "https://api.ranvik.ru/v1/object3d/generations",
    headers={"Authorization": "Bearer rk_live_...", "Content-Type": "application/json"},
    json={
    "model": "meshy-6",
    "positivePrompt": "Пример промпта",
    "inputs.images": [],
    "inputs.referenceImages": [],
    "settings.autoSize": False,
    "settings.decimation": 3,
    "settings.hdTexture": False,
    "settings.imageEnhancement": True,
    "settings.meshType": "standard",
    "settings.moderation": False,
    "settings.origin": "bottom",
    "settings.pbr": False,
    "settings.polyCount": 30000,
    "settings.pose": "none",
    "settings.remesh": False,
    "settings.removeLighting": True,
    "settings.symmetry": "auto",
    "settings.texture": True,
    "settings.texturePrompt": "Пример промпта",
    "settings.topology": "triangle",
    "numberResults": 1,
    "outputType": "URL",
    "outputFormat": "GLB",
    "webhookURL": "https://example.com/...",
    "uploadEndpoint": "value"
},
)
print(r.json())

Замените rk_live_... на ваш ключ из кабинета.