参数说明（非接口请求）：domi-ai-metadata 业务元数据

POST

/domi/gateway/docs/ai-metadata

注意：本条目非业务请求接口，仅用于在 Swagger/Apifox 中展示 domi-ai-metadata 的 JSON 参数结构、字段备注和示例，请勿直接调用。

推荐传法：HTTP header

实际调用 AI 接口时，先把下方“请求参数”中的完整 JSON 对象序列化成单行 JSON 字符串，
再将字符串直接作为 domi-ai-metadata header 的值。
不要在 JSON 外再套一层 { "domi-ai-metadata": ... }，也不要放入 AI 请求 body。

备用传法：query 参数

仅浏览器原生 EventSource 等无法设置自定义 header 的场景使用同名 query 参数，并对整个 JSON 字符串执行 URL 编码。
header 与 query 同时存在时以 header 为准，且 header 非法时不会回退使用 query。

网关读取后会删除全部同名 header/query，不会把业务元数据转发给 NewAPI。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

API Key

在 header 添加参数

deviceId

示例：

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

API Key

在 header 添加参数

deviceType

示例：

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

API Key

在 header 添加参数

appVersion

示例：

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

Body 参数application/json必填

示例

CRM Copilot 业务元数据

{
    "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": ""
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://gateway.domi-kids.com/domi/gateway/docs/ai-metadata' \
--header 'Authorization: Bearer <token>' \
--header 'deviceId: <api-key>' \
--header 'deviceType: <api-key>' \
--header 'appVersion: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "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": ""
    }
}'

返回响应

🟢200

*/*

Body*/*

示例

{
    "code": 0,
    "msg": "string",
    "data": "string"
}

🟢204

🟠401

🔴500

修改于 2026-07-27 09:58:05

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

创建图生 3D 任务

参数说明（非接口请求）：domi-ai-metadata 业务元数据

推荐传法：HTTP header#

备用传法：query 参数#

请求参数

请求示例代码

返回响应

推荐传法：HTTP header

备用传法：query 参数