Tripo 3D API Kullanımı: Kapsamlı Geliştirici Rehberi

Metin açıklamalarından veya görüntülerden 3D modeller oluşturma yeteneği, geliştiricilerin oyun, e-ticaret, sanal gerçeklik ve mimari görselleştirme uygulamalarını oluşturma biçimini dönüştürdü. Tripo 3D API, kapsamlı 3D modelleme uzmanlığı gerektirmeden yapay zeka destekli 3D model üretimini uygulamalarınıza entegre etmenin basit bir yolunu sunar.

Bu rehber, ilk kurulumdan üretim dağıtımına kadar Tripo 3D API'yi uygulamak için ihtiyacınız olan her şeyi adım adım anlatır.

Tripo 3D API Nedir?

Tripo 3D API, gelişmiş yapay zeka algoritmaları aracılığıyla metin istemlerini veya 2D görüntüleri üretime hazır 3D modellere dönüştürür. Hizmet, karmaşık makine öğrenimi süreçlerini arka planda halleder ve geliştiricilerin dakikalar içinde entegre edebileceği basit REST uç noktaları sunar.

Hypereal AI'da Tripo 3D API'yi ucuza kullanabilirsiniz.

Platform üç ana üretim modunu destekler:

• Metinden 3D'ye: Doğal dil tanımlarından modeller oluşturun
• Görüntüden 3D'ye: Tek veya birden fazla görüntüyü 3D nesnelere dönüştürün
• Çoklu görünümden 3D'ye: Birden fazla görüntü perspektifinden yüksek kaliteli modeller oluşturun

Oluşturulan modeller, GLB, GLTF, FBX ve OBJ dahil olmak üzere standart formatlarda dışa aktarılır ve çoğu 3D yazılımı ve oyun motoruyla uyumlu hale gelir.

Başlarken: Kimlik Doğrulama ve Kurulum

Adım 1: API Anahtarınızı Oluşturun

Herhangi bir API çağrısı yapmadan önce kimlik doğrulama kimlik bilgilerine ihtiyacınız vardır:

1. Tripo 3D platformunun dokümantasyon sayfasını ziyaret edin

2. "Yeni API Anahtarı Oluştur"a tıklayın

3. Anahtarınızı hemen kopyalayın (tsk_ ile başlar)

4. Güvenli bir şekilde saklayın; pencereyi kapattıktan sonra tekrar alamazsınız

Güvenlik Notu: API anahtarlarını asla istemci tarafı kodunda veya genel depolarda ifşa etmeyin. Ortam değişkenlerini veya güvenli sır yönetim hizmetlerini kullanın.

Adım 2: Python SDK'yı Kurun (İsteğe Bağlı)

REST API'yi herhangi bir HTTP istemcisiyle doğrudan kullanabilseniz de, resmi Python SDK entegrasyonu basitleştirir:

pip install tripo3d

SDK, kimlik doğrulamayı, eşzamansız görev sorgulamayı ve dosya indirmelerini otomatik olarak halleder.

Adım 3: Kurulumunuzu Doğrulayın

Kimlik doğrulamanızı bu temel cURL isteğiyle test edin:

export TRIPO_API_KEY="tsk_your_actual_key_here"

curl https://api.tripo3d.ai/v2/openapi/task \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer ${TRIPO_API_KEY}" \
  -d '{"type": "text_to_model", "prompt": "a simple wooden chair"}'

Başarılı bir yanıt, kimlik doğrulamanızın doğru çalıştığını gösteren bir görev kimliği döndürür.

Yöntem 1: Metinden 3D Model Oluşturma

Temel Uygulama

Metinden 3D oluşturma, doğal dil açıklamalarını 3D nesnelere dönüştürür. Bu, kavramsal tanımlardan varlık oluşturmak için iyi çalışır.

Python SDK Örneği:

import asyncio
from tripo3d import TripoClient, TaskStatus

async def generate_from_text():
    async with TripoClient(api_key="YOUR_API_KEY") as client:
        # Oluşturma görevini gönder
        task_id = await client.text_to_model(
            prompt="ahşap ayaklı eski bir deri koltuk",
            negative_prompt="düşük kalite, bulanık, bozuk",
            model_version="v2.5"
        )

        print(f"Görev gönderildi: {task_id}")

        # Tamamlanmayı bekle
        task = await client.wait_for_task(task_id, verbose=True)

        # Sonuçları indir
        if task.status == TaskStatus.SUCCESS:
            files = await client.download_task_models(task, "./output")
            for model_type, path in files.items():
                print(f"İndirilen {model_type}: {path}")
        else:
            print(f"Görev başarısız oldu: {task.status}")

asyncio.run(generate_from_text())

REST API Örneği:

curl -X POST https://api.tripo3d.ai/v2/openapi/task \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer ${TRIPO_API_KEY}" \
  -d '{
    "type": "text_to_model",
    "prompt": "ahşap ayaklı eski bir deri koltuk",
    "negative_prompt": "düşük kalite, bulanık, bozuk",
    "model_version": "v2.5"
  }'

Parametreleri Anlamak

İstem Mühendisliği İpuçları

• Malzemeler, renkler ve şekiller hakkında spesifik olun
• Stil tanımlayıcıları ekleyin (gerçekçi, çizgi film, düşük poligonlu)
• İlgili olduğunda ölçek referanslarını belirtin
• Daha iyi doku üretimi için ışıklandırma tercihlerini ekleyin

Yöntem 2: Görüntüden 3D Model Oluşturma

Tek Görüntü Dönüşümü

Tek bir fotoğrafı veya illüstrasyonu 3D modele dönüştürün. Bu, nesneyi düz bir açıdan gösteren net, iyi aydınlatılmış görüntülerle en iyi şekilde çalışır.

Python SDK Örneği:

import asyncio
from tripo3d import TripoClient, TaskStatus

async def generate_from_image():
    async with TripoClient(api_key="YOUR_API_KEY") as client:
        task_id = await client.image_to_model(
            image="./path/to/product-photo.jpg",
            texture_quality="high",
            auto_scale=True,
            face_limit=50000
        )

        print(f"Görüntü işleniyor: {task_id}")

        task = await client.wait_for_task(task_id, verbose=True)

        if task.status == TaskStatus.SUCCESS:
            files = await client.download_task_models(task, "./models")
            print(f"Model kaydedildi: {files}")

asyncio.run(generate_from_image())

Gelişmiş Parametreler

Çoklu Görünüm Oluşturma

Daha yüksek kaliteli sonuçlar için aynı nesnenin birden fazla açısını sağlayın:

async def generate_from_multiview():
    async with TripoClient(api_key="YOUR_API_KEY") as client:
        task_id = await client.multiview_to_model(
            images=[
                "./front-view.jpg",
                "./side-view.jpg",
                "./top-view.jpg"
            ],
            texture_quality="high"
        )

        task = await client.wait_for_task(task_id, verbose=True)

        if task.status == TaskStatus.SUCCESS:
            files = await client.download_task_models(task, "./output")

Çoklu görünüm oluşturma, tek görüntü dönüşümüne kıyasla önemli ölçüde daha iyi geometri ve doku detayı üretir.

Görev Durumunu ve Yoklamayı Anlamak

Tripo 3D API, istekleri eşzamansız olarak işler. Bir görevi gönderdikten sonra, engellemek yerine tamamlanması için yoklama yaparsınız.

Görev Yaşam Döngüsü

1. Submitted (Gönderildi): Görev kabul edildi ve kuyruğa alındı
2. Processing (İşleniyor): AI modeli 3D çıktıyı oluşturuyor
3. Success (Başarılı): Model indirilmeye hazır
4. Failed (Başarısız): Oluşturma sırasında bir hata oluştu

Manuel Yoklama (REST API)

curl https://api.tripo3d.ai/v2/openapi/task/{task_id} \
  -H "Authorization: Bearer ${TRIPO_API_KEY}"

Yanıt Yapısı:

{
  "code": 0,
  "data": {
    "task_id": "abc123",
    "status": "success",
    "output": {
      "model": "https://download-url/model.glb",
      "pbr_model": "https://download-url/model-pbr.glb"
    }
  }
}

Otomatik Yoklama (Python SDK)

SDK, yoklamayı otomatik olarak halleder:

task = await client.wait_for_task(
    task_id,
    verbose=True,  # İlerleme güncellemelerini göster
    timeout=300    # Saniye cinsinden maksimum bekleme süresi
)

Fiyatlandırma ve Kredi Sistemi

Tripo, farklı işlemlerin değişen miktarlarda kredi tükettiği kredi tabanlı bir fiyatlandırma modeli kullanır.

Fiyatlandırma Katmanları

*Yıllık faturalandırma: %20 indirim (Profesyonel için 190.80$/yıl, Gelişmiş için 478.80$/yıl)

Kredi Maliyetleri

• Metinden 3D'ye: Her üretim için ~30 kredi
• Görüntüden 3D'ye: Kalite ayarlarına bağlı olarak ~30-50 kredi
• Çoklu görünümden 3D'ye: ~60-80 kredi
• Dörtgen ağ çıktısı: Ek 0.05$ (yaklaşık 5 kredi)

Maliyet Optimizasyonu İpuçları

• Önizleme üretimleri için daha düşük face_limit değerleri kullanın
• Ücretli katmanlara geçmeden önce Temel planla test edin
• Eşzamanlı görev limitlerini en üst düzeye çıkarmak için benzer istekleri toplu işleyin
• Aynı varlıkları yeniden üretmekten kaçınmak için oluşturulan modelleri önbelleğe alın

Hata Yönetimi ve En İyi Uygulamalar

API Hatalarını Zarifçe Yönetin

from tripo3d import TripoClient, TripoAPIError

async def safe_generation():
    try:
        async with TripoClient(api_key="YOUR_API_KEY") as client:
            task_id = await client.text_to_model(
                prompt="detaylı bir uzay gemisi"
            )
            task = await client.wait_for_task(task_id)

            if task.status == TaskStatus.SUCCESS:
                files = await client.download_task_models(task, "./output")
                return files
            else:
                print(f"Üretim başarısız oldu: {task.status}")
                return None

    except TripoAPIError as e:
        if e.status_code == 401:
            print("Kimlik doğrulama başarısız. API anahtarınızı kontrol edin.")
        elif e.status_code == 429:
            print("Oran limiti aşıldı. Tekrar denemeden önce bekleyin.")
        elif e.status_code >= 500:
            print("Sunucu hatası. Bir gecikmeden sonra tekrar deneyin.")
        else:
            print(f"API hatası: {e}")
        return None

Üretim İçin En İyi Uygulamalar

1. Geçici hatalar (500 seviyesi hataları) için yeniden deneme mantığı uygulayın
2. Görev karmaşıklığına göre uygun zaman aşımları ayarlayın
3. Hizmet kesintisini önlemek için kredi kullanımını izleyin
4. Pahalı işlemleri göndermeden önce girişleri doğrulayın
5. Hata ayıklama ve denetim için görev kimliklerini saklayın
6. Agresif yoklama yerine webhook'ları kullanın (varsa)

Oran Limiti

Plan katmanınıza göre eşzamanlı görev limitlerine uyun. Limitleri aşmak 429 hatalarına neden olur:

from asyncio import Semaphore

async def batch_generate(prompts, max_concurrent=10):
    semaphore = Semaphore(max_concurrent)

    async def generate_with_limit(prompt):
        async with semaphore:
            async with TripoClient(api_key="YOUR_API_KEY") as client:
                task_id = await client.text_to_model(prompt=prompt)
                return await client.wait_for_task(task_id)

    tasks = [generate_with_limit(p) for p in prompts]
    return await asyncio.gather(*tasks)

Popüler Çerçevelerle Entegrasyon

Flask Web Uygulaması

from flask import Flask, request, jsonify
from tripo3d import TripoClient
import asyncio

app = Flask(__name__)

@app.route('/generate-3d', methods=['POST'])
def generate_model():
    data = request.json
    prompt = data.get('prompt')

    if not prompt:
        return jsonify({'error': 'İstem gerekli'}), 400

    async def generate():
        async with TripoClient(api_key="YOUR_API_KEY") as client:
            task_id = await client.text_to_model(prompt=prompt)
            return {'task_id': task_id}

    result = asyncio.run(generate())
    return jsonify(result)

@app.route('/check-status/<task_id>')
def check_status(task_id):
    async def get_status():
        async with TripoClient(api_key="YOUR_API_KEY") as client:
            task = await client.get_task(task_id)
            return {'status': task.status}

    result = asyncio.run(get_status())
    return jsonify(result)

Node.js Express Örneği

const express = require('express');
const axios = require('axios');
const app = express();

app.post('/generate', async (req, res) => {
  const { prompt } = req.body;

  try {
    const response = await axios.post(
      'https://api.tripo3d.ai/v2/openapi/task',
      {
        type: 'text_to_model',
        prompt: prompt
      },
      {
        headers: {
          'Authorization': `Bearer ${process.env.TRIPO_API_KEY}`,
          'Content-Type': 'application/json'
        }
      }
    );

    res.json({ task_id: response.data.data.task_id });
  } catch (error) {
    res.status(500).json({ error: error.message });
  }
});

Apidog ile API Entegrasyonlarını Yönetme

Karmaşık uygulamalar genellikle birden fazla API'yi aynı anda entegre eder. Farklı hizmetler arasında kimlik doğrulamayı yönetmek, uç noktaları test etmek ve performansı izlemek zorlayıcı hale gelir.

Apidog, Tripo 3D API ve diğer hizmetlerle çalışan geliştiriciler için birleşik API yönetimi sağlar:

Temel Özellikler:

• Görsel istek oluşturucu: Manuel JSON biçimlendirmesi olmadan API çağrıları oluşturun
• Ortam yönetimi: Geliştirme, hazırlık ve üretim kimlik bilgileri arasında geçiş yapın
• Otomatik test: Yanıtları doğrulayın ve entegrasyon sorunlarını erken yakalayın
• Ekip işbirliği: API koleksiyonlarını ve dokümantasyonunu geliştiricilerle paylaşın
• Performans izleme: Tüm uç noktalarda yanıt sürelerini ve hata oranlarını takip edin

Tripo 3D API isteklerinizi Apidog'a aktarın, şablon olarak kaydedin ve tek tıklamayla yürütün. Yerleşik analitikler aracılığıyla kredi tüketim modellerini izleyin ve optimizasyon fırsatlarını belirleyin.

Sonuç

Tripo 3D API, yapay zeka destekli 3D model üretimini uygulamalara entegre etmenin teknik engellerini ortadan kaldırır. Basit REST arayüzü ve resmi Python SDK'sı, geliştiricilerin metinden 3D'ye ve görüntüden 3D'ye yeteneklerini haftalar yerine saatler içinde eklemesini sağlar.

Entegrasyonunuzu prototiplemek için ücretsiz Temel planla başlayın. Çıktı kalitesini anlamak için farklı istem stillerini ve görüntü girişlerini test edin. Ücretli katmanlara geçmeden önce kredi tüketim modellerini izleyin.

Platformun eşzamansız işleme modeli, üretim iş yükleri için iyi ölçeklenirken, standart dışa aktarma formatları mevcut 3D işlem hatları ve oyun motorlarıyla uyumluluk sağlar.