Meshy V7.1 (multi-image-to-3D) API

ПровайдерMeshy

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

asyncimage_to_3d

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

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

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

Async
Image-to-3D

Стоимость

за запрос

untextured / standard / rig=0 / anim=0

128 ₽

untextured / standard / rig=1 / anim=0

160 ₽

untextured / 2k / rig=0 / anim=0

160 ₽

untextured / standard / rig=1 / anim=1

179 ₽

textured / standard / rig=0 / anim=0

192 ₽

untextured / 2k / rig=1 / anim=0

192 ₽

untextured / 2k / rig=1 / anim=1

211 ₽

textured / standard / rig=1 / anim=0

223 ₽

textured / 2k / rig=0 / anim=0

223 ₽

textured / standard / rig=1 / anim=1

243 ₽

textured / 2k / rig=1 / anim=0

255 ₽

Maximum safe reserve

275 ₽

textured / 2k / rig=1 / anim=1

275 ₽

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

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

Vendor

meshy

Modality

object3d

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

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

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

imagesreq

array of strings

min: 2 · max: 4

—

Публичные URL 2–4 ракурсов одного объекта.

topology

enum

triangle, quad

triangle

target_polycount

integer

min: 100 · max: 300000

30000

should_remesh

boolean

—

true

should_texture

boolean

—

true

symmetry_mode

enum

off, auto, on

auto

geometry_resolution

enum

standard, 2k

standard

enable_pbr

boolean

—

false

pose_mode

enum

a-pose, t-pose

—

Не указывайте для негуманоидных объектов.

texture_prompt

string

max: 600

—

texture_image

string

—

—

URL необязательного референса текстуры.

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

—

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

Что возвращает 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-multi-image_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-multi-image",
    "images": [],
    "topology": "triangle",
    "target_polycount": 30000,
    "should_remesh": True,
    "should_texture": True,
    "symmetry_mode": "auto",
    "geometry_resolution": "standard",
    "enable_pbr": False,
    "pose_mode": "a-pose",
    "texture_prompt": "Пример промпта",
    "texture_image": "Пример промпта",
    "enable_rigging": False,
    "rigging_height_meters": 0.01,
    "enable_animation": False,
    "animation_action_id": 348
},
)
print(r.json())

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