NXAI 文档

Appearance

火山豆包模型调用说明 ​

火山豆包模型调用说明（NX 网关） ​

涉及模型：

模型 ID网关路径用途
doubao.doubao-seed-2-0-pro-260215POST /v1/chat/completions对话
doubao.doubao-seedream-5-0-260128POST /v1/images/generations文生图

通用说明 ​

项目说明
鉴权Authorization: Bearer <你的 new-api 令牌>
内容类型Content-Type: application/json
模型名须与渠道、模型映射中的名称一致。 doubao. 前缀的 ID，已配置重定向
Base URLhttps://nxaiapp.com/

1. doubao.doubao-seed-2-0-pro-260215（对话） ​

接口： POST /v1/chat/completions

说明： 网关经火山渠道转发至上游 .../api/v3/chat/completions。

非流式请求示例 ​

HTTP

http
POST /v1/chat/completions HTTP/1.1
Host: your-new-api.example.com
Authorization: Bearer sk-your-token
Content-Type: application/json
json
{
  "model": "doubao.doubao-seed-2-0-pro-260215",
  "messages": [
    { "role": "system", "content": "你是一个有帮助的助手。" },
    { "role": "user", "content": "用三句话介绍什么是边缘计算。" }
  ],
  "temperature": 0.7
}

cURL

bash
curl -sS "https://your-new-api.example.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao.doubao-seed-2-0-pro-260215",
    "messages": [
      {"role": "user", "content": "你好，简单自我介绍一下。"}
    ]
  }'

流式请求示例（SSE） ​

bash
curl -N "https://your-new-api.example.com/v1/chat/completions" \
  -H "Authorization: Bearer sk-your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao.doubao-seed-2-0-pro-260215",
    "messages": [{"role": "user", "content": "写一首关于春天的短诗"}],
    "stream": true
  }'

可选：Responses 接口 ​

若上游对该模型开放 Responses 能力，可使用 POST /v1/responses（请求体为 Responses 格式，与 Chat 的 messages 不同）。网关会转发至上游 .../api/v3/responses。是否支持与字段要求以火山官方文档为准。

2. doubao.doubao-seedream-5-0-260128（文生图） ​

接口： POST /v1/images/generations

说明： 请勿使用 /v1/chat/completions。网关转发至上游 .../api/v3/images/generations。

请求字段 ​

字段必填说明
model是与渠道配置一致
prompt是画面描述
n否生成张数
size否尺寸；网关会将常见 OpenAI 尺寸映射为火山侧 2K/4K 等（如 1024x1024 对应 2K）

JSON 示例 ​

json
{
  "model": "doubao.doubao-seedream-5-0-260128",
  "prompt": "一只在雪地里奔跑的红狐狸，电影感光影，高清",
  "n": 1,
  "size": "1024x1024"
}

cURL 示例 ​

bash
curl -sS "https://your-new-api.example.com/v1/images/generations" \
  -H "Authorization: Bearer sk-your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao.doubao-seedream-5-0-260128",
    "prompt": "赛博朋克风格的未来城市夜景，霓虹灯，雨夜反射",
    "n": 1,
    "size": "1024x1024"
  }'

推理接入点（ep-） ​

若在火山侧使用以 ep- 开头的接入点 ID，需与当前渠道的模型映射、网关行为一致；以实际配置为准。

快速对照 ​

模型网关路径用途
doubao.doubao-seed-2-0-pro-260215POST /v1/chat/completions对话
doubao.doubao-seedream-5-0-260128POST /v1/images/generations文生图