---
schema_version: "1"
id: c42cf2b7eaa75324ed6b5b62282bf46f93a14ab923e7a1129d84d34b45032f8f
title: Predict with Models API
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/genai/agentforce/guides/models/models-api/predict-with-models-api.md
canonical_url: https://developer.salesforce.com/docs/ai/agentforce/guide/predict-with-models-api.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 4581b8a8dd27b1cd5b547f6586e8dcb3a35ae75f5fbbe2bbec445480316bf026
products:
  - Agentforce Developer Guide
  - Agentforce and Einstein Generative AI
---
# Predict with Models API

The predictive endpoints of the Models API run a predictive model against your inputs and return a structured prediction. Use these endpoints when you need a numeric estimate, a category label, or a forecast rather than generated language.

## When to Use Predictive Endpoints

Predictive endpoints return structured predictions based on your business data, such as a numeric value, probability, label, or forecast. Use a predictive model that you built using [AI Models](https://help.salesforce.com/s/articleView?id=data.c360_a_ai_foundation_models.htm) (formerly Einstein Studio) in Data 360, and then call it by its API name. Unlike generative endpoints, predictive endpoints don't use large language models (LLMs) to generate chat responses, text, or embeddings.

Use a predictive endpoint when:

- You need structured output, such as a score, class probability, label, or forecasted value, that your application can process.
- You have historical or structured data and a model trained to score churn risk, rank leads, forecast demand, or classify records at scale.
- You want predictions based on your business data rather than language generated by an LLM.

Use a [generative endpoint](https://developer.salesforce.com/docs/ai/agentforce/guide/generate-with-models-api.md) when you need to generate or understand natural language, such as drafting a reply, summarizing a case, answering a question, or creating embeddings for semantic search.

|                 | Generative endpoints                        | Predictive endpoints                                             |
| --------------- | ------------------------------------------- | ---------------------------------------------------------------- |
| **Output**      | Natural-language text, chat, or embeddings  | A numeric value, class probability, label, or forecast           |
| **Backed by**   | Salesforce-managed or bring-your-own LLMs   | A predictive model you build or bring with AI Models in Data 360 |
| **You provide** | A prompt or messages                        | A deployed model's API name plus input records                   |
| **Best for**    | Drafting, summarizing, Q&A, semantic search | Scoring, ranking, forecasting, and classifying your own data     |
| **Result**      | Varies by prompt                            | Repeatable, structured predictions                               |

## Capabilities

- **Classification** — Assign category labels to an input. Includes classification (probability per class), multi-outcome, topic classification, and sentiment detection.
- **Regression** — Predict a continuous numeric value for an input, including forecasting future values of a time series.

## Access

- [Access Predictive Endpoints with REST](https://developer.salesforce.com/docs/ai/agentforce/guide/access-predictive-endpoints-with-rest.md)