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

Votre premier résultat apparaîtra ici

Créez 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 pendant 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 au fur et à mesure de vos modifications.

•requis image_url
Déposez un fichier ou

Fournissez la référence de texturation 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 appropriée est une sortie de géométrie image-à-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 la texturation. La tâche de texture intermédiaire exige 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 au 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 sans texture, 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 offre des résolutions de 512 à 1536pro, tandis que la variante portrait utilise 1536. Les formats d’exportation 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 texturation 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 appropriée est une sortie de géométrie image-à-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 la texturation. La tâche de texture intermédiaire exige 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 exige un contrôle avant le début du traitement des images.
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 par Go-mois) ou pendant 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, les vidéos et les fichiers audio. output est l’objet de résultat propre au 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 en Markdown se trouve à https://doitong.com/fr-CA/developers/models/hitem3d/hi3d/texture.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt