Seed3D v1

Référence API Seed3D v1

Générez des assets 3D GLB depuis une URL image. L'API publique accepte une clé utilisateur, crée une tâche asynchrone et renvoie statut et URL.

API v1https://seed3d-ai.org/v180 credits

Démarrage rapide

curl -X POST 'https://seed3d-ai.org/v1/generate' \
  -H 'Authorization: Bearer YOUR_ZA_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "image": "https://example.com/product.png",
    "prompt": "clean topology, neutral studio lighting",
    "subdivision_level": "medium"
  }'

Authentification

Envoyez votre clé API utilisateur dans l'en-tête Authorization pour chaque requête publique.

Créez ou copiez votre clé depuis le tableau de bord : Clés API

Authorization: Bearer YOUR_ZA_API_KEY

Tarification

Génération image-to-3D

Les crédits sont débités quand la tâche est acceptée. Les échecs de soumission provider sont remboursés côté backend.

80 credits

Endpoints API

Envoyez une URL image et des options. La réponse retourne immédiatement un task_id.

`image` required string	URL image HTTP ou HTTPS publique. JPG, PNG et WebP sont recommandés.
`prompt` optional string	Indice optionnel sur surface, matériau, géométrie ou usage. Maximum 2000 caractères.
`subdivision_level` optional string	Indice de détail du mesh. Valeurs : low, medium, high ou 0, 1, 2.default: provider default
`public` optional boolean	Indique si le résultat peut être traité comme contenu public par les fonctions aval.default: false
`callback_url` optional string	URL webhook publique optionnelle. Les localhost sont refusés.

Exemple de requête

{
  "image": "https://example.com/product.png",
  "prompt": "clean topology, neutral studio lighting",
  "subdivision_level": "medium",
  "public": false,
  "callback_url": "https://example.com/webhooks/seed3d"
}

Réponses

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n105abc123s3d",
    "status": "IN_PROGRESS",
    "consumed_credits": 80
  }
}

Interrogez jusqu'à SUCCESS ou FAILED. Une tâche réussie renvoie response comme tableau d'URL.

task_id

required string

ID de tâche retourné par POST /v1/generate.

Exemple de requête

curl -X GET 'https://seed3d-ai.org/v1/status?task_id=n105abc123s3d' \
  -H 'Authorization: Bearer YOUR_ZA_API_KEY'

Réponses

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n105abc123s3d",
    "status": "SUCCESS",
    "consumed_credits": 80,
    "request": {
      "image": "https://example.com/product.png",
      "prompt": "clean topology, neutral studio lighting",
      "subdivision_level": "medium"
    },
    "response": [
      "https://cdn.example.com/seed3d-output.glb"
    ],
    "error_message": null
  }
}

Consultez les tâches récentes créées par la clé API dans Authorization.

`page` optional number	Numéro de page.default: 1
`limit` optional number	Nombre d'éléments par page, plafonné par le backend.default: 20
`task_id` optional string	Filtre optionnel par ID de tâche exact.

Exemple de requête

curl -X GET 'https://seed3d-ai.org/v1/list?page=1&limit=20' \
  -H 'Authorization: Bearer YOUR_ZA_API_KEY'

Outils du tableau de bord

Utilisez le tableau de bord pour créer les clés et inspecter les logs pendant l'intégration.

Ouvrir les clés API Ouvrir les logs API

Codes d'erreur

HTTP	Raison
400	Paramètre manquant ou invalide.
401	Bearer token Authorization manquant ou invalide.
402	Le compte de la clé API n'a pas assez de crédits.
403	La clé API demandée ne correspond pas au bearer token.
404	ID de tâche introuvable.
405	Méthode HTTP non autorisée pour cette route.
500	Erreur serveur ou provider. Réessayez plus tard ou contactez le support.