示例：Embeddings 向量化

POST

/v1/embeddings

调用网关域名下的当前路径即可，调用方不能指定 NewAPI 上游地址。

Authorization：NewAPI 的访问令牌，格式为 Bearer sk-xxx，网关原样透传。

domi-ai-metadata：必传的集团业务元数据。值是一个完整 JSON object 字符串，不要再套一层对象；网关读取后删除，不转发给 NewAPI。

请求体：NewAPI/OpenAI 兼容 JSON，网关不解析、不改写，按原始字节转发。

流式调用：请求体设置 stream: true，同时发送 Accept: text/event-stream。

响应头：网关返回 X-Domi-Request-Id；NewAPI 请求 ID 响应头也会继续透传。

可用模型：调用 GET /domi/gateway/api/model/names 获取当前支持的模型名称；文档中的模型名仅为请求示例。

浏览器原生 EventSource 无法设置自定义 header 时，才使用同名 query 参数传递元数据；header 与 query 同时存在时以 header 为准。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

API Key

在 header 添加参数

deviceId

示例：

deviceId: ********************

API Key

在 header 添加参数

deviceType

示例：

deviceType: ********************

API Key

在 header 添加参数

appVersion

示例：

appVersion: ********************

Header 参数

Body 参数application/json必填

示例

{
    "model": "text-embedding-3-small",
    "input": [
        "客户希望降低首年采购成本",
        "客户关注数据合规和私有化部署"
    ],
    "encoding_format": "float"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://gateway.domi-kids.com/v1/embeddings' \
--header 'domi-ai-metadata: {
    "schema_version": 1,
    "business_request_id": "order-ai-20260716-0001",
    "source_system_code": "crm",
    "application_id": "crm-copilot",
    "business_line_id": "sales",
    "organization_id": "org-1001",
    "user_id": "u-2001",
    "classify": {
        "1": "p-3001",
        "2": "cc-310",
        "3": "knowledge_qa",
        "20": ""
    }
}' \
--header 'Authorization: Bearer <token>' \
--header 'deviceId: <api-key>' \
--header 'deviceType: <api-key>' \
--header 'appVersion: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "text-embedding-3-small",
    "input": [
        "客户希望降低首年采购成本",
        "客户关注数据合规和私有化部署"
    ],
    "encoding_format": "float"
}'

返回响应

🟢200

application/json

NewAPI Embeddings JSON 响应

Bodyapplication/json

示例

{
    "object": "list",
    "data": [
        {
            "object": "embedding",
            "index": 0,
            "embedding": [
                0.0023064255,
                -0.009327292,
                -0.0028842222
            ]
        },
        {
            "object": "embedding",
            "index": 1,
            "embedding": [
                -0.0069292835,
                -0.005336422,
                -0.0036510543
            ]
        }
    ],
    "model": "text-embedding-3-small",
    "usage": {
        "prompt_tokens": 18,
        "total_tokens": 18
    }
}

🟠401

🔴500

🟠4XX

修改于 2026-07-28 04:34:48

示例：Images 文生图/图生图/组图

示例：Chat Completions 对话/流式对话