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를 통해 사용할 수 있습니다.

두 가지 엔드포인트:

• 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 형식을 통해 직접 연결됩니다.