---
title: "文本/图片嵌入向量生成接口"
method: POST
path: "/embeddings"
tags: ["Embeddings"]
---

# 文本/图片嵌入向量生成接口

`POST /embeddings`

将文本/图片转换为向量表示的接口

## Request body

- object
  - `model` string, required — 嵌入模型
  - `input` union, required — 文本字符串或者图文对象列表，单行文本字符数受模型上下文长度限制
    - string — 单条文本
    - string[] — 文本数组
    - union[] — 图文数组
      - union
        - TextContentPart
          - `type` 'text', required — 内容类型
          - `text` string, required — 文本内容
        - ImageContentPart
          - `type` 'image_url', required — 内容类型
          - `image_url` object, required — 图片URL对象
            - `url` string, required — 图片URL或Base64编码的图片数据
        - VideoContentPart
          - `type` 'video_url', required — 内容类型
          - `video_url` object, required — 视频URL对象
            - `url` string, required — 视频URL
  - `intent` 'search_document' | 'search_query' | 'classification' | 'clustering' | 'image' — 嵌入意图，用于指定嵌入的使用场景，目前仅 Cohere 向量模型支持该字段，当对图片进行向量化需要指定为 image
  - `dimensions` integer — 输出向量维度
  - `retries` integer — 自动重试次数，默认0，表示失败不重试

## Response `200`

成功响应

- object
  - `model` string, required — 使用的嵌入模型
  - `data` object[], required — 嵌入向量数据列表
    - `embedding` number[], required — 向量数据
    - `index` integer, required — 在输入数组中的索引位置
  - `usage` object, required
    - `prompt_tokens` integer, required — 输入文本的token数量
    - `total_tokens` integer, required — 总token数量
    - `prompt_tokens_details` object — 输入文本消耗明细
      - `text_tokens` integer — 文本token数
      - `image_tokens` integer — 图片token数
  - `object` 'list' — 响应对象类型

## Other responses

- `400` — 参数验证错误
- `401` — 未授权
- `413` — 输入文本超出长度限制
- `500` — 标准错误响应

---

[API](https://skmtc.dev/geekai/apis/api.md) · [All operations](https://skmtc.dev/geekai/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geekai/api/revisions/2bf0c8f70a39/schema)