Image vers 3D IA — Seed3D 2.0 API

Retour aux pipelines

Créez votre premier modèle 3D

Importez la photo d’un objet ou essayez un exemple.

À compléter pour générer

Image

Cliquez pour importer image

ou glissez-déposez

Parcourir la bibliothèque

Fonctionne avec

1 modèles

ByteDance
- Seed3D 2.0

Exemples

Référence → Résultat

Seed3D 2.0

Pyra en figurine de collection

Seed3D 2.0. Une photo studio d’une figurine de Pyra devient un modèle texturé de 500K faces. Faites-le pivoter pour voir les ailes et la queue enroulée autour de ses pattes.

Reproduire

0102

Comment utiliser Image vers 3D

Un guide de décision concis pour placer ce pipeline dans un workflow.

Idéal pour

Modèles de produits, d’accessoires, de figurines et de personnages à partir d’une photo ou d’un rendu
Ressources 3D pour Blender, les moteurs de jeu, les visionneuses Web et la réalité augmentée

API Image vers 3D

Appelez ce pipeline depuis votre propre code. Une requête lance une exécution ; le modèle est un champ d'entrée, pas un endpoint distinct.

Obtenir un jeton d'API

entrées: 3
requis: 1
Tarifs: 10.8 crédits

Langue

TypeScript Python Go CLI

bun add @pipe2-ai/sdk

Exécuter un 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

Exécuter un 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

Exécuter un 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

Exécuter un pipeline

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

Par page

Entrée	Type	par défaut	Description
`image_url`requis	string	par défaut—	Importez une image de l’objet. JPEG, PNG, WebP, BMP, TIFF ou GIF ; 300 à 6000 px de côté ; jusqu’à 20 Mo.
`face_count`	enum	par défaut500000	Plus de faces conservent des détails de surface plus fins et produisent des fichiers plus lourds. 100000 · 500000 · 1000000 `1000005000001000000`
`output_format`	enum	par défautglb	GLB convient à la plupart des applications 3D, des moteurs de jeu et au Web. OBJ se télécharge sous forme de ZIP avec son matériau et sa texture. USDZ s’ouvre en réalité augmentée sur iPhone et iPad. glb · obj · usdz `glbobjusdz`

Pointez n'importe quel client MCP vers pipe2 et votre agent obtient ces outils. Il trouve ce pipeline, lit le même schéma ci-dessus, puis l'exécute.

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

Configuration MCP

Référence complète de l'API Référence de la CLI

Foire aux questions

Qu’est-ce que j’obtiens ?

Un modèle 3D texturé avec des matériaux PBR, dans le format de votre choix. GLB et USDZ sont des fichiers uniques. OBJ se télécharge sous forme de ZIP contenant le maillage, son fichier de matériau et une texture de couleur.

Quelles images donnent les meilleurs résultats ?

Un seul objet entièrement visible, net et éclairé de façon homogène, comme un produit, une figurine, un jouet, un meuble ou un personnage, sur un fond uni. Importez une image JPEG, PNG, WebP, BMP, TIFF ou GIF de 300 à 6000 pixels de côté, avec un rapport largeur/hauteur compris entre 2:5 et 5:2, jusqu’à 20 Mo.

Quel nombre de polygones choisir ?

100K faces produit les fichiers les plus légers pour le Web, la réalité augmentée et le temps réel. 500K, la valeur par défaut, convient à la plupart des usages. 1M conserve les détails de surface les plus fins et produit les fichiers les plus lourds.

Quel format de fichier choisir ?

Choisissez GLB pour Blender, les moteurs de jeu et le Web ; il conserve le matériau PBR complet. Choisissez OBJ si votre outil l’exige ; son matériau ne contient que la texture de couleur. Choisissez USDZ pour AR Quick Look sur iPhone et iPad.

Puis-je prévisualiser le modèle avant de le télécharger ?

Oui. Le résultat s’ouvre dans une visionneuse 3D interactive où vous pouvez le faire pivoter et zoomer.

Combien de temps cela prend-il ?

Généralement quelques minutes, parfois plus de dix en période de forte demande. Vous pouvez quitter la page : le modèle est enregistré dans votre bibliothèque dès qu’il est prêt.

Comment les crédits sont-ils facturés ?

Chaque modèle a un prix fixe qui ne dépend ni du nombre de polygones ni du format de fichier. Si la génération échoue, vos crédits vous sont rendus.