Architecture guide · 11 min

AI assistant, API or local model: choose the right architecture

Choosing AI does not begin with a model leaderboard. It begins with the service to be delivered: individual use, a capability embedded in a product, or processing controlled inside your environment.

Two specialists compare an assistant, an API and a model running on a local workstation.
Key points

The short answer

Use an assistant for immediate human work, an API for a controlled product feature, and a local model when environmental control justifies the operational burden. Validate every option on the same cases with the same data, cost and quality requirements.

  • Start from the real workflow
  • Compare total cost
  • Plan the exit from day one

Decide in six steps

  1. 1. Define the delivered service

    State who initiates the request, what data enters, what output is required and who validates it. Occasional conversation, repeated product functions and background processing call for different architectures.

  2. 2. Examine the data

    Classify information and map its journey. Check accounts, connectors, logs, retention, processing regions and subprocessors for the exact plan under consideration.

  3. 3. Measure integration

    An assistant reduces development but imposes its interface. An API offers more control and requires authentication, limits, monitoring and error handling. Local operation adds hardware, updates and support.

  4. 4. Test useful quality

    Build a small representative set with expected outputs, edge cases and desired refusals. Measure the final result after tools, retrieval and instructions rather than the model in isolation.

  5. 5. Calculate total cost

    Add subscriptions or tokens, storage, compute, integration, monitoring, human correction and maintenance. A low unit price may cost more when rework is frequent.

  6. 6. Design for reversibility

    Keep prompts, test sets, open formats and a replaceable integration layer. Document export, deletion and rollback so an offer change does not strand the service.

Put the method to work

Practical case

For a search over internal documents, sketch three possible routes: hosted assistant, integrated API and local model.

Evidence to keep

For each route, describe data flow, integration, full cost, human controls and exit procedure.

Make the decision

Choose an architecture after testing the same case against the three most important constraints, not the most attractive demo.

Four architecture criteria

Simplicity

How many people, tools and stages are required to deliver the service?

Control

Can you manage data, versions, permissions and behaviour?

Operations

Who monitors, fixes, updates and responds to incidents?

Reversibility

Can the provider change without rebuilding the whole workflow?

6 starting points

Starting points for each architecture

This selection spans assistants, platforms, developer tools and local solutions. Check current offers, documentation and terms on official sites.

How is this selection produced?

Active services are distributed across guide-related categories, then ordered by editorial highlighting and internal score. This does not assess security, compliance or performance on your use case. Methodology.

Explore the full category

Explore tools for this task

  • Duck.ai — Explore ideas, rephrase non-sensitive text or compare answers without installing a model. For documentary research, require accessible references instead of treating fluent answers as evidence.
  • Cursor — Work in an existing project on a bounded task: explain a function, fix a reproducible behaviour or prepare a reviewable change.
  • Ollama — Test a model on your computer or provide a backend for a local application. Check hardware compatibility and model licensing first.
  • AWS Bedrock — Evaluate models inside an AWS application, connect a corpus or organize calls with access controls. Define region, latency, budget and supervision requirements first.
  • ChatGPT — Prepare a note from two public reports or explore a table with known totals. Specify columns, units, dates and passages to preserve. Writing tasks and calculation tasks require different checks.
  • Claude — Prepare texts following one style guide or analyze a reference dossier. Separate background documents, style rules and task-specific instructions so you can understand what influences the output.

All profiles organized by family →

Comparison frameworks and cost per accepted result →

Related tool families

Frequently asked questions

Does an API always produce better results?

No. It mainly offers more integration control. Quality depends on the model, context, tools, data and evaluation of the complete workflow.

When does local operation make sense?

When control, latency, volume or independence requirements justify hardware and operational work. Test on the actual infrastructure.

Can all three approaches be combined?

Yes. A team may explore with an assistant, run a production feature through an API and process selected documents locally, provided responsibilities and data paths are explicit.

The references below expand on the concepts and checks discussed. Scenarios and trial frameworks remain editorial proposals; provider documentation describes its own product rather than an independent benchmark.

Official sources

Continue with another guide