Meshy 7

Протоколы и возможности

generations

Режимы и параметры

text · text-to-3d

Промпт: required; предел символов: 4000.

Параметр	Назначение	По умолчанию	Допустимые значения
`texture`	Текстура	`true`	`{ "required": true }`
`ultra_detail`	Ультра-детализация	`false`	`{ "required": true }`
`pbr`	PBR-материалы	`false`	`{ "required": true }`
`texture_resolution`	Разрешение текстуры	`"2k"`	`{ "required": true, "values": [ "2k", "4k", "8k" ] }`
`texture_prompt`	Описание текстуры	`null`	`{ "required": false }`
`remesh`	Перестроить сетку	`false`	`{ "required": true }`
`quad`	Четырёхугольная сетка	`false`	`{ "required": true }`
`polycount`	Число полигонов	`30000`	`{ "required": true, "min": 100, "max": 300000 }`
`pose`	Поза	`"none"`	`{ "required": true, "values": [ "none", "a-pose", "t-pose" ] }`
`real_scale`	Реальный масштаб	`false`	`{ "required": true }`
`origin`	Точка опоры	`"bottom"`	`{ "required": true, "values": [ "bottom", "center" ] }`
`extra_formats`	Дополнительные форматы	`[]`	`{ "required": false, "values": [ "fbx", "obj", "usdz" ], "max_items": 3 }`

Входные файлы

Параметр	Назначение	По умолчанию	Допустимые значения
`texture_reference`	Образец текстуры	—	`{ "media_kind": "image", "required": false, "min_items": 0, "max_items": 1, "collection": false, "ordered": false, "accept": [ "image/png", "image/jpeg", "image/webp" ], "max_bytes": 20971520 }`

image · image-to-3d

Промпт: hidden; предел символов: 4000.

Параметр	Назначение	По умолчанию	Допустимые значения
`texture`	Текстура	`true`	`{ "required": true }`
`ultra_detail`	Ультра-детализация	`false`	`{ "required": true }`
`pbr`	PBR-материалы	`false`	`{ "required": true }`
`texture_resolution`	Разрешение текстуры	`"2k"`	`{ "required": true, "values": [ "2k", "4k", "8k" ] }`
`texture_prompt`	Описание текстуры	`null`	`{ "required": false }`
`remesh`	Перестроить сетку	`false`	`{ "required": true }`
`quad`	Четырёхугольная сетка	`false`	`{ "required": true }`
`polycount`	Число полигонов	`30000`	`{ "required": true, "min": 100, "max": 300000 }`
`pose`	Поза	`"none"`	`{ "required": true, "values": [ "none", "a-pose", "t-pose" ] }`
`real_scale`	Реальный масштаб	`false`	`{ "required": true }`
`origin`	Точка опоры	`"bottom"`	`{ "required": true, "values": [ "bottom", "center" ] }`
`image_enhancement`	Улучшить исходное изображение	`true`	`{ "required": true }`
`extra_formats`	Дополнительные форматы	`[]`	`{ "required": false, "values": [ "fbx", "obj", "usdz" ], "max_items": 3 }`

Входные файлы

Параметр	Назначение	По умолчанию	Допустимые значения
`source_image`	Изображение	—	`{ "media_kind": "image", "required": true, "min_items": 1, "max_items": 1, "collection": false, "ordered": false, "accept": [ "image/png", "image/jpeg", "image/webp" ], "max_bytes": 20971520 }`
`texture_reference`	Образец текстуры	—	`{ "media_kind": "image", "required": false, "min_items": 0, "max_items": 1, "collection": false, "ordered": false, "accept": [ "image/png", "image/jpeg", "image/webp" ], "max_bytes": 20971520 }`

multi_image · multi-image-to-3d

Промпт: hidden; предел символов: 4000.

Параметр	Назначение	По умолчанию	Допустимые значения
`texture`	Текстура	`true`	`{ "required": true }`
`ultra_detail`	Ультра-детализация	`false`	`{ "required": true }`
`pbr`	PBR-материалы	`false`	`{ "required": true }`
`texture_resolution`	Разрешение текстуры	`"2k"`	`{ "required": true, "values": [ "2k", "4k", "8k" ] }`
`texture_prompt`	Описание текстуры	`null`	`{ "required": false }`
`remesh`	Перестроить сетку	`false`	`{ "required": true }`
`quad`	Четырёхугольная сетка	`false`	`{ "required": true }`
`polycount`	Число полигонов	`30000`	`{ "required": true, "min": 100, "max": 300000 }`
`pose`	Поза	`"none"`	`{ "required": true, "values": [ "none", "a-pose", "t-pose" ] }`
`real_scale`	Реальный масштаб	`false`	`{ "required": true }`
`origin`	Точка опоры	`"bottom"`	`{ "required": true, "values": [ "bottom", "center" ] }`
`image_enhancement`	Улучшить исходное изображение	`true`	`{ "required": true }`
`remove_lighting`	Убрать освещение	`true`	`{ "required": true }`
`extra_formats`	Дополнительные форматы	`[]`	`{ "required": false, "values": [ "fbx", "obj", "usdz" ], "max_items": 3 }`

Входные файлы

Параметр	Назначение	По умолчанию	Допустимые значения
`reference_images`	Изображения	—	`{ "media_kind": "image", "required": true, "min_items": 2, "max_items": 4, "collection": true, "ordered": true, "accept": [ "image/png", "image/jpeg", "image/webp" ], "max_bytes": 20971520 }`
`texture_reference`	Образец текстуры	—	`{ "media_kind": "image", "required": false, "min_items": 0, "max_items": 1, "collection": false, "ordered": false, "accept": [ "image/png", "image/jpeg", "image/webp" ], "max_bytes": 20971520 }`

Совместимость настроек

json

[
  {
    "allowed": {
      "pbr": [
        false
      ]
    },
    "fallback": {
      "pbr": false
    },
    "when": {
      "texture": false
    }
  }
]

Расчёт стоимости

Цена зависит от выбранных настроек и входных файлов. Калькулятор рассчитывает стоимость без генерации. Для расчёта с файлами используйте POST /v1/generations/quote с API-ключом. Тариф и параметры фиксируются при создании задачи.

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

bash

curl "${RENDERFOX_BASE_URL:-https://api.renderfox.ru/v1}/generations" \
  -H "Authorization: Bearer $RENDERFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  --data-binary @request.json

json

{
  "model": "meshy-7",
  "mode": "text",
  "prompt": "Создай результат по этому описанию.",
  "settings": {
    "texture": true,
    "ultra_detail": false,
    "pbr": false,
    "texture_resolution": "2k",
    "remesh": false,
    "quad": false,
    "polycount": 30000,
    "pose": "none",
    "real_scale": false,
    "origin": "bottom",
    "extra_formats": []
  },
  "inputs": {}
}

Новый логический запрос — новый Idempotency-Key. Сетевой повтор использует прежние ключ и тело. Резерв, списание и возврат FC · Ошибки · Каталог.

Версия тарифа: 8789461fe648e5bb4bcf297a6eb5f7790389b792d8718a255ba06228d51e06a2. Версия каталога: d12314f1d1fbe542. Последнее обновление источника: версия опубликованного каталога.