跳到正文
土土金API

API 参考

API 参考

土土金 API 的 12 类接口一览:Chat Completions、Responses、Claude Messages、Gemini generateContent、图像生成与编辑、Embeddings、Rerank、语音合成与识别,以及 Midjourney、Suno 异步任务,含路径、认证方式与实测状态。

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

接口一览

接口方法与路径状态模型数
Chat CompletionsPOST/v1/chat/completions已实测681
ResponsesPOST/v1/responses原样转发5
Claude MessagesPOST/v1/messages已实测49
Gemini generateContentPOST/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
语音合成 TTSPOST/v1/audio/speech原样转发8
语音识别 STTPOST/v1/audio/transcriptions原样转发1
Midjourney 绘图POST/mj/submit/imagine原样转发13
Suno 音乐POST/suno/submit/music原样转发2

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

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

通用约定

项目约定
认证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
Midjourney 绘图或 AI 音乐Midjourney、Suno 音乐:异步任务,先提交、再轮询结果

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

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