Meshy-6 API

ПровайдерMeshy

meshy-6 — генерация 3d-объектов-модель от Meshy.

asynctext_to_3d

Попробуйте прямо здесь

Meshy-6 Открыть в песочнице

Что умеет Meshy-6

Async
Text-to-3D

Стоимость

за запрос

per request

106 ₽

Цены указаны в рублях и списываются с баланса проекта за успешные запросы. Надбавки (+) суммируются с базовой ставкой.

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

Vendor

meshy

Modality

object3d

Параметры запроса

Параметры, которые принимает модель. Передаются в теле запроса.

ПараметрТипДиапазон / значенияПо умолчаниюОписание

positivePrompt

string

max: 600

—

Текстовый промпт описывающий желаемый 3D-объект.

1 пример

Примеры

Стилизованный фэнтези-меч с рунами на лезвии и кожаной рукояткой.

inputs.images

array of strings

min: 1 · max: 4

—

Изображения для image-to-3D (UUID / URL / Data URI / Base64). 1..4 шт.

1 пример

Примеры

[
  "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.

1 пример

Примеры

[
  "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-уведомления при готовности.

1 пример

Примеры

https://yourapp.com/webhooks/runware

uploadEndpoint

string

—

—

Presigned URL для автозагрузки готового .glb.

1 пример

Примеры

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

—

Пример кода

meshy-6_example.py

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": "Пример промпта",
    "numberResults": 1,
    "outputType": "URL",
    "outputFormat": "GLB",
    "webhookURL": "https://example.com/...",
    "uploadEndpoint": "value",
    "inputs": {
        "images": [],
        "referenceImages": []
    },
    "settings": {
        "autoSize": False,
        "decimation": 3,
        "hdTexture": False,
        "imageEnhancement": True,
        "meshType": "standard",
        "moderation": False,
        "origin": "bottom",
        "pbr": False,
        "polyCount": 30000,
        "pose": "none",
        "remesh": False,
        "removeLighting": True,
        "symmetry": "auto",
        "texture": True,
        "texturePrompt": "Пример промпта",
        "topology": "triangle"
    }
},
)
print(r.json())

Полная документация модели

Частые вопросы о Meshy-6

Meshy-6 — модель генерации 3D-объектов от meshy. В Ranvik API она доступна через единый интерфейс и помогает создавать модели по текстовому описанию.

Meshy-6 нужна для быстрого создания 3D-активов по промпту: от идеи до готовой модели. Ranvik API упрощает подключение модели к продуктам и сценариям.

API Meshy-6 можно получить в Ranvik API: модель подключается через единый API. Это удобный способ использовать генерацию 3D без отдельных интеграций.

Подключите Meshy-6 через Ranvik API и отправляйте запросы из своего приложения. Сервис позволяет работать с API в России без VPN и лишних сложностей.

Да, в Ranvik API стоимость запросов к Meshy-6 указана в рублях и списывается с баланса проекта после успешного выполнения запроса.

В Ranvik API для Meshy-6 доступны асинхронная обработка и Text-to-3D. Передайте подробный текстовый промпт, чтобы задать желаемый 3D-объект.

Meshy-6 API

Попробуйте прямо здесь

Что умеет Meshy-6

Стоимость

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

Meshy-6 — генерация 3D-объектов через API

Параметры запроса

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

Async (HTTP 202)

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

Пример кода

Частые вопросы о Meshy-6

Могут заинтересовать