Перейти к содержимому

Meshy 7.1 Text to 3D

Интеграция

ID модели meshy/v7.1/text-to-3d
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/meshy/v7.1/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Файлы, как в примере: 1,20 $ 1 200 API-кредитов · ≈ 129,10 ₽ ваши файлы измеряются перед запуском Запустить на этой странице

Получить API-ключ
Meshy Текст в 3D Вывод в 4K #3d#text-to-3d#textures#pbr

Преобразование текста в 3D в Meshy 7.1 с режимами предпросмотра или полной генерации и разрешением геометрии до 4k

Meshy · 3D

Здесь появится ваш первый результат

Составьте запрос ниже и выполните его с помощью API-ключа. Результаты копируются в наше хранилище и хранятся навсегда или 7 дней бесплатно.

Сформировать запрос

Элементы управления сгенерированы из схемы модели. Код и цена обновляются при изменении параметров.

•обязательно 88 / 600

Описание объекта, который нужно представить в виде 3D-модели; максимум 600 символов.

mode по умолчанию full

Режим генерации: 'preview' создаёт геометрию без текстур, а 'full' — текстурированную модель, объединяя preview и refine.

Расширенные texture_prompt · texture_image_url · model_type · topology · symmetry_mode · pose_mode · geometry_resolution · target_polycount · rigging_height_meters · animation_action_id · seed · should_remesh · enable_pbr · is_a_t_pose · enable_prompt_expansion · enable_safety_checker · ultra_mode
0 / 600

Управление текстурированием дополнительным текстовым промптом в режиме 'full'; другие режимы его не используют.

Перетащите файл или

2D-эталонное изображение для генерации текстур, применяемое только в режиме 'full'.

model_type по умолчанию standard

Режим 3D-сетки: выберите 'lowpoly' для низкополигонального результата с более чистыми полигонами; в этом режиме Meshy игнорирует topology, target_polycount и should_remesh. Для обычного высокодетализированного результата выберите 'standard', а для использования Meshy-T2 на этапе геометрии (preview) и получения чистых деталей, создаваемых раздельно с самого начала, — 'smart-topology'.

topology по умолчанию triangle

Тип топологии модели: Triangle для геометрической детализации или Quad для гладкости поверхности.

symmetry_mode по умолчанию auto

Настройка симметрии, применяемая при генерации модели.

pose_mode по умолчанию

Оставьте строку пустой, чтобы не задавать позу сгенерированной модели, либо запросите A-позу с помощью 'a-pose' или T-позу с помощью 't-pose'.

geometry_resolution

Разрешение геометрии; 4k требует Meshy-7.1.

по умолчанию 30000

Целевое количество полигонов, ограниченное 15,000, если model_type имеет значение 'smart-topology'. Если в этом режиме цель не указана, выбирается меньшее значение Meshy по умолчанию — 4,000.

по умолчанию 1.7

Укажите расчётную высоту персонажа в метрах, если enable_rigging равно true; в противном случае это значение не влияет на результат.

по умолчанию 92

Идентификатор пресета анимации из библиотеки Meshy; доступные действия перечислены на https://docs.meshy.ai/en/api/animation-library. Проверка и использование выполняются только при enable_animation равном true: значения вне [0, 696] отклоняются с ошибкой 422, а "Idle" соответствует `0`.

Повторно используйте это начальное значение вместе с неизменённым промптом, чтобы обычно воспроизвести предыдущий результат.

POST /run/meshy/v7.1/text-to-3d?wait=20 стоимость → 1,20 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/meshy/v7.1/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Запустить этот запрос

Ваш ключ хранится в этом браузере: он отправляется только в Doitong API и сохраняется в localStorage только при включении параметра «Запомнить». Получить API-ключ

О Meshy 7.1 Text to 3D

Создаёт 3D-модель по текстовому `prompt` длиной до 600 символов. `mode` возвращает нетекстурированную геометрию или текстурированный результат, а `geometry_resolution` позволяет выбрать standard, 2k или 4k. В `model_type` выберите standard, lowpoly или smart-topology, задайте `target_polycount` от 100 до 300000 и при необходимости включите PBR, расширение промпта, риггинг и анимацию.

Параметры

ИмяТип По умолчаниюДопустимые значения Описание
promptобязательно
Типstring
≤ 600 символов
Описание объекта, который нужно представить в виде 3D-модели; максимум 600 символов.
modeнеобязательно
Типenum
По умолчаниюfull
previewfull
Режим генерации: 'preview' создаёт геометрию без текстур, а 'full' — текстурированную модель, объединяя preview и refine.
seedнеобязательно
Типinteger | null
Повторно используйте это начальное значение вместе с неизменённым промптом, чтобы обычно воспроизвести предыдущий результат.
model_typeнеобязательно
Типenum
По умолчаниюstandard
standardlowpolysmart-topology
Режим 3D-сетки: выберите 'lowpoly' для низкополигонального результата с более чистыми полигонами; в этом режиме Meshy игнорирует topology, target_polycount и should_remesh. Для обычного высокодетализированного результата выберите 'standard', а для использования Meshy-T2 на этапе геометрии (preview) и получения чистых деталей, создаваемых раздельно с самого начала, — 'smart-topology'.
topologyнеобязательно
Типenum
По умолчаниюtriangle
quadtriangle
Тип топологии модели: Triangle для геометрической детализации или Quad для гладкости поверхности.
target_polycountнеобязательно
Типinteger
По умолчанию30000
100 – 300 000
Целевое количество полигонов, ограниченное 15,000, если model_type имеет значение 'smart-topology'. Если в этом режиме цель не указана, выбирается меньшее значение Meshy по умолчанию — 4,000.
should_remeshнеобязательно
Типboolean
По умолчаниюtrue
Пропустите ремешинг и получите исходную треугольную сетку, установив false; в противном случае включите этап ремешинга.
symmetry_modeнеобязательно
Типenum
По умолчаниюauto
offautoon
Настройка симметрии, применяемая при генерации модели.
enable_pbrнеобязательно
Типboolean
По умолчаниюfalse
Управляет генерацией PBR-карт металличности, шероховатости и нормалей вместе с базовым цветом.
is_a_t_poseнеобязательно
Типboolean
По умолчаниюfalse
Переключатель генерации T-позы, активируемый значением true; устарел, используйте pose_mode.
pose_modeнеобязательно
Типenum
По умолчанию
a-poset-pose
Оставьте строку пустой, чтобы не задавать позу сгенерированной модели, либо запросите A-позу с помощью 'a-pose' или T-позу с помощью 't-pose'.
enable_prompt_expansionнеобязательно
Типboolean
По умолчаниюfalse
Разрешает большой языковой модели дополнить промпт деталями. Это расширение не меняет смысл промпта.
texture_promptнеобязательно
Типstring | null
≤ 600 символов
Управление текстурированием дополнительным текстовым промптом в режиме 'full'; другие режимы его не используют.
texture_image_urlнеобязательно
Типurl · image
2D-эталонное изображение для генерации текстур, применяемое только в режиме 'full'.
enable_riggingнеобязательно
Типboolean
По умолчаниюfalse
Автоматический риггинг человекоподобного персонажа, наиболее эффективный для моделей с чётко различимыми конечностями. При включении риггинг применяется к сгенерированной модели и добавляются базовые анимации ходьбы и бега.
rigging_height_metersнеобязательно
Типnumber
По умолчанию1.7
> 0
Укажите расчётную высоту персонажа в метрах, если enable_rigging равно true; в противном случае это значение не влияет на результат.
enable_animationнеобязательно
Типboolean
По умолчаниюfalse
Получает ли риггированная модель предустановленную анимацию; для этого enable_rigging должно быть равно true.
animation_action_idнеобязательно
Типinteger
По умолчанию92
Идентификатор пресета анимации из библиотеки Meshy; доступные действия перечислены на https://docs.meshy.ai/en/api/animation-library. Проверка и использование выполняются только при enable_animation равном true: значения вне [0, 696] отклоняются с ошибкой 422, а "Idle" соответствует `0`.
enable_safety_checkerнеобязательно
Типboolean
По умолчаниюtrue
Переключатель проверки безопасности перед обработкой: значение true делает проверку входных данных обязательным условием обработки.
geometry_resolutionнеобязательно
Типenum
standard2k4k
Разрешение геометрии; 4k требует Meshy-7.1.
ultra_modeнеобязательно
Типboolean
По умолчаниюfalse
Устаревший параметр, заменённый geometry_resolution; при передаче обоих используется geometry_resolution. Используйте geometry_resolution='2k'.
обязательно

Параметры файлов принимают общедоступный https:// URL, data: URI размером до 10 MB или file_url загруженного файла. Файлы

Результат

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v7.1/text-to-3d",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1200,
    "usd": "1.20",
    "charged": 1200,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "animation_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "animation_fbx": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "thumbnail": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_urls": {
      "glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "obj": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "usdz": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "blend": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "stl": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "texture_urls": [
      {
        "base_color": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        },
        "metallic": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        },
        "normal": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        },
        "roughness": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        }
      }
    ],
    "seed": 42,
    "prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, constructed from weathered, dark brown planks exhibiting prominent wood grain and subtle distress. It's heavily reinforced with broad, dark grey, oxidized metal bands secured by numerous circular rivets. Ornate, dark iron decorative elements featuring swirling foliate patterns and dragon motifs adorn the corners and lid. A prominent, circular, intricately carved metal lock plate with a central keyhole dominates the front, flanked by two large, dark metallic pull rings.",
    "actual_prompt": "string",
    "rigged_character_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "rigged_character_fbx": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "basic_animations": {
      "walking_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "walking_fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "walking_armature_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_armature_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "rig_task_id": "string"
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Ваши файлы — ваш выборКаждый URL из outputs[].url — это копия в нашем хранилище: она хранится навсегда (оплата за ГБ в месяц) или 7 дней бесплатно — в зависимости от настройки вашего аккаунта или параметра ?storage=.
Одинаковая структура у каждой моделиtype, url, content_type, width, height и duration — одинаково для изображений, видео и аудио. output — собственный объект результата модели.
Поля результата
animation_glb
object {url, content_type, file_name, file_size} | nullРезультат анимации, содержащий 3D-модель в формате GLB; ответ не включает его, если enable_animation не равно true.
animation_fbx
object {url, content_type, file_name, file_size} | nullРезультат анимации, содержащий 3D-модель в формате FBX; ответ не включает его, если enable_animation не равно true.
model_glb
object {url, content_type, file_name, file_size}GLB-файл с сгенерированным 3D-объектом.
thumbnail
object {url, content_type, file_name, file_size} | nullМиниатюра с предварительным просмотром сгенерированной модели.
model_urls
object {glb, fbx, obj, usdz, blend, stl}Ссылки на 3D-модель в различных форматах.
texture_urls
array of object {base_color, metallic, normal, roughness}Файлы текстур, представленные в виде массива объектов.
seed
integer | nullНачальное значение, использованное во время генерации.
prompt
stringТекстовый промпт, переданный для генерации.
actual_prompt
string | nullПромпт, фактически применённый при генерации, если расширение промпта было включено.
rigged_character_glb
object {url, content_type, file_name, file_size} | nullРезультат риггинга в виде файла персонажа GLB; отсутствует в ответе, если enable_rigging не равно true.
rigged_character_fbx
object {url, content_type, file_name, file_size} | nullРезультат риггинга в виде файла персонажа FBX; отсутствует в ответе, если enable_rigging не равно true.
basic_animations
object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} | nullБазовые анимации ходьбы и бега, включаемые только при enable_rigging, равном true.
rig_task_id
string | nullИдентификатор задачи риггинга; включается только при enable_rigging, равном true.

Другие модели: Текст в 3D

Для AI-агентов: эта страница в формате Markdown доступна по адресу https://doitong.com/developers/models/meshy/v7.1/text-to-3d.md. Все модели и руководства: https://doitong.com/developers/llms.txt