Wijs Trae Agent naar één endpoint voor elk model.

Snel antwoord: één providerblok, één modelblok.

De huidige configuratie van Trae Agent is YAML: trae_config.yaml in de projectmap, met drie relevante blokken. model_providers definieert endpoints, en elke vermelding neemt api_key, provider en base_url, dus een OpenAI-compatibele gateway is gewoon een provider van het type openai met zijn base_url gewisseld. models definieert genoemde modelconfigs die naar een provider verwijzen via model_provider. agents bindt trae_agent aan een van die modelnamen. De upstream-README toont precies deze vorm voor routering via een multi-modelservice: een openai-providervermelding wiens base_url naar de /v1-root van de service wijst. Voor APIsRouter is dat https://api.apisrouter.com/v1, en het modelveld neemt dan elk catalogus-ID als platte string, Claude- en Kimi-ID's inbegrepen, omdat het providertype alleen het verzoekformaat beslist, niet de leverancier.

model_providers:
  apisrouter:
    api_key: your_apisrouter_api_key
    provider: openai
    base_url: https://api.apisrouter.com/v1

models:
  trae_agent_model:
    model_provider: apisrouter
    model: claude-sonnet-4-6
    max_tokens: 4096
    temperature: 0.5

Hoe Trae Agent intern is bekabeld.

Trae Agent (bytedance op GitHub, ongeveer 12K sterren) is de onderzoeksgerichte software-engineering-agent van ByteDance voor de commandoregel: geef trae-cli een taak en het werkt eraan via een transparante toollus, bash, bestandsbewerking en sequentieel denken behoren tot de ingebouwde tools, tot een configureerbare max_steps. Het is doelbewust modulair, wat waarom de config providers, modellen en agents scheidt: dezelfde provider kan verschillende modelconfigs ondersteunen, en wisselen waarop de agent draait is een wijziging van één regel naar een naamverwijzing. Twee modelslots doen ertoe in de praktijk. trae_agent_model is de hoofdlus, het model dat de redenering, tool-aanroepen en bewerkingen doet, waar max_steps van tweehonderd betekent dat één taak een lange reeks gefactureerde aanroepen kan zijn. lakeview_model drijft Lakeview aan, de stapsamenvattingsfunctie van Trae die korte leesbare samenvattingen produceert van wat de agent bij elke stap deed. Lakeview vuurt vaak en zijn output is vluchtig proza, wat het schoolvoorbeeldslot maakt voor een snel ID terwijl de hoofdlus een frontier-ID behoudt. Configuratie resolveert uit meer dan de YAML: de CLI accepteert --provider- en --model-flags per run, en providerspecifieke omgevingsvariabelen, OPENAI_API_KEY en OPENAI_BASE_URL onder de gedocumenteerde set, voeden dezelfde instellingen. De flags zijn hoe je een tweede model A/B't zonder het bestand aan te raken.

Volledige instelling: agent, Lakeview, en een run.

De volledige config bindt de agent aan een hoofdmodel en Lakeview aan een snel model, beide via dezelfde providervermelding. Merk de indirectie op: agents.trae_agent.model noemt een vermelding in models, en elke models-vermelding noemt een provider via model_provider. Een tikfout in beide referenties breekt de keten, houd de drie namen dus consistent. Eén historische opmerking die de meeste verwarrende tutorials verklaart: de configuratie van Trae Agent was vroeger trae_config.json, en de repo documenteert dat formaat nu als legacy met YAML als de huidige vorm. Gidsen die JSON tonen beschrijven een oudere layout; de sleutels migreerden, de concepten bleven behouden. Als je een oud JSON-configbestand hebt, dekt de legacy-config-doc van de repo de mapping. De één-sleutel-invalshoek is het waard om specifiek voor deze tool te benoemen. De native providerlijst van Trae Agent overspant Amerikaanse en Chinese leveranciers, wat normaal een account en sleutel per leverancier betekent, sommige moeilijk te verkrijgen afhankelijk van waar je zit. Achter één gatewayvermelding zijn claude-sonnet-4-6, gpt-5.5, deepseek-v4-pro, glm-5.2 en kimi-k2.7-code allemaal één model-string verwijderd, op één sleutel, met één saldo, aan welke kant van de Stille Oceaan je ook ontwikkelt.

agents:
  trae_agent:
    enable_lakeview: true
    model: trae_agent_model
    max_steps: 200
    tools:
      - bash
      - str_replace_based_edit_tool
      - sequentialthinking
      - task_done

model_providers:
  apisrouter:
    api_key: your_apisrouter_api_key
    provider: openai
    base_url: https://api.apisrouter.com/v1

models:
  trae_agent_model:
    model_provider: apisrouter
    model: claude-sonnet-4-6
    max_tokens: 4096
    temperature: 0.5
  lakeview_model:
    model_provider: apisrouter
    model: claude-haiku-4-5-20251001
    max_tokens: 4096
    temperature: 0.5

Modellen kiezen voor de agentlus.

De flags --provider en --model maken de vergelijkingsworkflow concreet: draai dezelfde taak tweemaal met verschillende flags, lees stappen-tot-klaar en het geprijsde gebruik per model in de console, en promoveer de winnaar naar trae_config.yaml.

• De hoofdlus is langdurig toolwerk: bestanden lezen, bewerken, bash draaien, beoordelen wanneer de taak klaar is. claude-sonnet-4-6 en gpt-5.5 houden een plan van tweehonderd stappen samen; dit slot is de laatste plek om op te besparen.
• Lakeview is hoogfrequente, laag-inzet-samenvatting. claude-haiku-4-5-20251001 of deepseek-v4-flash houdt het effectief gratis naast de uitgaven van de hoofdlus.
• kimi-k2.7-code en glm-5.2 zijn serieuze kandidaten voor de hoofdlus op codebases met Chinese commentaren, commitgeschiedenis of documentatie; een tweetalige repo is waar ze beter presteren dan Engels-eerst-modellen op begrip, niet alleen op prijs.
• deepseek-v4-pro is de volumekeuze voor batchruns, dezelfde fix vegen over veel repo's of de agent draaien in CI, waar kosten per taak vermenigvuldigen.
• max_steps is je kostenregulator. Een model dat afdwaalt verbrandt stappen; vergelijk bij het testen van kandidaten stappen-tot-klaar op dezelfde taak, niet tokens per verzoek.

Betaal naar gebruik · onder officiële prijzen

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Faalmodi specifiek voor Trae Agent.

De JSON-versus-YAML-verwarring leidt alles. Een trae_config.json gekopieerd van een oudere gids wordt in het beste geval gelezen als legacy en in het slechtste geval genegeerd, en het symptoom is dat de CLI zich gedraagt alsof je nooit iets hebt geconfigureerd. Huidige opstellingen horen in trae_config.yaml; migreer oude bestanden met de legacy-config-doc van de repo in plaats van sleutelnamen te raden. De keten van drie namen breekt stilletjes. agents.trae_agent.model moet een models-vermelding noemen, en die vermelding's model_provider moet een model_providers-vermelding noemen. Hernoem er een en niet de andere en de run faalt bij opstarten met een resolutiefout in plaats van een verzoekfout, wat je naar de YAML wijst, niet naar het netwerk. base_url wil de /v1 inbegrepen, matchend met het upstream-voorbeeld dat naar de /v1-root van een router wijst. Een kale host produceert 404's zodra de client het chat-completions-pad toevoegt. Lakeview die faalt terwijl de agent werkt betekent dat lakeview_model verwijst naar een ID dat het endpoint niet bedient, gemakkelijk te missen omdat je het hoofdmodel testte en het tweede slot vergat. En omgevingsvariabelen die stilletjes een provider ondersteunen waarvan je dacht dat hij bestandsgeconfigureerd was, OPENAI_API_KEY in het bijzonder, zijn het waard om te controleren wanneer authenticatie inconsistent gedraagt tussen shells.

Wie routeert Trae Agent via een gateway.

• Developers die Claude of GPT de agentlus willen laten aandrijven en GLM, Kimi of DeepSeek een flag verwijderd, zonder een account bij elke leverancier te houden.
• Tweetalige teams die werken over Chinese en Engelse codebases, voor wie het sterkste model per repo uit beide ecosystemen kan komen, aanspreekbaar via één sleutel.
• Engineers die batch- of CI-agenttaken draaien, waar gebruikstracking per sleutel een vloot trae-cli-runs verandert in een leesbaar kostenrapport.
• Onderzoekers die agentmodellen benchmarken, aangezien Trae Agent gebouwd is voor ablatiestijl-vergelijking en de gateway elke kandidaat dezelfde wijziging van één flag maakt.
• Developers zonder toegang tot de facturering van een bepaalde leverancier. Toegang op basis van opwaarderen zonder kaartvereiste verwijdert de aanmeldingsafhankelijkheid per provider.

Verifieer het endpoint en debug de eerste taak.

Bevestig dat het endpoint je ID's bedient voor de eerste run: de /v1/models-lijst met je sleutel is de gezaghebbende schrijfwijze voor elk modelveld in de YAML, zowel het hoofdslot als het Lakeview-slot. Fouten bij de eerste run sorteren netjes. Een configresolutiefout vóór enig verzoek is de keten van drie namen of een legacy-JSON-bestand. Een 401 is de api_key in het providerblok, of een omgevingsvariabele die hem overschrijft. Een 404 op elk verzoek is een base_url zonder zijn /v1. Een model-not-found-fout noemt het slot dat verkeerd is, controleer of het het agentmodel of het Lakeview-model was. En een run die start maar halverwege de taak vastloopt, is meestal het model dat afdwaalt in plaats van het endpoint dat faalt, wat waarvoor max_steps en het staplogboek zijn. Zodra taken draaien, toont de APIsRouter-console model per verzoek, tokenaantallen en uitgaven. Een agent die honderd stappen per taak neemt vermenigvuldigt alles, en het gebruikslogboek is waar je leert wat een taak echt kost op elk kandidaatmodel.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

Veelgestelde vragen