Chat（OpenAI 兼容）

POST https://gateway.mindproxy.ai/v1/chat/completions

与 OpenAI Chat Completions 接口兼容，支持流式、工具调用、多模态（取决于模型）。

请求

curl https://gateway.mindproxy.ai/v1/chat/completions \
  -H "Authorization: Bearer $TT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "你是一个简洁的助手。"},
      {"role": "user", "content": "用一句话介绍杭州。"}
    ],
    "temperature": 0.7,
    "max_tokens": 256
  }'

常用字段：

字段	说明
model	公开模型 ID，见 模型与套餐
messages	对话消息数组（role: system / user / assistant / tool）
stream	true 开启流式（SSE）
temperature / top_p	采样参数
max_tokens	最大生成 token
tools / tool_choice	工具调用，见 流式与工具调用

其余 OpenAI 支持的字段一般原样传递。

响应（非流式）

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "gpt-4o-mini",
  "choices": [
    {
      "index": 0,
      "message": {"role": "assistant", "content": "杭州是浙江省会，以西湖闻名。"},
      "finish_reason": "stop"
    }
  ],
  "usage": {"prompt_tokens": 24, "completion_tokens": 14, "total_tokens": 38}
}

usage 是计费依据（按 token）。响应头里有 X-TT-Request-ID 等，见 鉴权与 Base URL。

流式

加 "stream": true 后返回 SSE：逐块下发 data: {...}（delta），以 data: [DONE] 结束。各 SDK 已封装，见 Python / Node.js。

其它 OpenAI 兼容能力

同一前缀下还提供：/v1/embeddings、/v1/responses、/v1/images/generations、/v1/images/edits、/v1/audio/transcriptions、/v1/audio/speech。图像见 图像生成。