Da immagine a 3D IA — Seed3D 2.0 API

Torna alle pipeline

Crea il tuo primo modello 3D

Carica la foto di un oggetto o prova un esempio.

Completa per generare

Immagine

Clicca per caricare image

o trascina e rilascia

oppure

Sfoglia libreria

Funziona con

1 modelli

ByteDance
- Seed3D 2.0

Esempi

Riferimento → Risultato

Seed3D 2.0

Pyra come statuina da collezione

Seed3D 2.0. Una foto in studio di una statuina di Pyra diventa un modello con texture da 500K facce. Ruotalo per vedere le ali e la coda avvolta intorno alle zampe.

Riproduci

0102

Come usare Da immagine a 3D

Una guida decisionale concisa per inserire questa pipeline in un flusso di lavoro.

Ideale per

Modelli di prodotti, oggetti di scena, statuine e personaggi da una foto o un render
Asset 3D per Blender, motori di gioco, visualizzatori web e realtà aumentata

API di Da immagine a 3D

Richiama questa pipeline dal tuo codice. Una richiesta avvia un'esecuzione; il modello è un campo di input, non un endpoint separato.

Ottieni un token API

input: 3
obbligatorio: 1
Prezzi: 10.8 crediti

Lingua

TypeScript Python Go CLI

bun add @pipe2-ai/sdk

Esegui una 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

Esegui una 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

Esegui una 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

Esegui una pipeline

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

Per pagina

Input	Tipo	predefinito	Descrizione
`image_url`obbligatorio	string	predefinito—	Carica un'immagine dell'oggetto. JPEG, PNG, WebP, BMP, TIFF o GIF; 300–6000 px per lato; fino a 20 MB.
`face_count`	enum	predefinito500000	Più facce conservano dettagli di superficie più fini e producono file più pesanti. 100000 · 500000 · 1000000 `1000005000001000000`
`output_format`	enum	predefinitoglb	GLB è adatto alla maggior parte delle app 3D, dei motori di gioco e del web. OBJ si scarica come ZIP con materiale e texture. USDZ si apre in realtà aumentata su iPhone e iPad. glb · obj · usdz `glbobjusdz`

Punta un qualsiasi client MCP su pipe2 e il tuo agente ottiene questi strumenti. Trova questa pipeline, legge lo stesso schema qui sopra e la esegue.

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

Configurazione MCP

Riferimento API completo Riferimento CLI

Domande frequenti

Cosa ottengo?

Un modello 3D con texture e materiali PBR nel formato che scegli. GLB e USDZ sono file singoli. OBJ si scarica come ZIP con la mesh, il relativo file di materiale e una texture di colore.

Quali immagini funzionano meglio?

Un solo oggetto interamente visibile, nitido e con luce uniforme, come un prodotto, una statuina, un giocattolo, un mobile o un personaggio, su uno sfondo uniforme. Carica un'immagine JPEG, PNG, WebP, BMP, TIFF o GIF da 300 a 6000 pixel per lato, con un rapporto tra larghezza e altezza da 2:5 a 5:2 e fino a 20 MB.

Quale numero di poligoni devo scegliere?

100K facce produce i file più leggeri per il web, la realtà aumentata e l'uso in tempo reale. 500K, il valore predefinito, va bene per la maggior parte degli usi. 1M conserva i dettagli di superficie più fini e produce i file più pesanti.

Quale formato di file devo scegliere?

Scegli GLB per Blender, i motori di gioco e il web: conserva l'intero materiale PBR. Scegli OBJ se il tuo strumento lo richiede: il suo materiale include solo la texture di colore. Scegli USDZ per AR Quick Look su iPhone e iPad.

Posso vedere il modello prima di scaricarlo?

Sì. Il risultato si apre in un visualizzatore 3D interattivo in cui puoi ruotarlo e ingrandirlo.

Quanto tempo ci vuole?

Di solito qualche minuto, a volte più di dieci nei momenti di maggiore richiesta. Puoi lasciare la pagina: il modello viene salvato nella tua libreria quando è pronto.

Come vengono addebitati i crediti?

Ogni modello ha un prezzo fisso che non dipende dal numero di poligoni né dal formato di file. Se la generazione non riesce, i crediti ti vengono restituiti.