ИИ Изображение в 3D — Seed3D 2.0 API

Назад к пайплайнам

Создайте первую 3D-модель

Загрузите фото одного предмета или попробуйте пример.

Заполните для генерации

Изображение

Нажмите, чтобы загрузить image

или перетащите

или

Обзор библиотеки

Работает на

1 модели

ByteDance
- Seed3D 2.0

Примеры

Референс → Результат

Seed3D 2.0

Pyra в виде коллекционной фигурки

Seed3D 2.0. Одна студийная фотография фигурки Pyra превращается в текстурированную модель на 500K граней. Поверните её, чтобы увидеть крылья и хвост, обвитый вокруг лап.

Повторить

0102

Как использовать Изображение в 3D

Краткое руководство, которое поможет определить место этого пайплайна в рабочем процессе.

Лучше всего для

Модели товаров, реквизита, фигурок и персонажей по одной фотографии или рендеру
3D-ассеты для Blender, игровых движков, веб-просмотрщиков и дополненной реальности

API Изображение в 3D

Вызывайте этот пайплайн из своего кода. Один запрос запускает выполнение; модель — это поле ввода, а не отдельный эндпоинт.

Получить API-токен

полей ввода: 3
обязательно: 1
Цены: 10.8 кредитов

Язык

TypeScript Python Go CLI

bun add @pipe2-ai/sdk

Запустить пайплайн

import { createClient } from "@pipe2-ai/sdk";

const client = createClient(process.env.PIPE2_TOKEN!);

const { run_pipeline } = await client.RunPipeline({
  pipeline_slug: "image-to-3d",
  input: {
    image_url: "https://example.com/product.png",
  },
});

pip install pipe2

Запустить пайплайн

import asyncio
import os

from pipe2 import Pipe2Client

client = Pipe2Client(token=os.environ["PIPE2_TOKEN"])

run = asyncio.run(client.run_pipeline(
    pipeline_slug="image-to-3d",
    input={
        "image_url": "https://example.com/product.png",
    },
))

go get github.com/pipe2-ai/sdk-go

Запустить пайплайн

client := pipe2.NewClient(os.Getenv("PIPE2_TOKEN"))

input := json.RawMessage(`{
  "image_url": "https://example.com/product.png"
}`)

run, err := pipe2.RunPipeline(context.Background(), client, "image-to-3d", input)
if err != nil {
    log.Fatal(err)
}

brew install pipe2-ai/tap/pipe2

Запустить пайплайн

pipe2 pipelines run \
  --pipeline image-to-3d \
  --input-json '{"image_url": "https://example.com/product.png"}' \
  --wait

На странице

Ввод	Тип	по умолчанию	Описание
`image_url`обязательно	string	по умолчанию—	Загрузите одно изображение предмета. JPEG, PNG, WebP, BMP, TIFF или GIF; 300–6000 пикселей по каждой стороне; до 20 МБ.
`face_count`	enum	по умолчанию500000	Чем больше граней, тем мельче детали поверхности и тем больше файл. 100000 · 500000 · 1000000 `1000005000001000000`
`output_format`	enum	по умолчаниюglb	GLB подходит для большинства 3D-приложений, игровых движков и веба. OBJ скачивается ZIP-архивом с материалом и текстурой. USDZ открывается в дополненной реальности на iPhone и iPad. glb · obj · usdz `glbobjusdz`

Направьте любой MCP-клиент на pipe2, и ваш агент получит эти инструменты. Он найдёт этот пайплайн, прочитает ту же схему выше и запустит его.

list_pipelines
get_pipeline_schema
run_pipeline
get_pipeline_run_status
request_upload

https://mcp.pipe2.ai/mcp

{
  "mcpServers": {
    "pipe2ai": {
      "url": "https://mcp.pipe2.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Настройка MCP

Полная справка по API Справочник CLI

Часто задаваемые вопросы

Что я получу?

Одну 3D-модель с текстурами и PBR-материалами в выбранном формате. GLB и USDZ — это отдельные файлы. OBJ скачивается ZIP-архивом с сеткой, файлом материала и цветовой текстурой.

Какие изображения подходят лучше всего?

Один предмет, полностью видимый, чёткий и равномерно освещённый: товар, фигурка, игрушка, предмет мебели или персонаж на однотонном фоне. Загрузите одно изображение JPEG, PNG, WebP, BMP, TIFF или GIF размером от 300 до 6000 пикселей по каждой стороне, с соотношением ширины к высоте от 2:5 до 5:2 и объёмом до 20 МБ.

Какое число полигонов выбрать?

100K граней дают самые лёгкие файлы для веба, дополненной реальности и работы в реальном времени. 500K (значение по умолчанию) подходит для большинства задач. 1M сохраняет самые мелкие детали поверхности, но файлы получаются самыми большими.

Какой формат файла выбрать?

GLB подходит для Blender, игровых движков и веба и сохраняет полный PBR-материал. OBJ выбирайте, если он нужен вашей программе: его материал содержит только цветовую текстуру. USDZ — для AR Quick Look на iPhone и iPad.

Можно ли посмотреть модель перед скачиванием?

Да. Результат открывается в интерактивном 3D-просмотрщике, где модель можно вращать и масштабировать.

Сколько времени это занимает?

Обычно несколько минут, а при высокой нагрузке иногда больше десяти. Страницу можно закрыть: готовая модель сохранится в вашей библиотеке.

Как списываются кредиты?

У каждой модели фиксированная цена, которая не зависит от числа полигонов и формата файла. Если создать модель не удалось, кредиты возвращаются.