Seed3D v1

Seed3D v1 API Referansı

Tek bir görüntü URL'sinden GLB 3D varlıkları üretin. Genel API kullanıcı anahtarı alır, asenkron görev oluşturur ve durum ile çıktı URL'leri döndürür.

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

Hızlı Başlangıç

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

Kimlik Doğrulama

Her genel API isteğinde kullanıcı API anahtarınızı Authorization header içinde gönderin.

Anahtarınızı panodan oluşturun veya kopyalayın: API Anahtarları

Authorization: Bearer YOUR_ZA_API_KEY

Fiyatlandırma

Image-to-3D üretimi

Görev kabul edildiğinde krediler düşülür. Provider gönderim hataları backend tarafından iade edilir.

80 credits

API Endpointleri

Bir görüntü URL'si ve isteğe bağlı ipuçları gönderin. Yanıt hemen task_id döndürür.

`image` required string	Genel HTTP veya HTTPS görüntü URL'si. JPG, PNG ve WebP önerilir.
`prompt` optional string	Yüzey, malzeme, geometri veya varlık amacı için isteğe bağlı metin. En fazla 2000 karakter.
`subdivision_level` optional string	Mesh detay ipucu. Değerler: low, medium, high veya 0, 1, 2.default: provider default
`public` optional boolean	Sonucun sonraki özelliklerde herkese açık içerik olarak işlenip işlenemeyeceği.default: false
`callback_url` optional string	İsteğe bağlı genel webhook URL'si. Localhost reddedilir.

Örnek İstek

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

Yanıtlar

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

SUCCESS veya FAILED olana kadar sorgulayın. Başarılı görevler response alanını URL dizisi olarak döndürür.

task_id

required string

POST /v1/generate tarafından döndürülen görev ID.

Örnek İstek

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

Yanıtlar

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

Authorization header içindeki API anahtarıyla oluşturulan son görevleri sorgulayın.

`page` optional number	Sayfa numarası.default: 1
`limit` optional number	Sayfa başına öğe, backend tarafından sınırlandırılır.default: 20
`task_id` optional string	İsteğe bağlı tam görev ID filtresi.

Örnek İstek

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

Pano Araçları

Entegrasyon geliştirirken anahtar oluşturmak ve günlükleri incelemek için panoyu kullanın.

API Anahtarlarını Aç API Günlüklerini Aç

Hata Kodları

HTTP	Neden
400	Eksik veya geçersiz istek parametresi.
401	Authorization bearer token eksik veya geçersiz.
402	API anahtarı hesabında yeterli kredi yok.
403	İstenen API key bearer token ile eşleşmiyor.
404	Görev ID bulunamadı.
405	Bu rota için HTTP yöntemi izinli değil.
500	Sunucu veya provider hatası. Daha sonra tekrar deneyin veya destekle iletişime geçin.