1. AI调用示例
Domi API DOC
  • 01-快速开始
    • 快速开始
      GET
  • AI调用示例
    • 查询支持的模型名称
      GET
    • 示例：Responses API
      POST
    • 示例：Images 文生图/图生图/组图
      POST
    • 示例：Embeddings 向量化
      POST
    • 示例：Chat Completions 对话/流式对话
      POST
    • 参数说明（非接口请求）：domi-ai-metadata 业务元数据
      POST
  • 3D-10 Hi3D
    • 创建图生 3D 任务
      POST
    • 查询图生 3D 任务
      GET
    • 创建图生 3D 浮雕任务
      POST
    • 查询图生 3D 浮雕任务
      GET
  • 3D-20 Tripo3D
    • 查询单个任务
      GET
    • 上传小文件
      POST
    • 获取大文件预签名上传地址
      POST
    • 文生 3D 模型
      POST
    • 单图生 3D 模型
      POST
    • 多视图生 3D 模型
      POST
    • 网格分割
      POST
    • 网格部件补全
      POST
  • 3D-30 Hyper3D
    • 查询生成任务状态
      POST
    • 获取生成结果下载地址
      POST
  • 3D-40 Meshy
    • 分页查询 Text to 3D 任务
      GET
    • 创建 Text to 3D 任务
      POST
    • 查询 Text to 3D 任务
      GET
    • 删除 Text to 3D 任务
      DELETE
    • SSE 订阅 Text to 3D 进度
      GET
  • 火山引擎-Seedance
    • 创建豆包 Seedance 视频生成任务
    • 查询豆包 Seedance 视频生成任务
    • 取消或删除豆包 Seedance 视频生成任务
  • 数据模型
    • ResultString
    • SmsCodeBean
    • 图片生成请求
    • DictionaryWriteRequest
    • LoginBean
    • OptimizePromptOptions
    • MetadataCodeEntry
    • LoginUserInfo
    • SequentialImageGenerationOptions
    • ResultLoginUserInfo
    • TextBean
    • ModelNames
    • Credentials
    • domi-ai-metadata 业务元数据
    • ResponseToken
    • ResultResponseToken
  1. AI调用示例

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

POST
/v1/images/generations
调用网关域名下的当前路径即可，调用方不能指定 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 为准。

参数选择#

本接口同时承载 OpenAI 图片协议和 NewAPI 渠道支持的 Seedream 扩展，Schema 因此展示两类字段的并集。
不同模型不支持全部字段，不要把 Schema 中所有可选参数一次性发送。
Seedream 文生图：传 model、prompt，再按需传尺寸、数量、种子、返回格式和水印。
Seedream 图生图：在文生图参数上增加 image URL 数组；不要把带真实签名或凭据的临时 URL 写入日志。
Seedream 组图：使用 sequential_image_generation: "auto" 和 max_images，不要用 n 代替组图语义。
OpenAI GPT Image：使用 quality、background、output_format 等 OpenAI 字段，不要同时发送 Seedream 扩展。
示例中的模型名仅用于展示请求形态，实际可用模型及参数范围以 NewAPI 的模型配置和对应供应商文档为准。

请求参数

Authorization
JWT Bearer
在 Header 添加参数
Authorization
示例：
Authorization: ********************
API Key
在 header 添加参数
deviceId
示例：
deviceId: ********************
API Key
在 header 添加参数
deviceType
示例：
deviceType: ********************
API Key
在 header 添加参数
appVersion
示例：
appVersion: ********************
or
Header 参数

Body 参数application/json必填

示例
Seedream 5.0 文生图
{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "A serene koi pond at sunset, ukiyo-e style.",
    "size": "1024x1024",
    "n": 1,
    "seed": 123456789,
    "sequential_image_generation": "disabled",
    "stream": false,
    "response_format": "url",
    "output_format": "jpeg",
    "tools": [
        {
            "type": "web_search"
        }
    ],
    "watermark": false
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://gateway.domi-kids.com/v1/images/generations' \
--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": "doubao-seedream-5-0-260128",
    "prompt": "A serene koi pond at sunset, ukiyo-e style.",
    "size": "1024x1024",
    "n": 1,
    "seed": 123456789,
    "sequential_image_generation": "disabled",
    "stream": false,
    "response_format": "url",
    "output_format": "jpeg",
    "tools": [
        {
            "type": "web_search"
        }
    ],
    "watermark": false
}'

返回响应

🟢200
application/json
NewAPI/图片供应商返回的图片生成结果；字段会因模型和 response_format 不同而变化。
Bodyapplication/json

示例
{
    "model": "doubao-seedream-5-0-260128",
    "created": 1785148800,
    "data": [
        {
            "url": "https://cdn.example.com/generated/image-1.jpeg",
            "size": "1024x1024"
        }
    ],
    "usage": {
        "generated_images": 1,
        "output_tokens": 4096,
        "total_tokens": 4096
    }
}
🟠401
🔴500
🟠4XX
🔴5XX
修改于 2026-07-28 04:34:48
上一页
示例：Responses API
下一页
示例：Embeddings 向量化
Built with