---
title: "POST /ai/annotate-image"
method: POST
path: "/ai/annotate-image"
tags: ["/ai/"]
---

# POST /ai/annotate-image

`POST /ai/annotate-image`

## Request body

- AiAnnotateImageRequest
  - `model` 'canny' | 'hed' | 'midas' | 'mlsd' | 'openpose' | 'uniformer' | 'fake_scribble', required — Model to use
  - `parameters` object, required — Annotation parameters (model specific)

## Response `201`

The request has been accepted and the output is generating (ZIP attachment).

## Other responses

- `400` — A validation error occured.
- `401` — Access Token is incorrect.
- `402` — An active subscription is required to access this endpoint.
- `409` — A conflict error occured.
- `500` — An unknown error occured.

---

[API](https://skmtc.net/novelai/apis/novelai-primary-api.md) · [All operations](https://skmtc.net/novelai/apis/novelai-primary-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/novelai/novelai-primary-api/revisions/327b3674db26/schema)