Tripo CLI: Yapay zekâ metin ve görselleri 3B modellere dönüştürsün

Tripo CLI, yapay zekâ ajanları için tasarlandı ve 3B üretimi sohbet etmek kadar basit hâle getirir. İster Codex, Claude Code, Cursor gibi bir yapay zekâ kodlama aracında ister doğrudan CLI’de olun; doğal dilde tek bir açıklama, bir görsel veya mevcut bir model, 3B modeller, animasyonlar ve diğer varlıkları üretmek ya da dönüştürmek için yeterlidir. CLI tüm süreci otomatik olarak tamamlar — API’leri, model sürümlerini veya karmaşık parametreleri anlamanız gerekmez.

CLI mi yoksa API mi kullanmalıyım?

Tripo’nun iki farklı biçimi vardır — doğru olanı seçmek için on saniyenizi ayırın:

Ürün	Şunun için ideal	Nereye gitmeli
Tripo CLI (bu sayfa)	Yeni başlayanlar için: popüler vibe coding araçlarıyla yapay zekâ 3B yeteneklerini hızla kullanmak	Okumaya devam edin
Tripo API	Profesyonel geliştiriciler için: yapay zekâ 3B yeteneklerini web sitelerine, uygulamalara veya kendi iş sistemlerinize entegre etmek	Hızlı başlangıç

Emin değil misiniz? Önce bu sayfayı deneyin: kurulum ücretsizdir ve krediler yalnızca gerçekten bir model ürettiğinizde harcanır.

Kurulum ve oturum açma (iki yoldan birini seçin)

Aşağıdaki iki kurulum yolundan birini seçin.

Birinci yol: yapay zekâ benim için kursun (önerilen)

Cursor, Claude Code, Codex veya terminal komutları çalıştırabilen başka bir yapay zekâ asistanını zaten kullanıyorsanız en kolay yol budur. Aşağıdaki istemi kopyalayıp olduğu gibi asistanınıza gönderin:

Tripo CLI'yi benim için yapılandır ve her adımı açıkla. Node.js 20 veya üzerinin kurulu olduğunu doğrula, ardından npm install -g tripo-cli komutunu çalıştır. Tarayıcıda tripo login işlemini tamamlamamı iste; API anahtarını sohbete yapıştırmamı isteme. Son olarak tripo doctor komutunu çalıştır ve kimlik doğrulama, ağ ve bakiye kontrollerinin geçip geçmediğini söyle.

Sonrasında şunlar olur:

Yapay zekâ bilgisayarınızı kontrol eder; Node.js eksikse önce onu kurmanıza yardımcı olur;
Yapay zekâ kurulum komutunu çalıştırır;
Sıra sizde: tarayıcıda Tripo oturum açma sayfası açılır — oturum açın ve terminalinizde görünen doğrulama kodunu onaylayın (bu adımı sizin yapmanız gerekir; yapay zekâya asla hiçbir anahtar göndermeyin);
Yapay zekâ tripo doctor komutunu çalıştırır; tüm kontroller geçtiğinde kurulum tamamlanmış demektir.

Ardından doğrudan bir sonraki bölüm olan “İlk 3B modelinizi oluşturun” kısmına geçebilirsiniz.

Sorun mu var? Yapay zekâ takıldı ya da bir hatayla karşılaştı

Terminaldeki hatayı olduğu gibi yapay zekâya geri yapıştırın ve devam etmesine izin verin; sorunların çoğunu kendisi çözebilir;
Oturum açma tamamlanmadı: oturum açma sayfasını yeniden açın ve onaylamadan önce terminalinizde görünen doğrulama kodunu bir kez daha kontrol edin;
Hiçbiri işe yaramazsa aşağıdaki “İkinci yol: kendim kurayım” bölümüne geçin — yalnızca üç komuttan ibarettir.

İkinci yol: kendim kurayım

Yapay zekâ asistanınız yok mu? Sorun değil — tüm süreç üç komuttan oluşur.

1. Adım: Tripo CLI’yi kurun

Bu komut, bilgisayarınıza tripo komutunu kurar:

Bash

npm install -g tripo-cli

Normalde ilerleme kırmızı hata metni görünmeden tamamlanır; bu, kurulumun başarılı olduğu anlamına gelir.

Sorun mu var? npm bulunamadı ya da izin hatası

npm bulunamadı: Node.js henüz kurulu değil. Node.js web sitesinden güncel LTS sürümünü (20 veya üzeri) kurun, ardından terminali yeniden açıp tekrar deneyin;
macOS’ta izin hatası (EACCES): bunun yerine sudo npm install -g tripo-cli komutunu çalıştırın ve istendiğinde bilgisayarınızın parolasını girin;
Windows “running scripts is disabled” (betik çalıştırma devre dışı) diyorsa: PowerShell’i yönetici olarak yeniden açıp tekrar deneyin.

2. Adım: Tripo hesabınızda oturum açın

Bash

tripo login

Tarayıcınız otomatik olarak bir yetkilendirme sayfası açar (henüz hesabınız yoksa önce orada kayıt olun). Sayfada bir doğrulama kodu görünür — yalnızca terminalinizde görünen kodla eşleştiğini doğruladıktan sonra onaylayın. Oturum açtıktan sonra terminal giriş yaptığınızı doğrular.

Doğrulama kodunu gösteren Tripo CLI tarayıcı cihaz yetkilendirme sayfası

Sorun mu var? Tarayıcı açılmadı ya da oturum açma tamamlanmadı

Oturum açma tamamlanmadı: tripo login komutunu yeniden çalıştırın ve yalnızca terminalinizde görünen kodu bir kez daha kontrol ettikten sonra onaylayın;
Tarayıcı hiç tepki vermiyor: terminalde yazdırılan URL’yi elle kopyalayıp tarayıcınıza yapıştırın;
Tarayıcı yetkilendirmesi geçici olarak kullanılamıyor: CLI bunun yerine API anahtarı sayfasını açar — bu bölümün sonundaki “Yedek oturum açma ve bölgeler” kısmına bakın.

3. Adım: her şeyin hazır olduğunu kontrol edin

Bash

tripo doctor

Sırasıyla oturum durumunuzu, ağ erişiminizi ve kredi bakiyenizi kontrol eder. Üçü de geçtiğinde kurulum tamamlanmıştır.

Sorun mu var? Kontrollerden biri başarısız oldu

Kimlik doğrulama başarısız: oturum açma tamamlanmamış — tripo login komutunu çalıştırıp yeniden oturum açın;
Ağ kontrolü başarısız: bilgisayarınızın web sayfalarını açabildiğinden emin olun; şirket veya kampüs ağlarında proxy gerekebilir;
Bakiye kontrolü başarısız: yeterli krediniz yok; henüz hiçbir üretim başlamadı ve ücret alınmadı. Faturalandırma sayfasını açmak için tripo topup komutunu çalıştırın.

Yedek oturum açma ve bölgeler (yalnızca tarayıcıyla oturum açma kullanılamıyorsa)

Zaten bir API anahtarınız varsa tripo login --key tsk_... komutunu çalıştırın veya TRIPO_API_KEY ortam değişkenini ayarlayın;
API anahtarı bir hesap kimlik bilgisidir: asla sohbete, kaynak koduna, ekran görüntülerine veya günlüklere yapıştırmayın;
Aynı kurulum hem uluslararası hem de Çin ana karası hesaplarıyla çalışır: CLI, anahtarınızı iki bölgede de sınar ve anahtarı kabul eden bölgeyi otomatik olarak kaydeder.

İlk 3B modelinizi oluşturun

1. Adım: tek bir cümleden üretin

Tırnak içindeki sözcükler sizin isteminizdir — bunları oluşturmak istediğiniz şeyle değiştirin:

Bash

tripo make "a cute low poly fox"

Komut çalışırken terminali açık tutun. Tripo CLI doğru iş akışını ve modeli seçer, görevin bitmesini bekler ve dosyaları bulunduğunuz dizindeki tripo-out klasörüne indirir. Sürecin tamamı genellikle birkaç dakika içinde biter ve az miktarda kredi harcar.

Sorun mu var? Üretim başlamadı ya da yarıda kesildi

Yetersiz kredi: modeliniz üretilmeye başlamadı ve ücret alınmadı. Kredi eklemek için tripo topup komutunu çalıştırın, sonra yeniden deneyin;
Ağ hatası: bilgisayarınızın internete bağlı olduğundan emin olun, ardından aynı komutu yeniden çalıştırın;
Görev başarısız oldu: alınan krediler otomatik olarak iade edilir — farklı bir açıklama deneyin.

2. Adım: önizlemeyi açın

Bash

tripo view @last

@last, “en son görev” anlamına gelir. Tarayıcınızda sürükleyerek döndürebileceğiniz etkileşimli bir 3B önizleme açılır — modelinizi gördüğünüzde başardınız demektir!

İlk başarıdan sonra: artık elinizde neler var

Dosyalar nerede: tripo-out altındaki yeni bir klasörde indirilen 3B model ve görevin nasıl oluşturulduğunu kaydeden task.json bulunur; sunucu bir önizleme görseli sağlarsa preview.png de eklenir.
Yeniden açmak için: istediğiniz zaman tripo view @last komutunu çalıştırın veya herhangi bir model dosyasını açmak için tripo view <file> kullanın.
Ne kadar harcadınız: kredi bakiyenizi görmek için tripo balance komutunu çalıştırın.
Komut ezberlemekten hoşlanmıyor musunuz? Yönlendirmeli etkileşimli menüyü açmak için yalnızca tripo yazın — oturum açma, üretim, önizleme ve kredi yükleme hep oradadır.
Sonraki adımlar: görsellerden üretin (bir sonraki bölüm), kontrolü yapay zekâ asistanına bırakın (“Yapay zekâ kodlama aracıları CLI’de ustalaşsın”) ya da toplu işleyin (“Hazır iş akışları ve işlem hatları”).

Görselden veya mevcut bir modelden üretin

Metin örneği çalıştıktan sonra bunun yerine yerel dosyalar verebilirsiniz. Aşağıdaki concept.png, front.png ve hero.glb örnek adlardır — bunları kendi dosya yollarınızla değiştirin:

Bash

tripo make concept.png --for print
tripo make front.png back.png
tripo make hero.glb --then texture,rig
tripo make @last --then convert:fbx

1. satır: bir konsept görselini baskıya hazır bir modele dönüştürür;
1. satır: daha isabetli ayrıntılar için ön ve arka görsellerden birlikte üretir;
1. satır: mevcut bir modele dokulandırma ve rigging uygular;
1. satır: en son sonucu FBX’e dönüştürür.

Yapay zekâ kodlama aracıları CLI’de ustalaşsın

Yapay zekâ kodlama aracısı kullanmıyorsanız bu bölümü atlayın. npm paketi, bir aracının CLI’yi doğru kullanabilmesi için komut referansları, senaryo tarifleri ve hata kurtarma rehberi içeren bir Agent Skill ile birlikte gelir. Talimatların tamamını veya tek bir konuyu terminalde görüntülemek için aracınızdan şu komutları çalıştırmasını isteyin:

Bash

tripo docs --llm
tripo docs --topic commands/make
tripo docs --topic examples/game-asset

Skill ile birlikte gelen dosyalar

skill/
├── SKILL.md
├── common-errors.md
├── commands/
│   ├── account.md
│   ├── batch.md
│   ├── generate.md
│   ├── make.md
│   ├── process.md
│   ├── task.md
│   └── view.md
└── examples/
    ├── animation.md
    ├── ar-web.md
    ├── film.md
    ├── game-asset.md
    ├── pipes.md
    └── print.md

Komut referansı

Bu tabloyu ezberlemenize gerek yok: günlük kullanımda yeni kullanıcılara yalnızca tripo (etkileşimli menü), tripo make (üretim), tripo view (önizleme) ve tripo doctor (sağlık kontrolü) yeter. Gerisini yalnızca belirli bir ihtiyaç doğduğunda açın.

Tam komut tablosunu ve yaygın seçenekleri göster

Komut	İşlevi
`tripo make <input...>`	Tek komutla üretir, işler ve indirir
`tripo ai [description]`	Bir işi planlar, onaylatır ve yürütür
`tripo view [task\|file]`	Etkileşimli yerel 3B önizlemeyi açar
`tripo redo [task]`	İsteği yeni bir seed ile tekrarlar
`tripo login / logout / whoami / use`	Yetkilendirir ve adlandırılmış hesap profilleri arasında geçiş yapar
`tripo topup / balance / usage`	Bölgesel faturalandırmayı açar ve kredileri inceler
`tripo generate <endpoint>`	Sekiz üretim endpoint’inin tamamına doğrudan erişir
`tripo model / anim / mesh <step>`	İyileştirme, dokulandırma, rigging, dönüştürme, segmentasyon ve diğer işleme adımlarını çalıştırır
`tripo task get/list/watch`	Görevleri sorgular, listeler veya bekler
`tripo history [--limit <n>]`	Son yerel görev geçmişini gösterir
`tripo files upload <path>`	Bir dosya yükleyip dosyanın `file_token` değerini döndürür
`tripo batch run <manifest.yaml>`	Eşzamanlılık ve yeniden denemelerle kaldığı yerden devam edebilen toplu işlem hatları çalıştırır
`tripo config / doctor`	Ayarları yönetir ve yerel ortamı tanılar
`tripo docs [--topic <topic>]`	Paketle gelen Agent ve komut dokümantasyonunu görüntüler
`tripo mcp`	CLI’yi MCP sunucusu olarak çalıştırır
`tripo completion <shell>`	Bash, Zsh veya Fish için komut tamamlaması üretir

make, ai ve generate komutlarının yanı sıra model, anim ve mesh altındaki işleme alt komutları -o/--out, --no-wait, --no-download, --name, --timeout, --notify ve tekrarlanabilir --param key=value seçeneklerini destekler. Genel otomasyon seçenekleri arasında --json, --yes, --quiet, --no-open ve --profile bulunur.

Hazır iş akışları ve işlem hatları

Bu bölüm ileri düzeydedir; ilk üretiminiz için gerekli değildir. Yedi yerleşik preset, --for <preset> aracılığıyla yararlı parametreleri ve işleme adımlarını tek seferde uygular:

game-mobile · game-pc · film · print · ar-web · anim · toy

Bash

# Mobile game asset: low-poly generation, texture, then FBX
tripo make "sci-fi crate" --for game-mobile

# Print asset: watertight output, STL, and a flat bottom
tripo make "chess knight" --for print

# Explicit processing chain
tripo make cat.png --then texture,rig,convert:fbx

# The same chain as NDJSON pipes
tripo make cat.png --json | tripo model texture --json | tripo anim rig --json

# Resumable batch processing
tripo batch run assets.yaml --concurrency 2

@last, @2 ve @name gibi görev referansları, görev kimliğinin kabul edildiği her yerde kullanılabilir.

Birden çok hesap ve bölge

Yalnızca bir Tripo hesabı kullanıyorsanız bu bölümü atlayın. Kimlik bilgileri adlandırılmış profillerde saklanır; bu nedenle ikinci bir hesapta oturum açmak ilk hesabın üzerine yazmaz:

Bash

tripo login
tripo login --profile work-cn
tripo use
tripo whoami
tripo make "a fox" --profile work-cn
tripo logout

Her profil kendi anahtarını ve bölgesini tutar. TRIPO_PROFILE ortam değişkeni geçerli ortam için bir profil seçer; TRIPO_API_KEY ise tüm profilleri atlar ve en yüksek önceliğe sahiptir.

Yapay zekâ kodlama aracıları için notlar

İnsan kullanıcılar bu bölümü atlayabilir. Bu kurallar, yapay zekâ kodlama aracılarının görevleri doğru biçimde beklemesine ve makinece okunabilir çıktıyı işlemesine yardımcı olur.

tripo make ve tripo task watch engelleyici komutlardır. Başka bir sorgulama döngüsü uygulamak yerine işlemin bitmesini bekleyin.
--json kullanıldığında tek seferlik komutların çoğu stdout’a tek bir son JSON satırı yazar. tripo task watch --json ise bunun yerine NDJSON ilerleme olaylarını ve ardından nihai sonucu akış halinde gönderir.
preview.png varsa bir işlem hattını sürdürmeye veya tripo redo çalıştırmaya karar vermeden önce dosyayı inceleyin.
Parametre uydurmayın veya eski model sürümlerini zorlamayın. Desteklenen seçenekler için tripo docs --topic ... kullanın.
Low-poly isteği veya 20.000 ya da daha az yüz sınırı tripo-p1 modelini seçer; diğer işler varsayılan olarak tripo-v3.1 kullanır.

Çıkış kodu tablosunu göster

Çıkış kodu	Anlamı
`0`	Başarılı
`1`	Beklenmeyen veya dahili hata
`2`	Geçersiz kullanım veya parametreler
`3`	Kimlik doğrulama hatası
`4`	Yetersiz kredi
`5`	İçerik politikası nedeniyle reddedildi
`6`	Görev başarısız oldu; krediler otomatik olarak iade edilir
`7`	Ağ hatası
`8`	Kaynak bulunamadı
`9`	Hız sınırına ulaşıldı; bekleme süresini artırarak yeniden deneyin

Otomasyon için ortam değişkenleri

Normal etkileşimli kullanımda ortam değişkenlerine gerek yoktur; bunlar CI, betikler ve ileri düzey aracı iş akışları içindir. Unutmayın: bir API anahtarını asla bir depoya commit etmeyin, dokümantasyona yapıştırmayın, ekran görüntülerine veya günlüklere eklemeyin.

Ortam değişkeni tablosunu göster

Değişken	Amaç
`TRIPO_API_KEY`	API key; en yüksek önceliğe sahiptir ve CI veya Agent’lar için uygundur
`TRIPO_PROFILE`	Adlandırılmış hesap profili; `--profile` ile eşdeğerdir
`TRIPO_REGION`	İsteğe bağlı `ov` veya `cn` geçersiz kılması; normalde otomatik algılanır
`TRIPO_API_BASE_URL`	API endpoint geçersiz kılması
`TRIPO_PLATFORM_BASE_URL`	Platform endpoint geçersiz kılması
`TRIPO_HOME`	Yapılandırma ve geçmiş dizini; varsayılanı `~/.tripo`
`TRIPO_LLM_BASE_URL`	`tripo ai` için isteğe bağlı, OpenAI uyumlu endpoint
`TRIPO_LLM_API_KEY`	`tripo ai` için isteğe bağlı LLM anahtarı
`TRIPO_LLM_MODEL`	`tripo ai` için isteğe bağlı LLM modeli