SAM 3D Objects

ПровайдерMeta

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

asynctext_to_3d

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

SAM 3D Objects Открыть в Playground

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

Async
Text-to-3D

Стоимость

за запрос

per request

1.06 ₽

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

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

Vendor

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

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

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

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",
    "inputs.image": "Пример промпта",
    "inputs.mask": "Пример промпта",
    "positivePrompt": "Пример промпта",
    "seed": 4611686018427388000,
    "numberResults": 1,
    "outputType": "URL",
    "outputFormat": "GLB",
    "webhookURL": "https://example.com/...",
    "uploadEndpoint": "value"
},
)
print(r.json())

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