下载 Markdown

更新日期

对话

支持文本、Vision 图文(OpenAI 兼容 image_url content part)、文件附件(OpenAI 兼容 file content part,file_data / 公网 URL)和 function calling。网关不执行函数,只把 tools 交给模型服务,并把 tool_calls 回给调用方。response_format 与 web_search 等内置工具会被拒绝或忽略:未列出的字段静默忽略;非 function 的 tools 返回 400。file_id / /v1/files 不可用,传入会返回 400。是否真正看图/读文件、是否会发起函数调用,取决于所选模型。

OpenAI Responses 形态见 POST /v1/responses(同样支持 input_image / input_file)。

请求

字段类型必填说明
modelstring是对外 id
messagesarray是至少一条。role 为 system / user / assistant / tool。助手调用函数时带 tool_calls,content 可为 null。role: tool 必须带 tool_call_id
streamboolean否true 时 SSE;函数调用以 delta.tool_calls 分片返回
temperaturenumber否作用于所选模型
max_tokensnumber否作用于所选模型
toolsarray否仅 type: "function"。每项含 function.name,可选 description / parameters / strict
tool_choicestring | object否none / auto / required,或 { "type": "function", "function": { "name": "..." } }。设置时必须同时传 tools
parallel_tool_callsboolean否是否允许同一次回复里并行多个函数调用。设置时必须同时传 tools

messages[].content

形态说明
string纯文本
arraycontent parts:text、image_url、file(见下)

image_url.url 支持:

形态说明
公网 URLhttps://...(该地址需可公网访问)
Data URL / base64data:image/png;base64,...;网关先转存为平台公网 URL 再交给模型服务
对象简写image_url 也可直接为字符串 URL

可选 image_url.detail(如 low / high / auto)作用于所选模型。

文件 part(type: "file")

字段说明
file.file_dataData URL / base64,或公网 HTTPS URL;内嵌数据会先转存为平台公网 URL,再以 file_data 交给上游
file.filename可选文件名(如 doc.pdf)
file.file_id不支持(无 /v1/files),单独传入返回 400

本地文件路径不支持。请用 file_data(含 data URL)或公网 URL,不要传 file_id。

Vision 示例:

json
{
  "model": "YOUR_CHAT_MODEL",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "图里有什么?" },
        {
          "type": "image_url",
          "image_url": { "url": "https://cdn.example.com/cat.png" }
        }
      ]
    }
  ]
}

Function calling 示例(调用方拿到 tool_calls 后自行执行,再把 role: "tool" 的结果发回):

json
{
  "model": "YOUR_CHAT_MODEL",
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_weather",
        "parameters": {
          "type": "object",
          "properties": { "city": { "type": "string" } },
          "required": ["city"]
        }
      }
    }
  ],
  "messages": [
    { "role": "user", "content": "巴黎天气如何?" }
  ]
}

同步响应里 choices[0].message.tool_calls 为函数调用,finish_reason 为 tool_calls。流式响应里参数在 delta.tool_calls[].function.arguments 中分段到达。

curl https://tokenmei.com/v1/chat/completions \
-H "Authorization: Bearer $MOMO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "model": "YOUR_CHAT_MODEL",
  "messages": [
    {"role": "system", "content": "你是助手"},
    {"role": "user", "content": "你好"}
  ],
  "temperature": 0.7,
  "max_tokens": 2048
}'

非流式响应

json
{
  "id": "chatcmpl_a1b2c3d4e5f6",
  "object": "chat.completion",
  "created": 1710000000,
  "model": "YOUR_CHAT_MODEL",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "你好!" },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 8,
    "total_tokens": 28,
    "cost": { "amount": "0.0021", "currency": "CNY" }
  }
}
字段类型说明
idstring前缀固定 chatcmpl_
objectstring固定 chat.completion
createdintUnix 秒
modelstring对外模型 id
choicesarray每项含 index、message、finish_reason
choices[].message.rolestringassistant
choices[].message.contentstring回复文本
choices[].finish_reasonstring如 stop
usage.prompt_tokensint输入 token
usage.completion_tokensint输出 token
usage.total_tokensint合计
usage.costobject可选。amount 为对外售价字符串,currency 为 CNY。运营可在系统设置里关闭,关闭后字段不出现

流式

stream: true 时 HTTP 仍是 200,Content-Type: text/event-stream。每帧 data: {json},结束 data: [DONE]。最后一帧([DONE] 之前)带 usage 与 finish_reason。扣费发生在流正常结束后,按实际消耗的 token(usage),不是按 max_tokens。

curl -N https://tokenmei.com/v1/chat/completions \
-H "Authorization: Bearer $MOMO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "model": "YOUR_CHAT_MODEL",
  "messages": [{"role": "user", "content": "你好"}],
  "stream": true
}'

增量帧示例:

data: {"id":"chatcmpl_…","object":"chat.completion.chunk","created":1710000000,"model":"YOUR_CHAT_MODEL","choices":[{"index":0,"delta":{"content":"你"},"finish_reason":null}]}

data: {"id":"chatcmpl_…","object":"chat.completion.chunk","created":1710000000,"model":"YOUR_CHAT_MODEL","choices":[{"index":0,"delta":{},"finish_reason":"stop"}],"usage":{"prompt_tokens":8,"completion_tokens":2,"total_tokens":10}}

data: [DONE]
字段说明
data: {json}增量帧
choices[].delta.content文本增量,可能为空
最后一帧[DONE] 之前,带 usage 与 finish_reason
data: [DONE]结束标记
data: {"error":…}模型调用失败;HTTP 仍可能是 200,不扣费

模型调用失败时不要只看 HTTP 状态。失败的流不会扣费。中途断连以服务端是否跑完结算为准;不要假设客户端 abort 一定退款。

对话 · MomoAI算力超市