Locus product guide · Updated
Locus Pro vs Direct API Integrations
Locus Pro fits agents and products that need many supported APIs through one account, one credit balance, one set of spend controls and one billing system. Direct provider integrations fit teams that need a specific provider’s complete API, direct contract, or specialized account features. Choose based on the exact operations, controls and billing responsibilities you need, rather than provider count alone.
How does Locus Pro compare with direct API integrations?
The main difference is who owns the work: accounts, credentials, spend controls, billing and reconciliation. Provider features and terms change, so check the operations you need.
| Requirement | Locus Pro managed catalog | Direct integration |
|---|---|---|
| Accounts and credentials | One Locus account for supported managed providers | Maintain each provider account and credential |
| Coverage | Operations currently supported in the Locus catalog | The provider’s available API under your account and contract |
| Spend controls | A prepaid balance, a monthly spend cap on the account, tool and credential scope, a ceiling on live-quoted calls, and spend alerts | Each provider’s own limits, plus any caps across providers that you build |
| Billing | One credit balance; enterprise customer pricing and attribution | Provider billing plus your own customer usage accounting |
| How you pay | Prepaid credits charged per call, on a published plan or agreed enterprise terms | Each provider’s own plan or invoice, under your negotiated or self-serve terms |
| Request compatibility | Use the documented Locus operation and input schema | Use the provider’s request and authentication contract |
| Failure handling | Locus operation, receipt, and provider behavior | Provider response and your own reconciliation logic |
When is a shared API catalog the better choice?
A shared catalog helps when one agent or product needs several providers. A research agent may use one service for search, another for extraction, and a third for company enrichment. Managed access cuts account setup and credential work, and an enterprise product can attribute those calls to customers and set their prices.
The value is more than a request proxy. It includes discovery, permissions, balances, spend limits, receipts, and billing flows. Estimate the integration and operating work those would replace in your system.
When should I integrate a provider directly?
Go direct when your product uses one provider, needs an endpoint or model missing from the catalog, depends on provider-specific state, or needs a direct commercial or data-handling agreement. A provider in the directory does not mean Locus exposes every feature. At high volume on one provider, calls can also cost less with your own provider account and API key.
Enterprise Custom APIs can bring supported operations under your own provider credential into Locus. You keep your upstream account and its terms. It does not make an unsupported protocol work.
How do I test which option fits my workload?
Run representative inputs through both and score result quality, coverage, end-to-end latency, and failure behavior. Include empty results, large responses, streaming interruption, and retries where relevant. One happy-path request proves nothing about reliability.
Record the date, endpoint, input, output criteria, and actual charge. Compare everything your team must own, including upgrades, credentials, spend limits, customer attribution, and reconciliation. Use that evidence to decide which operations stay direct and which fit a shared catalog.
Frequently asked questions
Is Locus Pro a drop-in replacement for every provider API?
No. Use the supported Locus operation and its documented request schema. Coverage and compatibility vary by endpoint.
Which spend controls come with Locus Pro?
A prepaid balance, a monthly spend cap on the account, tool and credential scope, a ceiling for live-quoted calls, a reload limit, and spend or low-balance alerts. With direct integrations, each provider has its own limits, and any cap across providers is yours to build.
Can I keep some providers on their own integrations?
Yes. Keep a provider on its own integration when you need its full API, a direct contract or heavy volume on it, and use Locus Pro for the rest. Enterprise Custom APIs can also bring supported operations under your own provider credential into Locus.
Implementation references
Use these first-party references for current request contracts and account requirements. Tool availability, prices, and negotiated terms can change.