示例：Responses API

POST

/v1/responses

调用网关域名下的当前路径即可，调用方不能指定 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": "gpt-4.1-mini",
    "instructions": "你是企业知识库助手，回答要简洁并标明依据。",
    "input": "请解释本季度退款政策。",
    "stream": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://gateway.domi-kids.com/v1/responses' \
--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 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'deviceId: <api-key>' \
--header 'deviceType: <api-key>' \
--header 'appVersion: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gpt-4.1-mini",
    "instructions": "你是企业知识库助手，回答要简洁并标明依据。",
    "input": "请解释本季度退款政策。",
    "stream": false
}'

返回响应

🟢200

application/json

NewAPI Responses API 响应

Bodyapplication/json

示例

{
    "id": "resp_67ccd2bed1ec8190b14f964abc0542670bb6a6b452d3795b",
    "object": "response",
    "created_at": 1741476542,
    "status": "completed",
    "model": "gpt-4.1-mini",
    "output": [
        {
            "id": "msg_67ccd2bf17f0819081ff3bb2cf6508e60bb6a6b452d3795b",
            "type": "message",
            "status": "completed",
            "role": "assistant",
            "content": [
                {
                    "type": "output_text",
                    "text": "本季度退款政策以合同约定和已发布的财务制度为准。",
                    "annotations": []
                }
            ]
        }
    ],
    "usage": {
        "input_tokens": 16,
        "output_tokens": 24,
        "total_tokens": 40
    }
}

🟠401

🔴500

🟠4XX

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

查询支持的模型名称

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