文档/API 接入/OpenAI 兼容接口

OpenAI 兼容接口

最后更新：2026-04-24 · 预计阅读 12 分钟

TTToken 完整实现了 OpenAI 官方协议。无论你使用 openai 官方 SDK、LangChain、LlamaIndex 还是自写 HTTP，只需把 base_url 切为 https://tttoken.xyz/v1。

BASEhttps://tttoken.xyz/v1

Chat Completions

POST/v1/chat/completions

请求参数

字段类型说明
model 必填string模型 ID
messages 必填array对话消息，role 支持 system/user/assistant/tool
stream 可选bool开启 SSE 流式输出
temperature / top_pnumber采样参数
max_tokens / max_completion_tokensint最大生成 token 数。o 系列 reasoning 模型必须使用 max_completion_tokens。
tools / tool_choicearray / string见 Function Calling
response_formatobject{"type":"json_object"} 或 {"type":"json_schema","json_schema":{...}}
reasoning_effortstring仅 o1/o3/gpt-5/Claude 思考模型：low/medium/high
userstring终端用户 ID，用于风控

示例

curl https://tttoken.xyz/v1/chat/completions \
  -H "Authorization: Bearer $TTT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role":"system","content":"你是一个资深架构师。"},
      {"role":"user","content":"解释一下 CAP 定理"}
    ]
  }'

Responses API

POST/v1/responses

OpenAI 2025 新一代协议，原生 reasoning / built-in tools。支持状态化对话（previous_response_id）。

POST /v1/responses
{
  "model": "gpt-5",
  "input": [{"role":"user","content":"写一首关于雪的俳句"}],
  "reasoning": {"effort": "medium"}
}

返回格式与 OpenAI 官方一致，包含 output[]（含 message 与 reasoning 两种块）和 usage。

Embeddings

POST/v1/embeddings
POST /v1/embeddings
{
  "model": "text-embedding-3-large",
  "input": ["猫", "狗", "鱼"]
}

返回：

{
  "object": "list",
  "data": [
    {"index": 0, "embedding": [0.123, -0.456, ...]},
    {"index": 1, "embedding": [...]},
    {"index": 2, "embedding": [...]}
  ],
  "model": "text-embedding-3-large",
  "usage": {"prompt_tokens": 3, "total_tokens": 3}
}

图像

图像生成

POST/v1/images/generations
POST /v1/images/generations
{
  "model": "gpt-image-1",
  "prompt": "赛博朋克城市夜景，霓虹雨",
  "size": "1024x1024",
  "n": 1
}

图像编辑

POST/v1/images/edits

与官方一致，multipart/form-data 上传 image、mask、prompt。

音频

能力端点代表模型
转写 (STT)POST /v1/audio/transcriptionswhisper-1, gpt-4o-transcribe
翻译POST /v1/audio/translationswhisper-1
合成 (TTS)POST /v1/audio/speechtts-1, gpt-4o-mini-tts

Rerank

POST/v1/rerank
POST /v1/rerank
{
  "model": "bge-reranker-v2-m3",
  "query": "如何给猫洗澡",
  "documents": ["猫讨厌水", "用温水和专用香波", "狗喜欢水"]
}

Moderations

POST/v1/moderations

检测文本安全性，返回 flagged 与各类别分数。

模型列表

GET/v1/models

返回当前令牌可访问的模型。

Realtime WebSocket

WSwss://tttoken.xyz/v1/realtime

OpenAI Realtime 语音对话协议，完全透传。连接后发送 session.update 事件即可开始实时双向对话。