API швидкий старт — curl, Python, TypeScript

Найшвидший спосіб перевірити роботу API — curl:

Звичайний запит:

curl https://gate.joingonka.ai/v1/chat/completions \\n  -H "Content-Type: application/json" \\n  -H "Authorization: Bearer jg-ваш-ключ" \\n  -d '{\n    "model": "Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",\n    "messages": [\n      {"role": "user", "content": "Що таке Gonka?"}\n    ]\n  }'

Streaming (відповідь частинами):

curl https://gate.joingonka.ai/v1/chat/completions \\n  -H "Content-Type: application/json" \\n  -H "Authorization: Bearer jg-ваш-ключ" \\n  -d '{\n    "model": "Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",\n    "messages": [\n      {"role": "user", "content": "Напиши hello world на Python"}\n    ],\n    "stream": true\n  }'

Відповідь надходить у форматі JSON (звичайний) або Server-Sent Events (streaming) — повністю сумісний з OpenAI API.

Офіційний OpenAI Python SDK працює з JoinGonka Gateway без змін:

pip install openai

Звичайний запит:

from openai import OpenAI\n\nclient = OpenAI(\n    base_url="https://gate.joingonka.ai/v1",\n    api_key="jg-ваш-ключ",\n)\n\nresponse = client.chat.completions.create(\n    model="Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",\n    messages=[\n        {"role": "user", "content": "Поясни блокчейн простими словами"}\n    ],\n)\n\nprint(response.choices[0].message.content)

Streaming:

stream = client.chat.completions.create(\n    model="Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",\n    messages=[{"role": "user", "content": "Напиши сортування на Python"}],\n    stream=True,\n)\n\nfor chunk in stream:\n    if chunk.choices[0].delta.content:\n        print(chunk.choices[0].delta.content, end="")

Tool calling:

import json\n\ntools = [{\n    "type": "function",\n    "function": {\n        "name": "get_weather",\n        "description": "Отримати погоду в місті",\n        "parameters": {\n            "type": "object",\n            "properties": {\n                "city": {"type": "string", "description": "Назва міста"}\n            },\n            "required": ["city"]\n        }\n    }\n}]\n\nresponse = client.chat.completions.create(\n    model="Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",\n    messages=[{"role": "user", "content": "Яка погода в Москві?"}],\n    tools=tools,\n)\n\ntool_call = response.choices[0].message.tool_calls[0]\nprint(f"Функція: {tool_call.function.name}")\nprint(f"Аргументи: {tool_call.function.arguments}")

Qwen3-235B підтримує нативний tool calling — функції викликаються коректно, без парсингу текстових відповідей.

Встановлення:

npm install openai

Звичайний запит:

import OpenAI from 'openai';\n\nconst client = new OpenAI({\n  baseURL: 'https://gate.joingonka.ai/v1',\n  apiKey: 'jg-ваш-ключ',\n});\n\nasync function main() {\n  const response = await client.chat.completions.create({\n    model: 'Qwen/Qwen3-235B-A22B-Instruct-2507-FP8',\n    messages: [\n      { role: 'user', content: 'Напиши Express.js сервер' },\n    ],\n  });\n\n  console.log(response.choices[0].message.content);\n}\n\nmain();

Streaming:

const stream = await client.chat.completions.create({\n  model: 'Qwen/Qwen3-235B-A22B-Instruct-2507-FP8',\n  messages: [{ role: 'user', content: 'Поясни async/await' }],\n  stream: true,\n});\n\nfor await (const chunk of stream) {\n  const content = chunk.choices[0]?.delta?.content || '';\n  process.stdout.write(content);\n}

Tool calling:

const response = await client.chat.completions.create({\n  model: 'Qwen/Qwen3-235B-A22B-Instruct-2507-FP8',\n  messages: [{ role: 'user', content: 'Конвертуй 100 USD в EUR' }],\n  tools: [{\n    type: 'function',\n    function: {\n      name: 'convert_currency',\n      description: 'Конвертація валют',\n      parameters: {\n        type: 'object',\n        properties: {\n          amount: { type: 'number' },\n          from: { type: 'string' },\n          to: { type: 'string' },\n        },\n        required: ['amount', 'from', 'to'],\n      },\n    },\n  }],\n});\n\nconst toolCall = response.choices[0].message.tool_calls?.[0];\nconsole.log(`Функція: ${toolCall?.function.name}`);\nconsole.log(`Аргументи: ${toolCall?.function.arguments}`);

Усі приклади використовують офіційний OpenAI SDK — жодних додаткових бібліотек не потрібно. Просто замініть base_url та api_key.

JoinGonka Gateway підтримує всі стандартні параметри OpenAI Chat Completions API:

Параметри моделі Qwen3-235B: контекстне вікно — 128K токенів, максимальна відповідь — 2048 токенів. Повні специфікації: HuggingFace. Список моделей доступний через GET /v1/models.

Два ендпоінти:

• OpenAI-формат: POST https://gate.joingonka.ai/v1/chat/completions
• Anthropic-формат: POST https://gate.joingonka.ai/v1/messages

Аутентифікація: Authorization: Bearer jg-ваш-ключ (OpenAI) або x-api-key: jg-ваш-ключ (Anthropic)

Формат відповіді повністю сумісний з OpenAI та Anthropic — будь-який SDK, бібліотека або фреймворк, що підтримує OpenAI або Anthropic API, працює з JoinGonka Gateway без модифікацій. Claude Code підключається через Anthropic-формат напряму.