---
title: "Create multimodal embeddings"
method: POST
path: "/v1/multimodal/embeddings"
tags: ["Embeddings"]
---

# Create multimodal embeddings

`POST /v1/multimodal/embeddings`

## Request

- Base URL: `https://api.tokenlab.sh`
- URL: `https://api.tokenlab.sh/v1/multimodal/embeddings`
- Auth: HTTP bearer

Creates embeddings for multimodal input items. Text input is generally available; image input may require feature enablement.

## Headers

- `X-TokenLab-Delivery-Policy` 'auto' | 'verified' | 'official'

## Request body

- MultimodalEmbeddingRequest
  - `model` string, required: Model to use for multimodal embeddings
  - `input` union, required
    - MultimodalEmbeddingInputItem: A multimodal embedding input item. Text input is generally available; image input may require feature enablement.
      - `text` string: Text to embed
      - `image_base64` string: Base64-encoded image content
      - `image_mime_type` string: MIME type for image_base64
      - `image_url` string: Public image URL to embed
    - MultimodalEmbeddingInputItem[]
      - `text` string: Text to embed
      - `image_base64` string: Base64-encoded image content
      - `image_mime_type` string: MIME type for image_base64
      - `image_url` string: Public image URL to embed
  - `dimensions` integer: Optional embedding dimensionality when supported by the selected model

## Response `200`

Successful response

- MultimodalEmbeddingResponse
  - `object` 'list', required
  - `data` object[], required
    - `object` 'embedding', required
    - `index` integer, required
    - `text_embedding` number[]
    - `image_embedding` number[]
    - `video_embedding` number[]
    - `audio_embedding` number[]
  - `model` string, required
  - `usage` object, required
    - `prompt_tokens` integer
    - `total_tokens` integer

## Other responses

- `400`: Bad Request - Invalid input
- `401`: Unauthorized - Invalid or missing API key
- `402`: Payment Required - Insufficient balance or quota exceeded
- `429`: Rate Limit Exceeded
- `500`: Internal Server Error
- `502`: Service Error
- `503`: The requested Delivery tier is temporarily unavailable.

---

[API](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway.md) · [All operations](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/revisions/3208bfbcda22?raw)