鉴权与 Base URL

Base URL

https://gateway.mindproxy.ai

网关地址，所有 API 调用都基于此。

不同接口风格的路径前缀：

接口风格	路径示例
OpenAI 兼容	https://gateway.mindproxy.ai/v1/...
Claude 原生	https://gateway.mindproxy.ai/v1/messages（或 /anthropic/v1/messages）
Gemini 原生	https://gateway.mindproxy.ai/v1beta/models/<model>:generateContent

鉴权

用控制台创建的 API Key（sk-...）鉴权。三种接口接受的方式略有不同：

接口	鉴权方式
OpenAI 兼容	Authorization: Bearer sk-...
Claude 原生	x-api-key: sk-...，或 Authorization: Bearer sk-...
Gemini 原生	URL 查询参数 ?key=sk-...，或 Authorization: Bearer sk-...

端点总览

方法	路径	说明
POST	/v1/chat/completions	Chat（流式 / 非流式）
POST	/v1/embeddings	文本向量
POST	/v1/responses	Responses API
POST	/v1/images/generations	图像生成
POST	/v1/images/edits	图像编辑
POST	/v1/audio/transcriptions	语音转写
POST	/v1/audio/speech	文本转语音
POST	/v1/messages	Claude messages（流式 / 非流式）
POST	/v1/messages/count_tokens	Claude token 计数（不计费）
POST	/v1beta/models/<model>:generateContent	Gemini 生成
POST	/v1beta/models/<model>:streamGenerateContent	Gemini 流式生成
GET	/v1/models	列出可用模型
POST	/v1/tasks	创建异步任务（视频 / MJ / 异步图）
GET	/v1/tasks/{id}	查询任务状态
GET	/v1/tasks/{id}/events	任务事件列表
POST	/v1/tasks/{id}/cancel	取消任务

通用请求头

请求头	作用
Idempotency-Key	幂等键。重试同一请求带上同一值，避免重复扣费。
X-TT-Dry-Run: true	试运行：只做鉴权和计费预冻结，不发起生成、不扣费，返回预估。

通用响应头

响应头	含义
X-TT-Request-ID	本次请求的网关 request id，排障时提供给客服即可定位。
X-TT-Hold-ID	本次计费冻结 id。
X-RateLimit-*	限流配额信息（见 错误码与限流）。
X-TT-Cache-*	缓存命中与节省信息（见 充值与计费）。