嵌入 · 原生Gemini格式

命名说明

部分文档将此端点归类为「原生Gemini格式」。从实际路径与参数看，它是 OpenAI 早期版本的「引擎」路径风格（将模型 ID 放在路径中而非请求体），功能与 原生OpenAI格式 的 /v1/embeddings 一致，仅路径形式不同。

使用指定引擎创建嵌入

POST /v1/engines/{model}/embeddings

路径参数

参数	类型	必填	说明
model	string	是	模型 / 引擎 ID，如 text-embedding-ada-002

请求参数

参数	类型	必填	说明
input	string | array	是	待嵌入的文本，或文本数组（批量）
encoding_format	string	否	float（默认）或 base64
dimensions	integer	否	输出向量维度

请求示例

curl https://ai.youqi.tech/v1/engines/text-embedding-ada-002/embeddings \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "YouQi AI 是一站式 AI 模型接入平台。"
  }'

响应示例

{
  "object": "list",
  "data": [
    { "object": "embedding", "index": 0, "embedding": [0.0023, -0.0091, 0.0157] }
  ],
  "model": "text-embedding-ada-002",
  "usage": { "prompt_tokens": 18, "total_tokens": 18 }
}

提示

建议新项目优先使用 原生OpenAI格式 的 /v1/embeddings；本接口主要用于兼容依赖旧版「引擎」路径的客户端。