API 参考 | 土土金 API 文档

所有接口共用一个域名 https://open.tutujin.com 和同一把 Key。OpenAI 格式的接口都在 https://open.tutujin.com/v1 下面，请求体和响应体与官方 API 保持一致，所以官方 SDK 只要改 base URL 就能直接用。

接口一览

接口	方法与路径	状态	模型数
Chat Completions	POST/v1/chat/completions	已实测	681
Responses	POST/v1/responses	原样转发	5
Claude Messages	POST/v1/messages	已实测	49
Gemini generateContent	POST/v1beta/models/{model}:generateContent	已实测	63
图像生成	POST/v1/images/generations	原样转发	54
图像编辑	POST/v1/images/edits	原样转发	31
Embeddings 向量	POST/v1/embeddings	已实测	18
Rerank 重排序	POST/v1/rerank	原样转发	6
语音合成 TTS	POST/v1/audio/speech	原样转发	8
语音识别 STT	POST/v1/audio/transcriptions	原样转发	1

「已实测」表示我们在本站完成过真实调用与扣费核对；「原样转发」表示请求按原格式转发给模型服务，参数以对应模型的官方说明为准。模型数为当前目录中支持该接口的模型数量。

表里的「已实测」是我们在本站做过真实调用、核对过扣费的接口。「原样转发」的接口同样可以调用，请求会按原格式交给模型服务处理，参数是否生效以对应模型的官方说明为准。

项目	约定
认证	`Authorization: Bearer sk-...`；Claude Messages 也可以用 `x-api-key`，Gemini 也可以用 `x-goog-api-key`，见认证与 Base URL
请求格式	JSON（`Content-Type: application/json`）；图像编辑、语音识别上传文件时用 `multipart/form-data`
模型名	填模型广场里显示的模型名，例如 `gpt-5.4-mini`
分组	由 Key 决定，请求里不需要传；同一个模型在不同分组价格不同，见选择分组
计费	每次请求按 Key 所在分组的价格扣费，记录在控制台「用量明细」，见计费与用量
错误	返回 HTTP 错误状态码和 `error` 对象，见错误码与重试

你的情况	建议
新项目，或者想在多家模型之间切换	Chat Completions：一套代码调用 GPT、Claude、Gemini、DeepSeek 等目录里标注支持该接口的模型
已经用 Anthropic SDK 写好了代码	Claude Messages：改 base URL 即可，原生参数原样保留
已经用 Google Gen AI SDK 写好了代码	Gemini generateContent
用到只支持 Responses 格式的模型	Responses
做知识库检索	Embeddings 生成向量，Rerank 给检索结果重新排序
生成或修改图片	图像生成、图像编辑
语音播报或转写	语音合成 TTS、语音识别 STT

想知道某个模型支持哪些接口，打开它在模型广场的详情页即可。账户里能用哪些模型，也可以调用模型列表接口查询。

没找到答案？加客服微信 JsnonoChat，发送报错信息里的 request id，我们帮你排查。

接口一览

接口	方法与路径	状态	模型数
Chat Completions	POST/v1/chat/completions	已实测	681
Responses	POST/v1/responses	原样转发	5
Claude Messages	POST/v1/messages	已实测	49
Gemini generateContent	POST/v1beta/models/{model}:generateContent	已实测	63
图像生成	POST/v1/images/generations	原样转发	54
图像编辑	POST/v1/images/edits	原样转发	31
Embeddings 向量	POST/v1/embeddings	已实测	18
Rerank 重排序	POST/v1/rerank	原样转发	6
语音合成 TTS	POST/v1/audio/speech	原样转发	8
语音识别 STT	POST/v1/audio/transcriptions	原样转发	1

通用约定

项目	约定
认证	`Authorization: Bearer sk-...`；Claude Messages 也可以用 `x-api-key`，Gemini 也可以用 `x-goog-api-key`，见认证与 Base URL
请求格式	JSON（`Content-Type: application/json`）；图像编辑、语音识别上传文件时用 `multipart/form-data`
模型名	填模型广场里显示的模型名，例如 `gpt-5.4-mini`
分组	由 Key 决定，请求里不需要传；同一个模型在不同分组价格不同，见选择分组
计费	每次请求按 Key 所在分组的价格扣费，记录在控制台「用量明细」，见计费与用量
错误	返回 HTTP 错误状态码和 `error` 对象，见错误码与重试

该用哪种接口格式

你的情况	建议
新项目，或者想在多家模型之间切换	Chat Completions：一套代码调用 GPT、Claude、Gemini、DeepSeek 等目录里标注支持该接口的模型
已经用 Anthropic SDK 写好了代码	Claude Messages：改 base URL 即可，原生参数原样保留
已经用 Google Gen AI SDK 写好了代码	Gemini generateContent
用到只支持 Responses 格式的模型	Responses
做知识库检索	Embeddings 生成向量，Rerank 给检索结果重新排序
生成或修改图片	图像生成、图像编辑
语音播报或转写	语音合成 TTS、语音识别 STT

想知道某个模型支持哪些接口，打开它在模型广场的详情页即可。账户里能用哪些模型，也可以调用模型列表接口查询。