---
title: "Group Chat Describe Image"
method: POST
path: "/connect/describe-image"
tags: ["app"]
---

# Group Chat Describe Image

`POST /connect/describe-image`

## Request

- Base URL: `https://realtime-api.convai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://realtime-api.convai.com/connect/describe-image`
- Auth: none declared

Turn an image the moderator shared into text the characters can read.

Group chat delivers documents as text, and a character never sees a
picture. The browser posts the bytes here, a vision-capable model from
``llm_metadata`` describes them, and the description travels on the same
attachment channel as extracted document text.

## Headers

- `X-API-Key` string, nullable
- `API-AUTH-TOKEN` string, nullable

## Request body

- DescribeImageRequest: One image the moderator shared, on its way to a vision model.
  - `image_base64` string, required
  - `mime_type` string, required
  - `filename` string, nullable
  - `purpose` string, nullable

## Response `200`

Successful Response

- DescribeImageResponse
  - `description` string, required
  - `model` string, required
  - `provider` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-08** `077f8fd2db4b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/convai/apis/convai-api/changes/connect/describe-image/post.md)

---

[API](https://skmtc.dev/convai/apis/convai-api.md) - [All operations](https://skmtc.dev/convai/apis/convai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/convai/apis/convai-api/revisions/4361c107ef49?raw)