> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# 3D Üretimi

> Metinden-3D veya resimden-3D görevleri oluşturun, tamamlanan varlıklar için anket yapın ve indirilebilir model dosyalarını yönetin.

3D üretimi asenkron bir süreçtir. `POST /v1/3d/generations` bir TokenLab görevi oluşturur; tamamlanmış durum yanıtları, `model_url` gibi indirilebilir model varlıkları döndürür ve mevcut olduğunda format-spesifik URL'leri içerir.

## Girdi Türünü Seçin

| İş Akışı    | Gerekli girdi                               | Opsiyonel alanlar                    | Notlar                                                        |
| ----------- | ------------------------------------------- | ------------------------------------ | ------------------------------------------------------------- |
| Metinden-3D | `model`, `prompt`                           | `format`, `quality`, `style`, `seed` | Bir tanımdan yeni bir varlık oluşturmak için en iyisi         |
| Resimden-3D | `model`, `prompt`, `image` veya `image_url` | `format`, `quality`, `style`, `seed` | Seçilen modelin resim girişi desteklediği durumlarda kullanın |

Hangi seçeneklerin sunulacağına karar vermeden önce model kataloğunu sorgulayın:

```bash theme={null}
curl "https://api.tokenlab.sh/v1/models?recommended_for=3d" \
  -H "Authorization: Bearer sk-your-api-key"
```

Her 3D modelin her iki girdi türünü veya her çıktı formatını desteklediğini varsaymayın. `image`, `image_url`, `format`, `quality`, `style` veya `seed` göndermeden önce seçilen model sözleşmesini kontrol edin.

## 3D Görevi Oluşturun

```bash theme={null}
curl https://api.tokenlab.sh/v1/3d/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tripo3d-v2.5",
    "prompt": "Temiz topolojiye sahip stilize edilmiş düşük poli robot maskotu",
    "format": "glb",
    "quality": "standard"
  }'
```

Resimden-3D için, mümkünse bir genel `image_url` kullanın. Müşterinizin kasıtlı olarak özel medya gönderdiği ve arka uç sisteminizin daha büyük istek gövdelerine hazır olduğu durumlarda yalnızca inline/base64 `image` kullanın.

## Çıktı Formatı Seçenekleri

* `glb`, genellikle web önizlemeleri için en güvenli varsayılandır.
* `fbx` ve `obj`, seçilen model bunları destekliyorsa DCC hatları için faydalıdır.
* `usdz`, model tarafından sunulduğunda Apple AR iş akışları için faydalıdır.
* Daha yüksek `quality` değerleri gecikmeyi ve maliyeti artırabilir. Bunları gizli varsayılanlar değil, açık kullanıcı seçimleri olarak sunun.
* `seed`, yalnızca model bunu dikkate alıyorsa yeniden üretilebilirlik için faydalıdır.

## Varlıkları Anket Yapın ve Saklayın

Öncelikle döndürülen `poll_url`'u kullanın. Müşterinizin sabit bir yola ihtiyacı varsa, `GET /v1/tasks/{id}` kullanın.

```bash theme={null}
curl "https://api.tokenlab.sh/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer sk-your-api-key"
```

Tamamlanan görevler `model_url` döndürür ve `glb_url`, `fbx_url`, `obj_url` veya `usdz_url` içerebilir. Kullanıcıların tekrar erişim, sürüm geçmişi veya uzun süreli indirmelere ihtiyacı varsa, seçilen varlığı kendi ürününüzde indirin veya önbelleğe alın.

## Üretim Kontrol Listesi

* `task_id`, `poll_url`, model, talep edilen format ve kendi varlık kayıt kimliğinizi saklayın.
* Sayfa yenilemesinden sonra anket yapmaya devam edin, yeni bir görev oluşturmaktan kaçının.
* Görevi oluşturmadan önce kaynak resim boyutunu ve erişilebilirliğini doğrulayın.
* Kullanıcının varlığa erişim izni yoksa, oluşturulan varlık URL'lerini genel sayfalardan uzak tutun.
* Daha sonra uzlaşma için mevcut olduğunda `billing_transaction_id` kaydedin.

## Yaygın Hatalar

| Belirti                               | Muhtemel neden                                                     | Çözüm                                                             |
| ------------------------------------- | ------------------------------------------------------------------ | ----------------------------------------------------------------- |
| Oluşturma yanıtında varlık URL'si yok | 3D üretimi asenkron                                                | Terminal duruma kadar anket yapın                                 |
| Talep edilen format eksik             | Model o formatı döndürmedi                                         | `model_url`'a geri dönün veya formatı destekleyen bir model seçin |
| Resimden-3D reddedildi                | Seçilen model yalnızca metin destekli veya resim URL'si erişilemez | Model sözleşmesini kontrol edin ve URL'yi doğrulayın              |
| Çift varlıklar                        | Yeniden deneme yolu görevi zaman aşımından sonra yeniden oluşturdu | Yeniden denemeden önce görev kimliğini saklayın                   |

## API Referansı

| Konu                       | Referans                                                     |
| -------------------------- | ------------------------------------------------------------ |
| 3D Oluştur                 | [3D Oluştur](/tr/api-reference/3d/create-3d)                 |
| 3D Durumunu Al             | [3D Durumunu Al](/tr/api-reference/3d/get-3d-status)         |
| Görev Durumunu Al          | [Görev Durumunu Al](/tr/api-reference/tasks/get-task-status) |
| Modelleri Listele          | [Modelleri Listele](/tr/api-reference/models/list-models)    |
| Faturalama & Fiyatlandırma | [Faturalama & Fiyatlandırma](/tr/guides/billing)             |