Imagem para 3D com IA — Seed3D 2.0 API

Voltar aos pipelines

Crie seu primeiro modelo 3D

Envie a foto de um objeto ou experimente um exemplo.

Preencha para gerar

Imagem

Clique para enviar image

ou arraste e solte

Explorar biblioteca

Funciona com

1 modelos

ByteDance
- Seed3D 2.0

Exemplos

Referência → Resultado

Seed3D 2.0

Pyra como estatueta colecionável

Seed3D 2.0. Uma foto de estúdio de uma estatueta de Pyra vira um modelo com texturas de 500K faces. Gire para ver as asas e a cauda enrolada em volta das patas.

Reproduzir

0102

Como usar Imagem para 3D

Um guia de decisão conciso para posicionar este pipeline em um fluxo de trabalho.

Ideal para

Modelos de produtos, objetos de cena, estatuetas e personagens a partir de uma foto ou renderização
Recursos 3D para Blender, engines de jogos, visualizadores web e realidade aumentada

API do Imagem para 3D

Chame este pipeline a partir do seu próprio código. Um pedido lança uma execução; o modelo é um campo de entrada, não um endpoint separado.

Obter um token de API

entradas: 3
obrigatório: 1
Preços: 10.8 créditos

Idioma

TypeScript Python Go CLI

bun add @pipe2-ai/sdk

Executar um pipeline

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

Executar um pipeline

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

Executar um pipeline

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

Executar um pipeline

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

Por página

Entrada	Tipo	predefinição	Descrição
`image_url`obrigatório	string	predefinição—	Envie uma imagem do objeto. JPEG, PNG, WebP, BMP, TIFF ou GIF; 300 a 6000 px por lado; até 20 MB.
`face_count`	enum	predefinição500000	Mais faces preservam detalhes de superfície mais finos e geram arquivos maiores. 100000 · 500000 · 1000000 `1000005000001000000`
`output_format`	enum	predefiniçãoglb	GLB serve para a maioria dos apps 3D, engines de jogos e a web. O OBJ é baixado como um ZIP com o material e a textura. O USDZ abre em realidade aumentada no iPhone e no iPad. glb · obj · usdz `glbobjusdz`

Aponte qualquer cliente MCP para o pipe2 e o seu agente ganha estas ferramentas. Ele encontra este pipeline, lê o mesmo esquema acima e executa-o.

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" }
    }
  }
}

Configuração de MCP

Referência completa da API Referência da CLI

Perguntas frequentes

O que eu recebo?

Um modelo 3D com texturas e materiais PBR no formato que você escolher. GLB e USDZ são arquivos únicos. O OBJ é baixado como um ZIP com a malha, o arquivo de material e uma textura de cor.

Quais imagens funcionam melhor?

Um único objeto totalmente visível, nítido e com luz uniforme, como um produto, uma estatueta, um brinquedo, um móvel ou um personagem, sobre um fundo liso. Envie uma imagem JPEG, PNG, WebP, BMP, TIFF ou GIF, com 300 a 6000 pixels por lado, proporção entre largura e altura de 2:5 a 5:2 e até 20 MB.

Qual contagem de polígonos devo escolher?

100K faces gera os arquivos menores para web, realidade aumentada e uso em tempo real. 500K, o padrão, atende à maioria dos usos. 1M preserva os detalhes de superfície mais finos e gera os arquivos maiores.

Qual formato de arquivo devo escolher?

Escolha GLB para Blender, engines de jogos e web; ele mantém o material PBR completo. Escolha OBJ quando sua ferramenta exigir; o material dele inclui apenas a textura de cor. Escolha USDZ para o AR Quick Look no iPhone e no iPad.

Posso ver o modelo antes de baixar?

Sim. O resultado abre em um visualizador 3D interativo, no qual você pode girá-lo e ampliá-lo.

Quanto tempo leva?

Normalmente alguns minutos, e às vezes mais de dez quando a demanda está alta. Você pode sair da página: o modelo é salvo na sua biblioteca quando fica pronto.

Como os créditos são cobrados?

Cada modelo tem um preço fixo, que não depende da contagem de polígonos nem do formato de arquivo. Se a geração falhar, seus créditos são devolvidos.