Meshy V7.1 (text-to-3D)

meshy-v7-1-text

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

от 128 ₽ / запрос

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

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

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

Провайдерmeshy

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

ID для запросовmeshy-v7-1-text

Возможности

Async
Text-to-3D

Цены

Единица	Цена
за запрос · preview / standard / rig=0 / anim=0	128 ₽
за запрос · preview / standard / rig=1 / anim=0	160 ₽
за запрос · preview / 2k / rig=0 / anim=0	160 ₽
за запрос · preview / standard / rig=1 / anim=1	179 ₽
за запрос · full / standard / rig=0 / anim=0	192 ₽
за запрос · preview / 2k / rig=1 / anim=0	192 ₽
за запрос · preview / 4k / rig=0 / anim=0	192 ₽
за запрос · preview / 2k / rig=1 / anim=1	211 ₽
за запрос · full / standard / rig=1 / anim=0	223 ₽
за запрос · full / 2k / rig=0 / anim=0	223 ₽
за запрос · preview / 4k / rig=1 / anim=0	223 ₽
за запрос · full / standard / rig=1 / anim=1	243 ₽
за запрос · preview / 4k / rig=1 / anim=1	243 ₽
за запрос · full / 2k / rig=1 / anim=0	255 ₽
за запрос · full / 4k / rig=0 / anim=0	255 ₽
за запрос · full / 2k / rig=1 / anim=1	275 ₽
за запрос · full / 4k / rig=1 / anim=0	287 ₽
за запрос · Maximum safe reserve	306 ₽
за запрос · full / 4k / rig=1 / anim=1	306 ₽

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

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

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

Параметр	Тип	Диапазон / values	Default	Описание
`prompt`required	string	min: 1 · max: 600	—	Описание 3D-объекта.
`mode`	enum	preview, full	full	—
`model_type`	enum	standard, lowpoly, smart-topology	standard	—
`topology`	enum	triangle, quad	triangle	—
`target_polycount`	integer	min: 100 · max: 300000	30000	Для smart-topology максимум 15000.
`should_remesh`	boolean	—	true	—
`symmetry_mode`	enum	off, auto, on	auto	—
`enable_pbr`	boolean	—	false	—
`pose_mode`	enum	a-pose, t-pose	—	Не указывайте для негуманоидных объектов.
`texture_prompt`	string	max: 600	—	—
`texture_image`	string	—	—	URL необязательного референса текстуры.
`geometry_resolution`	enum	standard, 2k, 4k	standard	2k/4k доступны только для standard model_type и оплачиваются дополнительно.
`enable_rigging`	boolean	—	false	Платная опция.
`rigging_height_meters`	number	min: 0.01	—	—
`enable_animation`	boolean	—	false	Требует enable_rigging=true; оплачивается дополнительно.
`animation_action_id`	integer	min: 0 · max: 696	—	—
`seed`	integer	—	—	—

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

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

Async (HTTP 202)

HTTP 202: сохраните task id для опроса.

Поле	Тип	Значения	Описание
`id`	string	—
`status`	string	—

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

GET /v1/tasks/{id}: статус и URL результата.

Поле	Тип	Значения	Описание
`status`	string	—
`data`	array	—	Каждый элемент: `url`— string
`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-v7-1-text",
    "prompt": "Пример промпта",
    "mode": "full",
    "model_type": "standard",
    "topology": "triangle",
    "target_polycount": 30000,
    "should_remesh": True,
    "symmetry_mode": "auto",
    "enable_pbr": False,
    "pose_mode": "a-pose",
    "texture_prompt": "Пример промпта",
    "texture_image": "Пример промпта",
    "geometry_resolution": "standard",
    "enable_rigging": False,
    "rigging_height_meters": 0.01,
    "enable_animation": False,
    "animation_action_id": 348,
    "seed": 1
},
)
print(r.json())

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