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

ПровайдерMeshy

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

asynctext_to_3d

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

Meshy V7.1 (text-to-3D) Открыть в песочнице

Что умеет Meshy V7.1 (text-to-3D)

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 ₽

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

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

Vendor

meshy

Modality

object3d

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

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

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

promptreq

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

—

Пример кода

meshy-v7-1-text_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-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())

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