APIクイックスタート — curl, Python, TypeScript

APIの動作を確認する最も速い方法は curl です。

通常のリクエスト:

curl https://gate.joingonka.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer jg-あなたのキー" \
  -d '{
    "model": "Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",
    "messages": [
      {"role": "user", "content": "Gonkaとは何ですか？"}
    ]
  }'

ストリーミング (部分的な応答):

curl https://gate.joingonka.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer jg-あなたのキー" \
  -d '{
    "model": "Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",
    "messages": [
      {"role": "user", "content": "Pythonで'hello world'を書いてください"}
    ],
    "stream": true
  }'

応答はJSON形式 (通常) またはServer-Sent Events (ストリーミング) で返されます。OpenAI APIと完全に互換性があります。

公式のOpenAI Python SDK は、JoinGonka Gateway と変更なしで動作します。

pip install openai

通常のリクエスト:

from openai import OpenAI

client = OpenAI(
    base_url="https://gate.joingonka.ai/v1",
    api_key="jg-あなたのキー",
)

response = client.chat.completions.create(
    model="Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",
    messages=[
        {"role": "user", "content": "ブロックチェーンを簡単な言葉で説明してください"}
    ],
)

print(response.choices[0].message.content)

ストリーミング:

stream = client.chat.completions.create(
    model="Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",
    messages=[{"role": "user", "content": "Pythonでソートアルゴリズムを書いてください"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

ツール呼び出し:

import json

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "都市の天気を取得する",
        "parameters": {
            "type": "object",
            "properties": {
                "city": {"type": "string", "description": "都市名"}
            },
            "required": ["city"]
        }
    }
}]

response = client.chat.completions.create(
    model="Qwen/Qwen3-235B-A22B-Instruct-2507-FP8",
    messages=[{"role": "user", "content": "モスクワの天気はどうですか？"}],
    tools=tools,
)

tool_call = response.choices[0].message.tool_calls[0]
print(f"関数: {tool_call.function.name}")
print(f"引数: {tool_call.function.arguments}")

Qwen3-235B はネイティブなツール呼び出しをサポートしており、関数はテキスト応答を解析することなく正しく呼び出されます。

インストール:

npm install openai

通常のリクエスト:

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://gate.joingonka.ai/v1',
  apiKey: 'jg-あなたのキー',
});

async function main() {
  const response = await client.chat.completions.create({
    model: 'Qwen/Qwen3-235B-A22B-Instruct-2507-FP8',
    messages: [
      { role: 'user', content: 'Express.jsサーバーを書いてください' },
    ],
  });

  console.log(response.choices[0].message.content);
}

main();

ストリーミング:

const stream = await client.chat.completions.create({
  model: 'Qwen/Qwen3-235B-A22B-Instruct-2507-FP8',
  messages: [{ role: 'user', content: 'async/await を説明してください' }],
  stream: true,
});

for await (const chunk of stream) {
  const content = chunk.choices[0]?.delta?.content || '';
  process.stdout.write(content);
}

ツール呼び出し:

const response = await client.chat.completions.create({
  model: 'Qwen/Qwen3-235B-A22B-Instruct-2507-FP8',
  messages: [{ role: 'user', content: '100 USDをEURに変換してください' }],
  tools: [{
    type: 'function',
    function: {
      name: 'convert_currency',
      description: '通貨換算',
      parameters: {
        type: 'object',
        properties: {
          amount: { type: 'number' },
          from: { type: 'string' },
          to: { type: 'string' },
        },
        required: ['amount', 'from', 'to'],
      },
    },
  }],
});

const toolCall = response.choices[0].message.tool_calls?.[0];
console.log(`関数: ${toolCall?.function.name}`);
console.log(`引数: ${toolCall?.function.arguments}`);

すべての例は公式のOpenAI SDKを使用しており、追加のライブラリは不要です。base_url と api_key を置き換えるだけです。

JoinGonka Gatewayは、すべての標準的なOpenAI Chat Completions APIパラメーターをサポートしています。

Qwen3-235Bモデルのパラメーター：コンテキストウィンドウは128Kトークン、最大応答は2048トークン。完全な仕様：HuggingFace。モデルリストはGET /v1/modelsで利用可能です。

2つのエンドポイント：

• 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と完全に互換性があります。OpenAIまたはAnthropic APIをサポートするSDK、ライブラリ、またはフレームワークは、 модиケーションなしでJoinGonka Gatewayと動作します。Claude CodeはAnthropic形式を介して直接接続されます。