ГлавнаяМоделиГенерация 3D-объектовSAM 3D Objects

SAM 3D Objects API

ПровайдерMeta

meta-sam-3d — генерация 3d-объектов-модель от Meta.

asynctext_to_3d

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

SAM 3D Objects Открыть в песочнице

Что умеет SAM 3D Objects

  • Async
  • Text-to-3D

Стоимость

за запрос
per request
0.502 ₽

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

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

Vendor
meta
Modality
object3d

SAM 3D Objects — реконструкция 3D-объектов по изображению

SAM 3D Objects — модель от Meta из США, представленная 19 ноября 2025 года. Она восстанавливает геометрию, текстуру и расположение объектов по одному изображению, включая сложные сцены с перекрытиями и визуальным шумом. Модель подходит для создания 3D-ассетов, задач компьютерного зрения, интерактивных медиа и прототипирования.

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

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

ПараметрТипДиапазон / значенияПо умолчаниюОписание
positivePrompt
string
—
—
Опциональный текстовый промпт описывающий желаемый 3D-объект.
seed
integer
min: 0 · max: 9223372036854776000
—
Seed для воспроизводимой генерации.
inputs.imagereq
string
—
—
Входное изображение для 3D реконструкции (UUID / URL / Data URI / Base64).
1 пример
Примеры
https://example.com/object.jpg
inputs.maskreq
string
—
—
Маска выделяющая объект на input image (UUID / URL / Data URI / Base64). Белые области = область реконструкции в 3D.
1 пример
Примеры
https://example.com/mask.png
numberResults
integer
min: 1 · max: 4
1
Сколько вариаций сгенерировать.
outputType
enum
URL
URL
Формат доставки. Только URL.
outputFormat
enum
GLB
GLB
Формат 3D-файла. Только GLB.
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
—

Пример кода

meta-sam-3d_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": "meta-sam-3d",
    "positivePrompt": "Пример промпта",
    "seed": 4611686018427388000,
    "numberResults": 1,
    "outputType": "URL",
    "outputFormat": "GLB",
    "webhookURL": "https://example.com/...",
    "uploadEndpoint": "value",
    "inputs": {
        "image": "Пример промпта",
        "mask": "Пример промпта"
    }
},
)
print(r.json())
Полная документация модели

Частые вопросы о SAM 3D Objects

SAM 3D Objects — модель Meta для построения 3D-представлений объектов и сцен по одному изображению с восстановлением формы, текстуры и расположения.
Модель помогает быстрее получать 3D-ассеты из изображений для прототипов, визуальных проектов и задач компьютерного зрения, сокращая ручную подготовку.
Подключить API SAM 3D Objects можно через Ranvik API: сервис объединяет удобный доступ к AI-инструментам и понятный процесс интеграции.
Через Ranvik API можно работать с API SAM 3D Objects в России без VPN, подключая модель к своему продукту через единый интерфейс сервиса.
Да, Ranvik API позволяет оплачивать использование API SAM 3D Objects в российских рублях, делая расчеты для российских команд удобнее.
Для реконструкции используется изображение объекта или сцены. SAM 3D Objects формирует 3D-геометрию, текстуру и пространственное расположение.