Auth & Base URL
Base URL
https://gateway.mindproxy.aiThe base address for all API calls.
Path prefixes by API style:
| API style | Example path |
|---|---|
| OpenAI-compatible | https://gateway.mindproxy.ai/v1/... |
| Claude native | https://gateway.mindproxy.ai/v1/messages (or /anthropic/v1/messages) |
| Gemini native | https://gateway.mindproxy.ai/v1beta/models/<model>:generateContent |
Authentication
Authenticate with an API key (sk-...) created in the console. The three API styles accept slightly different methods:
| API | Auth method |
|---|---|
| OpenAI-compatible | Authorization: Bearer sk-... |
| Claude native | x-api-key: sk-..., or Authorization: Bearer sk-... |
| Gemini native | URL query ?key=sk-..., or Authorization: Bearer sk-... |
Endpoint overview
| Method | Path | Description |
|---|---|---|
POST | /v1/chat/completions | Chat (streaming / non-streaming) |
POST | /v1/embeddings | Text embeddings |
POST | /v1/responses | Responses API |
POST | /v1/images/generations | Image generation |
POST | /v1/images/edits | Image editing |
POST | /v1/audio/transcriptions | Speech to text |
POST | /v1/audio/speech | Text to speech |
POST | /v1/messages | Claude messages (streaming / non-streaming) |
POST | /v1/messages/count_tokens | Claude token counting (free) |
POST | /v1beta/models/<model>:generateContent | Gemini generate |
POST | /v1beta/models/<model>:streamGenerateContent | Gemini streaming |
GET | /v1/models | List available models |
POST | /v1/tasks | Create async task (video / MJ / async image) |
GET | /v1/tasks/{id} | Get task status |
GET | /v1/tasks/{id}/events | Task event list |
POST | /v1/tasks/{id}/cancel | Cancel task |
Common request headers
| Header | Purpose |
|---|---|
Idempotency-Key | Idempotency key. Send the same value when retrying to avoid double charges. |
X-TT-Dry-Run: true | Dry run: exercise auth and billing hold only, no model call, no charge — returns an estimate. |
Common response headers
| Header | Meaning |
|---|---|
X-TT-Request-ID | The gateway request id for this call; give it to support to locate the request. |
X-TT-Hold-ID | The billing hold id for this call. |
X-RateLimit-* | Rate-limit quota info (see Errors & rate limits). |
X-TT-Cache-* | Cache hit / savings info (see Recharge & Billing). |