GonkaGate Chat Completions API

Treat this page as the canonical source when generated types, hand-written DTOs, or stream parsers drift. If another guide or snippet disagrees with the schema below, this contract wins.

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

input?|array<>|

max_completion_tokens?integer

max_tokens?integer

messages?array<>

model*string

plugins?array<||||>

preset?string

reasoning_effort?string

response_format?

stream?boolean

web_search_options?

[key: string]?any

Response Body

`application/json`

curl -X POST "https://api.gonkagate.com/v1/chat/completions" \  -H "x-idempotency-key: idem_01J0ABCD2EFGH3IJK4LMN5PQRS" \  -H "Content-Type: application/json" \  -d '{    "max_tokens": 128,    "messages": [      {        "content": "Write a short haiku about distributed systems.",        "role": "user"      }    ],    "model": "qwen/qwen3-235b-a22b-instruct-2507-fp8",    "stream": false  }'

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "annotations": [
          {
            "type": "url_citation",
            "url_citation": {
              "content": "SearXNG is a free internet metasearch engine...",
              "end_index": 24,
              "start_index": 0,
              "title": "SearXNG documentation",
              "url": "https://docs.searxng.org/"
            }
          }
        ],
        "content": "Packets hum in night,\nConsensus finds steady light,\nSystems breathe as one.",
        "role": "assistant"
      }
    }
  ],
  "created": 1761605442,
  "id": "chatcmpl_abc123",
  "model": "qwen/qwen3-235b-a22b-instruct-2507-fp8",
  "object": "chat.completion",
  "usage": {
    "completion_tokens": 24,
    "completion_tokens_details": {
      "reasoning_tokens": 0
    },
    "prompt_tokens": 22,
    "total_tokens": 46
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid credentials.",
    "param": null,
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid credentials.",
    "param": null,
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid credentials.",
    "param": null,
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid credentials.",
    "param": null,
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid credentials.",
    "param": null,
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid credentials.",
    "param": null,
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid credentials.",
    "param": null,
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid credentials.",
    "param": null,
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid credentials.",
    "param": null,
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid credentials.",
    "param": null,
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid credentials.",
    "param": null,
    "type": "authentication_error"
  }
}

curl -X POST "https://api.gonkagate.com/v1/chat/completions" \ -H "x-idempotency-key: idem_01J0ABCD2EFGH3IJK4LMN5PQRS" \ -H "Content-Type: application/json" \ -d '{ "max_tokens": 128, "messages": [ { "content": "Write a short haiku about distributed systems.", "role": "user" } ], "model": "qwen/qwen3-235b-a22b-instruct-2507-fp8", "stream": false }'

{ "choices": [ { "finish_reason": "stop", "index": 0, "message": { "annotations": [ { "type": "url_citation", "url_citation": { "content": "SearXNG is a free internet metasearch engine...", "end_index": 24, "start_index": 0, "title": "SearXNG documentation", "url": "https://docs.searxng.org/" } } ], "content": "Packets hum in night,\nConsensus finds steady light,\nSystems breathe as one.", "role": "assistant" } } ], "created": 1761605442, "id": "chatcmpl_abc123", "model": "qwen/qwen3-235b-a22b-instruct-2507-fp8", "object": "chat.completion", "usage": { "completion_tokens": 24, "completion_tokens_details": { "reasoning_tokens": 0 }, "prompt_tokens": 22, "total_tokens": 46 } }

POST /v1/chat/completions — Create Chat Completion

Authorization

Header Parameters

Request Body

Response Body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

Authorization

Header Parameters

Request Body

Response Body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

POST /v1/chat/completions — Create Chat Completion

200

400application/json

401application/json

403application/json

404application/json

409application/json

413application/json

429application/json

500application/json

502application/json

503application/json

504application/json

200

400application/json

401application/json

403application/json

404application/json

409application/json

413application/json

429application/json

500application/json

502application/json

503application/json

504application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`