TRAE API Anahtarı Kurulumu — Aracı Üçüncü Taraf Anahtar Yapılandırma Kılavuzu
APIMaster.ai'ı TRAE IDE Agent'da üçüncü taraf API olarak yapılandırın. GPT, Claude, DeepSeek ve daha fazlası için base URL ve model ID ile özel OpenAI Chat Completions ayarlarını kullanın.
TRAE IDE (ByteDance'in yapay zeka odaklı kodlama IDE'si), görevleri anlayan, işleri planlayan ve kodu otonom olarak düzenleyen bir Agent modu içerir. TRAE, üçüncü taraf API anahtarları aracılığıyla özel modelleri destekler. APIMaster.ai, OpenAI Chat Completions ile uyumlu bir uç nokta sağlar — TRAE'ye bağlanmak için özel bir model ekleyin.
Önce API Anahtarı Alın. Anahtarlar yalnızca kendi bilgisayarınızda kalır. İstekler başarısız olursa bağlantı testini kullanın.
Ön Koşullar
- TRAE IDE yüklü (trae.ai veya trae.cn).
- Konsoldan APIMaster API Anahtarı.
- Marketplace üzerinden hedef model id (ör.
gpt-5.5,claude-sonnet-4-6,deepseek-v4-pro).
Adım 1 — Agent'ı açın ve bir model ekleyin
- TRAE IDE'yi açın ve Agent sohbetine gidin (giriş çubuğunda
@Agent). - Sağ alttaki model seçiciye (mevcut model adının yanındaki açılır menü) tıklayın.
- Menünün altında Add Model (添加模型) öğesine tıklayın.

Adım 2 — Özel yapılandırma
Edit Model iletişim kutusunda Custom Configuration (自定义配置) sekmesini açın ve aşağıdaki alanları doldurun:
| Alan | Değer |
|---|---|
| API format | OpenAI Chat Completions |
| Custom request URL | https://apimaster.ai/v1 (sonda eğik çizgi yok) |
| Full URL | Kapalı (TRAE otomatik olarak /chat/completions ekler) |
| Model ID | Marketplace model id, ör. gpt-5.5, claude-sonnet-4-6 |
| Multimodal | Model görselleri destekliyorsa açık; yalnızca metin için kapalı |
| API Key | APIMaster anahtarınız |

Notlar:
- OpenAI uyumlu bir uç nokta kullanın:
https://apimaster.ai/v1. TRAE, yola/chat/completionsekler. - Model ID, marketplace kimliği ile tam olarak eşleşmelidir.
- Kaydetmek için Confirm (确认) öğesine tıklayın.
Adım 3 — Özel modelinizi seçin
- Model seçiciyi tekrar açın.
- Custom Models (自定义模型) altında eklediğiniz modeli (ör.
gpt-5.5) seçin. - Alt çubukta model kimliğiniz görünmelidir.

Adım 4 — Agent sohbetini test edin
- Agent'a bir test mesajı gönderin (ör.
hiveya küçük bir kodlama görevi). - Normal bir yanıt, kurulumun çalıştığı anlamına gelir.
- TRAE, sağlayıcı olarak
custom_openai_compatiblegösteriyorsa, istekler OpenAI uyumlu protokol aracılığıyla APIMaster üzerinden geçiyordur.

Örnek model kimlikleri
| model id | Notlar |
|---|---|
gpt-5.4 / gpt-5.5 |
GPT |
claude-haiku-4-5 |
Claude Haiku |
claude-sonnet-4-6 |
Claude Sonnet |
claude-opus-4-7 / claude-opus-4-8 |
Claude Opus |
deepseek-v4-pro / deepseek-v4-flash |
DeepSeek |
gemini-2.5-pro / gemini-2.5-flash |
Gemini |
Kimlikleri marketplace sitesinden kopyalayın — takma adları tahmin etmeyin.
Sorun Giderme
| Sorun | Çözüm |
|---|---|
| 401 / Geçersiz API Anahtarı | Anahtarı yeniden yapıştırın; konsolda etkin olduğunu kontrol edin |
| 404 / model bulunamadı | Model ID'yi marketplaceden yeniden kopyalayın |
| Zaman aşımı | URL https://apimaster.ai/v1 olmalıdır (sonda eğik çizgi yok); ağ/proxy ayarlarını kontrol edin |
| Add Model düğmesi yok | Agent sohbet model seçicisini (sağ alt) kullanın, Builder kenar çubuğunu değil |
| Hâlâ yerleşik modelde | Custom Models altında girişinizi seçin |
| Multimodal hataları | Model yalnızca metin ise Multimodal'ı kapatın |
Kontrol Listesi
- Agent model seçicisi açıldı → Add Model
- API format = OpenAI Chat Completions
- Custom request URL =
https://apimaster.ai/v1(Full URL kapalı) - Model ID marketplace sitesinden alındı
- API Key = APIMaster anahtarı
- Özel model seçildi; Agent başarıyla yanıt veriyor