PopNowAPI
Obtenir une clé API

Seed3D 2.0 API

par ByteDance

Modèles 3D richement texturés à partir d’une image, idéal pour les personnages

bytedance/seed3d-2.0/image-to-3d
  • Image en 3D

À propos de Seed3D 2.0

Modèles 3D richement texturés à partir d’une image, idéal pour les personnages.

Appelez-le avec le nom de modèle bytedance/seed3d-2.0/image-to-3d sur POST /jobs/createTask, à partir de 0,48 $US.

Introduction

Seed3D 2.0 est le modèle d'assets 3D de l'équipe Seed de ByteDance, publié en avril 2026. Il lit une seule image et reconstruit l'objet qu'elle montre sous la forme d'un maillage 3D complet avec ses matériaux : une photo de produit ou un rendu de personnage devient ainsi un objet que vous pouvez faire pivoter, éclairer et placer dans une scène. La requête prend une image (image_url) et un commutateur de densité facultatif (mesh_detail) ; il n'y a ni prompt, ni seed, ni champ de style. Le résultat est un fichier glTF binaire (.glb) avec les textures intégrées.

Points forts

Géométrie et matériaux à partir d'une seule image

Seed3D 2.0 génère conjointement la forme et un matériau physiquement réaliste. Dans nos essais, chaque modèle est revenu avec deux textures de 4096×4096, une carte de couleur de base et une carte metal-roughness, si bien que le cuir paraissait usé et mat, tandis que les œillets en laiton et la visière d'un casque captaient des reflets. Il n'y a pas de carte de normales séparée : le détail de surface est dans le maillage lui-même.

Un maillage dense et fermé

Au niveau medium par défaut, les deux modèles de test sont revenus avec un maillage et un matériau uniques, juste en dessous de 500 000 triangles ; au niveau low, la même botte comptait 99 977 faces. Selon ses concepteurs, les niveaux correspondent à environ 100 000, 500 000 et 1 000 000 faces. Un maillage plus dense restitue mieux les petits détails comme les lacets, les coutures ou les doigts ; un maillage plus léger se charge plus vite dans un navigateur.

Ce que nous avons mesuré

Nous avons envoyé une photo de studio de 1024×1024 d'une botte en cuir et un rendu de 682×1024 d'un astronaute jouet. Les deux ont renvoyé des fichiers GLB valides : 37,2 Mo et 28,6 Mo, 499 998 et 499 992 triangles, traités en 356 et 340 secondes. L'astronaute a conservé son visage, sa visière, son plastron et ses liserés orange sous tous les angles. La botte, envoyée de face en vue droite, est revenue avec sa moitié arrière en miroir de l'avant.

Paramètres de requête

ParamètreRequisDescription
image_urlOuiL’image de départ.
mesh_detailNonDensité du maillage : low (environ 100 000 faces), medium (environ 500 000) ou high (environ 1 000 000). Les trois coûtent le même prix ; les niveaux plus élevés gardent plus de détails et donnent des fichiers plus lourds. low · medium · high · Par défaut: medium

Tarifs

Les prix sont en USD. L’API utilise un solde distinct en dollars américains. Les crédits du site ne peuvent pas être utilisés pour l’API ni convertis en solde API, et le solde API ne peut pas être converti en crédits du site. À l’acceptation d’une tâche, le montant maximal du devis est réservé sur votre solde API. À la fin, la facturation suit l’usage réel, sans dépasser ce montant, et le reste est libéré. En cas d’échec, le montant réservé est libéré.

OptionUSD par génération
Standard0,48 $US

Avant l’exécution, envoyez le même corps de requête à POST /jobs/quote pour connaître les frais estimés et leur plafond en USD. Le devis ne lance aucune tâche et ne débite pas votre solde.

Cas d'usage

E-commerce et visualiseurs produit

Une photo packshot devient un modèle interactif pour une page produit ou un aperçu AR. Photographiez ou rendez le produit en vue trois-quarts sur fond uni, gardez l'objet entier dans le cadre, et utilisez le niveau medium pour un bon équilibre entre détail et taille de téléchargement.

Personnages, jouets et objets de collection

Les rendus de personnages et les photos de figurines se convertissent bien, car leurs formes sont simples et leurs couleurs franches. La texture porte les détails peints, comme les visages, les badges et les rayures ; le dos est déduit, choisissez donc une pose où l'essentiel du personnage est visible.

Guide de prompt et conseils d'expert

Préparer l'image

Un seul sujet, centré, avec une marge autour et rien qui touche le bord du cadre. Un fond clair et uni sépare proprement l'objet. JPEG, PNG ou WebP jusqu'à 10 Mo sont acceptés, et le format de l'image doit rester entre environ 2:5 et 5:2.

Choisir l'angle à dessein

Le modèle ne voit qu'un côté. Une vue de face bien droite d'une chaussure ou d'une voiture laisse la longueur de l'objet inconnue, et la moitié cachée risque d'être remplie par un miroir de l'avant. Une vue trois-quarts montrant l'avant et un côté donne un résultat bien plus fiable.

Choisir le niveau de détail selon l'usage

Utilisez low pour les aperçus mobiles et les scènes avec beaucoup d'accessoires, medium pour la plupart des visualiseurs web et high lorsque le modèle sera examiné de près ou imprimé en 3D.

Vérifier le résultat avant publication

Ouvrez le GLB dans un visualiseur, faites-le pivoter entièrement et examinez le côté que vous n'avez pas montré. Si le dos semble faux, essayez une autre photo plutôt qu'un autre niveau de détail.

Démarrage rapide de l'API

Appeler l’API Seed3D 2.0 en trois étapes

  1. Créer une clé API. Connectez-vous à PopNow et créez une clé dans la console API. Les clés commencent par sk-popnow-. Les appels API utilisent votre solde distinct en dollars américains.
  2. Envoyer la requête. Envoyez POST /jobs/createTask avec model bytedance/seed3d-2.0/image-to-3d et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
  3. Récupérer le résultat. Interrogez GET /jobs/recordInfo avec l’ID de tâche, ou passez une callBackUrl et nous y envoyons le résultat. Téléchargez les liens de sortie quand la tâche réussit.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seed3d-2.0/image-to-3d",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "mesh_detail": "medium"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Remplacez le prompt et les liens par les vôtres. L'onglet API contient la référence pour la réponse, le polling et le callback.

Questions sur l’API Seed3D 2.0

Combien coûte l’API Seed3D 2.0 ?

Seed3D 2.0 coûte 0,48 $US par génération. L’API utilise un solde distinct en dollars américains. Les crédits du site ne peuvent pas être utilisés pour l’API ni convertis en solde API, et le solde API ne peut pas être converti en crédits du site. À l’acceptation d’une tâche, le montant maximal du devis est réservé sur votre solde API. À la fin, la facturation suit l’usage réel, sans dépasser ce montant, et le reste est libéré. En cas d’échec, le montant réservé est libéré.

Quel est le nom de modèle de Seed3D 2.0 dans l’API ?

Indiquez bytedance/seed3d-2.0/image-to-3d pour Image en 3D dans le champ model de POST /jobs/createTask.

Que reçoit-on ?

Un fichier .glb (glTF 2.0 binaire) avec les textures intégrées : une carte de couleur de base et une carte métal-rugosité, toutes deux en PNG 4096×4096 dans nos essais. Blender, three.js, model-viewer, Unity et Unreal l’importent directement.

Faut-il un prompt ?

Non. La seule entrée obligatoire est l’image. mesh_detail est facultatif et ne change que la densité du maillage.

Quelle image fonctionne le mieux ?

Un seul sujet, entièrement dans le cadre, sur fond uni, vu de trois quarts. Les scènes chargées, les objets coupés et les vues de face obligent le modèle à deviner ce qu’il ne voit pas.

Quelles sont les limites de l’API Seed3D 2.0 ?

Taille maximale d’envoi: 10 MB. Les requêtes hors de ces limites sont refusées avant tout débit.

Puis-je essayer Seed3D 2.0 sans écrire de code ?

Exécutez Seed3D 2.0 dans le Playground avec votre solde API en USD, sans clé API. Chaque exécution figure dans votre historique développeur avec le code correspondant.

En savoir plus sur Seed3D 2.0