Seed3D v1

Referencia de Seed3D v1 API

Genere assets 3D GLB desde una URL de imagen. La API pública acepta una clave de usuario, crea una tarea asíncrona y devuelve estado y URLs.

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

Inicio rápido

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

Autenticación

Envíe su clave API de usuario en el encabezado Authorization en cada solicitud.

Cree o copie su clave desde el panel: Claves API

Authorization: Bearer YOUR_ZA_API_KEY

Precios

Generación image-to-3D

Los créditos se descuentan cuando se acepta la tarea. Los fallos de envío al proveedor se reembolsan en backend.

80 credits

Endpoints API

Envíe una URL de imagen y opciones. La respuesta devuelve task_id inmediatamente.

`image` required string	URL de imagen HTTP o HTTPS pública. Se recomiendan JPG, PNG y WebP.
`prompt` optional string	Texto opcional sobre superficie, material, geometría o intención. Máximo 2000 caracteres.
`subdivision_level` optional string	Nivel de detalle de malla. Valores: low, medium, high o 0, 1, 2.default: provider default
`public` optional boolean	Si el resultado puede tratarse como contenido público en funciones posteriores.default: false
`callback_url` optional string	URL webhook pública opcional. Se rechazan localhost.

Solicitud de ejemplo

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

Respuestas

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

Consulte hasta SUCCESS o FAILED. Las tareas exitosas devuelven response como arreglo de URLs.

task_id

required string

ID de tarea devuelto por POST /v1/generate.

Solicitud de ejemplo

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

Respuestas

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

Consulte tareas recientes creadas por la clave API del encabezado Authorization.

`page` optional number	Número de página.default: 1
`limit` optional number	Elementos por página, limitado por backend.default: 20
`task_id` optional string	Filtro opcional por ID exacto de tarea.

Solicitud de ejemplo

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

Herramientas del panel

Use el panel para crear claves e inspeccionar logs durante el desarrollo.

Abrir claves API Abrir logs API

Códigos de error

HTTP	Motivo
400	Parámetro faltante o inválido.
401	Bearer token de Authorization faltante o inválido.
402	La cuenta de la clave API no tiene créditos suficientes.
403	La API key solicitada no coincide con el bearer token.
404	No se encontró el ID de tarea.
405	Método HTTP no permitido para esta ruta.
500	Error del servidor o proveedor. Reintente más tarde o contacte soporte.