# Instill AI Model API

**Canonical:** https://apis.io/apis/instill-ai/instill-ai-model-api/  
**Provider:** Instill AI — https://apis.io/providers/instill-ai/  
**Base URL:** https://api.instill-ai.com  
**Documentation:** https://docs.instill-ai.com/reference

Instill AI Model API is one of 7 APIs that [Instill AI](https://apis.io/providers/instill-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Model. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

AI Model orchestration

## Operations (23)

| Method | Path | Summary |
|---|---|---|
| DELETE | `/v1alpha/{name_3}` | Delete a model |
| GET | `/v1alpha/model-definitions` | List model definitions |
| GET | `/v1alpha/available-regions` | List available regions |
| GET | `/v1alpha/model-definitions/{modelDefinitionId}` | Get a model definition |
| GET | `/v1alpha/models` | List public models |
| GET | `/v1alpha/{parent}/models` | List models |
| POST | `/v1alpha/{parent}/models` | Create a new model |
| GET | `/v1alpha/{name_4}` | Get a model |
| DELETE | `/v1alpha/{name_4}` | Delete a model version |
| PATCH | `/v1alpha/{model.name}` | Update a model |
| POST | `/v1alpha/{name}/rename` | Rename a model |
| GET | `/v1alpha/{name}/versions/{version}/watch` | Watch the state of a model version |
| GET | `/v1alpha/{name}/watch` | Watch the state of the latest model version |
| GET | `/v1alpha/{parent}/versions` | List namespace model versions |
| POST | `/v1alpha/{name}/trigger` | Trigger model inference |
| POST | `/v1alpha/{name}/trigger-async` | Trigger model inference asynchronously |
| POST | `/v1alpha/{name_1}/trigger` | Trigger model inference |
| POST | `/v1alpha/{name_1}/trigger-async` | Trigger model inference asynchronously |
| GET | `/v1alpha/{name}/operation` | Get the details of the long-running operation from a model version |
| GET | `/v1alpha/{name_1}/operation` | Get the details of the latest long-running operation from a model |
| GET | `/v1alpha/operations/{operationId}` | Get the details of a long-running operation |
| GET | `/v1alpha/{parent}/runs` | List Model Runs |
| GET | `/v1alpha/dashboard/models/runs` | List Model Runs By Requester |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/instill-ai/refs/heads/main/openapi/instill-ai-model-api-openapi.yml
- **Protobuf** — https://raw.githubusercontent.com/api-evangelist/instill-ai/refs/heads/main/grpc/instill-ai-pipeline-v1beta-pipeline_public_service.proto
- **Protobuf** — https://raw.githubusercontent.com/api-evangelist/instill-ai/refs/heads/main/grpc/instill-ai-mgmt-v1beta-mgmt_public_service.proto
- **Protobuf** — https://raw.githubusercontent.com/api-evangelist/instill-ai/refs/heads/main/grpc/instill-ai-model-v1alpha-model_public_service.proto
- **Protobuf** — https://raw.githubusercontent.com/api-evangelist/instill-ai/refs/heads/main/grpc/instill-ai-artifact-v1alpha-artifact_public_service.proto
- **Protobuf** — https://raw.githubusercontent.com/api-evangelist/instill-ai/refs/heads/main/grpc/instill-ai-usage-v1beta-usage_service.proto
- **Documentation** — https://docs.instill-ai.com/reference

## Other Instill AI APIs (6)

- [Instill AI Artifact API](https://apis.io/apis/instill-ai/instill-ai-artifact-api/)
- [Instill AI Connection API](https://apis.io/apis/instill-ai/instill-ai-connection-api/)
- [Instill AI Integration API](https://apis.io/apis/instill-ai/instill-ai-integration-api/)
- [Instill AI Metrics API](https://apis.io/apis/instill-ai/instill-ai-metrics-api/)
- [Instill AI Namespace API](https://apis.io/apis/instill-ai/instill-ai-namespace-api/)
- [Instill AI Pipeline API](https://apis.io/apis/instill-ai/instill-ai-pipeline-api/)

## Tags

Model

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/instill-ai/instill-ai-model-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/instill-ai/.