Appearance
文本与多模态对话(Chat / Responses)
通过 OpenAI 兼容接口使用豆包 Seed 1.6、DeepSeek、Kimi 等火山方舟模型进行对话与 Agent 调用。
本页面向 普通 API 调用者(非管理员),说明如何在 Fhddos 中,通过 Doubao / VolcArk 渠道使用文本与多模态对话能力。你只需要关心:
- 使用 统一的 OpenAI 风格接口:
/v1/chat/completions与/v1/responses; - 在
model字段中填写 Doubao / DeepSeek / Kimi 等模型名; - 使用自己的 Fhddos API Key(
oh-xxxxxxxx),不需要管理火山方舟密钥、签名和路由。
底层细节(如官方 Model ID、服务配置、计费映射)均由平台和管理员负责维护。
一、前置准备
bash
export BASE_URL="https://aiapi.fhddos.com/v1"
export TOKEN="oh-xxxxxxxxxxxxxxxx"统一请求头:
http
Authorization: Bearer <TOKEN>
Content-Type: application/json在 Doubao 渠道下常用的文本 / 多模态模型包括:
- 豆包 Seed 系列:
doubao-seed-1.8doubao-seed-1.6doubao-seed-1.6-litedoubao-seed-1.6-flashdoubao-seed-1.6-thinking(兼容别名)doubao-seed-1.6-vision
- 辅助模型:
doubao-seed-codedoubao-seed-translation
- 经由 VolcArk 聚合的其它模型(视管理员配置而定):
deepseek-v3.2、deepseek-v3.1、deepseek-v3、deepseek-r1-arkkimi-k2glm-4.7(需管理员在 VolcArk 渠道启用)
提示:
- 模型名在平台内部会统一按小写处理,因此
doubao-seed-1.8/Doubao-Seed-1.8均可被正确路由与计费;- 为了避免混淆,仍建议在客户端中使用文档中给出的 小写 API 模型名。
二、Chat Completions:标准对话接口
如果你已经习惯 OpenAI 的 POST /v1/chat/completions,那么 Doubao 渠道完全可以按相同方式使用,只需将 model 换成 Doubao / DeepSeek / Kimi 对应的模型名。
1. 基础对话示例
bash
curl -X POST "https://aiapi.fhddos.com/v1/chat/completions" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seed-1.8",
"messages": [
{"role": "system", "content": "你是一个乐于助人的中文助手。"},
{"role": "user", "content": "用三句话介绍一下 Fhddos 是什么。"}
],
"temperature": 0.7
}'说明:
model:填 Doubao 模型名(如doubao-seed-1.8),平台会自动映射到火山方舟所需的版本化 Model ID(如doubao-seed-1-8-251228),你无需关心后缀;messages:完全兼容 OpenAI 的多轮对话格式;- 计费与用量统计会自动归集到当前用户与对应模型,无需额外参数。
2. 流式输出(SSE)
bash
curl -N -X POST "https://aiapi.fhddos.com/v1/chat/completions" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: text/event-stream" \
-d '{
"model": "doubao-seed-1.6-flash",
"messages": [
{"role": "system", "content": "你是一位回答简洁的助手。"},
{"role": "user", "content": "分点列出 5 条提高工作效率的小技巧。"}
],
"stream": true
}'注意:
-N关闭 cURL 的输出缓冲,便于实时看到模型逐 token 输出;- 响应格式为标准的 OpenAI SSE 事件(
data: {...}),可以直接复用现有的 OpenAI 客户端或 SDK。
3. 工具调用 / JSON 输出
Doubao Seed 与经由 VolcArk 聚合的 DeepSeek / Kimi 模型,同样支持函数调用与 JSON 结构化输出。你可以沿用与 OpenAI 完全一致的写法:
- 使用
tools与tool_choice描述函数; - 设置
response_format为{"type": "json_schema"}或{"type": "json_object"}约束输出; - 平台会自动统计工具调用带来的额外用量并计入
usage。
具体字段含义与示例可参考通用文档《OpenAI / Chat Completions》。
三、多模态对话:图文理解(Vision)
当使用 doubao-seed-1.6-vision 等支持视觉的模型时,可以在 messages 中混合文本与图片内容,格式与 OpenAI Vision 模型兼容:
bash
curl -X POST "https://aiapi.fhddos.com/v1/chat/completions" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seed-1.6-vision",
"messages": [
{
"role": "user",
"content": [
{"type": "text", "text": "请描述这张图片的主要内容。"},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/demo.png"
}
}
]
}
]
}'要点:
- 图片可以是公网可访问 URL,也可以是 base64 数据 URL(视模型能力限制而定);
- 多模态输入仍然走统一的
/v1/chat/completions路径,只是content从字符串变成了数组; - 用量与计费会自动根据模型的多模态定价规则折算为 token,无需客户端参与。
四、Responses API:统一多模态响应接口
如果你更偏好使用 OpenAI 新一代的 POST /v1/responses 接口,也可以直接在 Doubao 渠道下使用 Doubao / DeepSeek / Kimi 模型。
1. 基础示例
bash
curl -X POST "https://aiapi.fhddos.com/v1/responses" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seed-1.8",
"input": [
{
"role": "user",
"content": [
{"type": "text", "text": "请把下面这段话整理成 3 个要点。"}
]
}
],
"response_format": {
"type": "json_schema"
}
}'说明:
input字段与 OpenAI 官方保持一致,可以在其中混合文本、图片、工具结果等内容;- 响应中的
output、usage字段与 OpenAI Responses 接口兼容,可复用现有解析逻辑; - 对于 Web Search、Code Interpreter 等扩展工具,平台会在
usage中附带额外计费信息(视具体模型与能力开放情况而定)。
2. 流式 Responses
bash
curl -N -X POST "https://aiapi.fhddos.com/v1/responses" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: text/event-stream" \
-d '{
"model": "doubao-seed-1.8",
"input": "请逐步推理并回答:为什么天空是蓝色的?",
"stream": true
}'当 stream: true 时:
- 服务端会以 SSE 事件的形式增量返回
response.*事件; - 若你希望在客户端侧兼容 Chat Completions 流格式,可参考通用文档《OpenAI / Responses》,Fhddos 已提供基础的转换兼容逻辑。
五、与管理员配置的关系
作为普通调用者,你无需关心以下事项:
- 火山方舟控制台中具体开通了哪些 Model ID;
- 管理员如何在 Fhddos 控制台中为 Doubao 能力配置密钥和价格;
- 内部模型路由、服务配置和价格维护细节。
你只需要:
- 从管理员处获取一个可用的 Fhddos API Key(
oh-xxxxxxxx); - 在请求中选择文档中列出的 Doubao / DeepSeek / Kimi 模型名;
- 通过
/v1/chat/completions或/v1/responses发起调用即可。
其它诸如模型版本升级、计费映射与任务追踪,均由平台自动处理。
OpenAPI
yaml
openapi: 3.0.3
info:
title: Fhddos Core API
version: '1.0'
description: >-
Core OpenAI-compatible and model-family endpoints used by the Fhddos user
docs.
servers:
- url: https://aiapi.fhddos.com
security:
- BearerAuth: []
paths:
/v1/chat/completions:
post:
tags:
- OpenAI
summary: Chat completions
requestBody:
$ref: '#/components/requestBodies/JsonObject'
responses:
'200':
$ref: '#/components/responses/JsonObject'
components:
requestBodies:
JsonObject:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/GenericObject'
responses:
JsonObject:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/GenericObject'
schemas:
GenericObject:
type: object
additionalProperties: true
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: 'Authorization: Bearer <token>'