Passer au contenu

Hi3D Texture

Intégrer

Identifiant du modèle hitem3d/hi3d/texture
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hitem3d/hi3d/texture?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Cette requête: ≈0,30 $ 300 crédits API L’exécuter sur cette page

Obtenir une clé API
Hitem3D 3D #3d-to-3d

Applique une texture à un maillage GLB sans texture à l’aide d’une image de référence

Hitem3D · 3D

Votre premier résultat apparaîtra ici

Construisez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour lorsque vous les modifiez.

•requis image_url
Déposez un fichier, ou

Fournissez la référence de texturage par URL, avec une image PNG, JPEG ou WebP d'une taille maximale de 20 MB.

resolution

Choisissez une résolution de texture ou laissez ce champ vide pour utiliser la recommandation du modèle. Pour scene-portraitv1.5, le seul choix est 1536, tandis que hitem3dv1.5 prend en charge 512, 1024, 1536 et 1536pro.

•requis

Fournissez la géométrie à texturer par URL au format GLB ; aucun autre format n'est pris en charge. Une source adaptée est une sortie de géométrie image-to-3d générée avec enable_texture=false.

Avancé model · export_format · enable_safety_checker
model par défaut hitem3dv1.5

Version du modèle à utiliser pour le texturage. La tâche de texture staged nécessite un modèle v1.5.

export_format par défaut glb

Format utilisé pour enregistrer le modèle généré.

POST /run/hitem3d/hi3d/texture?wait=20 devis → 0,30 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/hitem3d/hi3d/texture?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Hi3D Texture

Applique une texture à une géométrie GLB existante, guidée par une image de référence (PNG, JPEG ou WebP, jusqu’à 20MB). Seuls les modèles v1.5 sont pris en charge : hitem3dv1.5 propose des résolutions de 512 à 1536pro, tandis que la variante portrait utilise 1536. Les formats d’export sont glb, obj, stl, fbx et usdz.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
image_urlrequis image
Typeurl · image
Fournissez la référence de texturage par URL, avec une image PNG, JPEG ou WebP d'une taille maximale de 20 MB.
mesh_urlrequis
Typestring
Fournissez la géométrie à texturer par URL au format GLB ; aucun autre format n'est pris en charge. Une source adaptée est une sortie de géométrie image-to-3d générée avec enable_texture=false.
modelfacultatif
Typeenum
Par défauthitem3dv1.5
hitem3dv1.5scene-portraitv1.5
Version du modèle à utiliser pour le texturage. La tâche de texture staged nécessite un modèle v1.5.
resolutionfacultatif
Typeenum
512102415361536pro
Choisissez une résolution de texture ou laissez ce champ vide pour utiliser la recommandation du modèle. Pour scene-portraitv1.5, le seul choix est 1536, tandis que hitem3dv1.5 prend en charge 512, 1024, 1536 et 1536pro.
export_formatfacultatif
Typeenum
Par défautglb
glbobjstlfbxusdz
Format utilisé pour enregistrer le modèle généré.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Activation du contrôle de sécurité des images d'entrée : true impose un contrôle avant le début du traitement de l'image.
requis Nom canonique, également accepté

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu’à 10 MB ou le file_url d’un téléversement. Fichiers

Sortie

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "hitem3d/hi3d/texture",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 300,
    "usd": "0.30",
    "charged": 300,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mesh_url": "https://example.com/your-file.glb"
  },
  "output": {
    "model_mesh": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "thumbnail": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation au Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, vidéos et fichiers audio. output est le propre objet de résultat du modèle.
Champs de sortie
model_mesh
object {url, content_type, file_name, file_size}Fichier contenant le modèle 3D généré.
thumbnail
object {url, content_type, file_name, file_size} | nullImage d'aperçu du modèle, fournie lorsqu'elle est disponible.

Plus de modèles : 3D

Pour les agents IA : cette page au format Markdown est disponible à https://doitong.com/fr/developers/models/hitem3d/hi3d/texture.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt