AI Image to 3D — Seed3D 2.0 API

Back to pipelines

Create your first 3D model

Upload a photo of one object, or try an example.

Complete to generate

Image

Click to upload image

or drag and drop

Browse library

Runs on

1 models

ByteDance
- Seed3D 2.0

Examples

Reference → Result

Seed3D 2.0

Pyra as a collectible figurine

Seed3D 2.0. One studio photo of a Pyra figurine becomes a textured 500K-face model. Turn it to see the wings and the tail curled around its feet.

Reproduce

0102

How to use Image to 3D

A compact decision guide for placing this pipeline in a workflow.

Best for

Product, prop, figurine, and character models from one photo or render
3D assets for Blender, game engines, web viewers, and AR

Image to 3D API

Call this pipeline from your own code. One request dispatches a run; the model is an input field, not a separate endpoint.

Get an API token

inputs: 3
required: 1
Pricing: 10.8 credits

Language

TypeScript Python Go CLI

bun add @pipe2-ai/sdk

Run a 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

Run a 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

Run a 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

Run a pipeline

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

Per page

Input	Type	default	Description
`image_url`required	string	default—	Upload one image of the object. JPEG, PNG, WebP, BMP, TIFF, or GIF; 300–6000 px per side; up to 20 MB.
`face_count`	enum	default500000	More faces keep finer surface detail and make larger files. 100000 · 500000 · 1000000 `1000005000001000000`
`output_format`	enum	defaultglb	GLB suits most 3D apps, game engines, and the web. OBJ downloads as a ZIP with its material and texture. USDZ opens in AR on iPhone and iPad. glb · obj · usdz `glbobjusdz`

Point any MCP client at pipe2 and your agent gets these tools. It finds this pipeline, reads the same schema above, then runs it.

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 setup

Full API reference CLI reference

Frequently Asked Questions

What do I get?

One textured 3D model with PBR materials in the format you choose. GLB and USDZ are single files. OBJ downloads as a ZIP with the mesh, its material file, and a color texture.

Which images work best?

One object that is fully visible, sharp, and evenly lit, such as a product, figurine, toy, piece of furniture, or character, on a plain background. Upload one JPEG, PNG, WebP, BMP, TIFF, or GIF image, 300 to 6000 pixels per side, with a width-to-height ratio from 2:5 to 5:2, up to 20 MB.

Which polygon count should I choose?

100K faces makes the smallest files for web, AR, and real-time use. 500K, the default, suits most uses. 1M keeps the finest surface detail and makes the largest files.

Which file format should I choose?

Choose GLB for Blender, game engines, and the web; it keeps the full PBR material. Choose OBJ when your tool needs it; its material carries only the color texture. Choose USDZ for AR Quick Look on iPhone and iPad.

Can I preview the model before downloading it?

Yes. The result opens in an interactive 3D viewer where you can rotate and zoom it.

How long does it take?

Usually a few minutes, and sometimes more than ten when demand is high. You can leave the page; the model is saved to your library when it is ready.

How are credits charged?

Each model has a fixed price that does not depend on the polygon count or file format. If generation fails, your credits are returned.