Seed3D v1

Seed3D v1 API-Referenz

Generieren Sie GLB-3D-Assets aus einer Bild-URL. Die Public API nutzt einen User API Key, erstellt einen async Task und liefert Status sowie Output-URLs.

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

Schnellstart

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

Authentifizierung

Senden Sie Ihren User API Key bei jeder Public API-Anfrage im Authorization-Header.

Erstellen oder kopieren Sie Ihren Schlüssel im Dashboard: API-Schlüssel

Authorization: Bearer YOUR_ZA_API_KEY

Preise

Image-to-3D-Generierung

Credits werden bei Task-Annahme abgezogen. Provider-Submit-Fehler werden backendseitig erstattet.

80 credits

API-Endpunkte

Senden Sie eine Bild-URL und optionale Hinweise. Die Antwort enthält sofort eine task_id.

`image` required string	Öffentliche HTTP- oder HTTPS-Bild-URL. JPG, PNG und WebP werden empfohlen.
`prompt` optional string	Optionaler Hinweis zu Oberfläche, Material, Geometrie oder Asset-Ziel. Maximal 2000 Zeichen.
`subdivision_level` optional string	Mesh-Detail-Hinweis. Werte: low, medium, high oder 0, 1, 2.default: provider default
`public` optional boolean	Ob das Ergebnis für nachgelagerte Funktionen als öffentlich behandelt werden darf.default: false
`callback_url` optional string	Optionale öffentliche Webhook-URL. Localhost wird abgelehnt.

Beispielanfrage

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

Antworten

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

Pollen Sie bis SUCCESS oder FAILED. Erfolgreiche Tasks geben response als URL-Array zurück.

task_id

required string

Task-ID aus POST /v1/generate.

Beispielanfrage

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

Antworten

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

Fragen Sie aktuelle Tasks ab, die mit dem API Key im Authorization-Header erstellt wurden.

`page` optional number	Seitennummer.default: 1
`limit` optional number	Elemente pro Seite, backendseitig begrenzt.default: 20
`task_id` optional string	Optionaler exakter Task-ID-Filter.

Beispielanfrage

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

Dashboard-Tools

Nutzen Sie das Dashboard zum Erstellen von Keys und Prüfen von Logs während der Integration.

API-Schlüssel öffnen API-Logs öffnen

Fehlercodes

HTTP	Grund
400	Fehlender oder ungültiger Request-Parameter.
401	Authorization bearer token fehlt oder ist ungültig.
402	Das API-Key-Konto hat nicht genügend Credits.
403	Der angefragte API Key stimmt nicht mit dem bearer token überein.
404	Task-ID wurde nicht gefunden.
405	HTTP-Methode ist für diese Route nicht erlaubt.
500	Server- oder Providerfehler. Später erneut versuchen oder Support kontaktieren.