TokenHub Quick Start - WAND Documentation

TokenHub는 OpenAI API 프로토콜과 호환되는 LLM 게이트웨이입니다. 이 문서는 콘솔 개통부터 첫 모델 호출까지의 절차를 안내합니다.

사전 준비

Tencent Cloud International 계정 (없다면 가입 후 실명 인증 완료)

1

TokenHub 콘솔 개통

TokenHub 콘솔에 로그인하고 화면 안내에 따라 서비스를 활성화합니다. 개통 후 Model Gallery에서 제공 모델을 확인할 수 있습니다. 모델별 상세 정보는 Model List를 참조하세요.

2

모델 후과금 활성화

TokenHub는 모델별 후과금(pay-as-you-go) 방식으로 과금됩니다. 사용할 모델을 Online Inference 목록에서 찾아 활성화합니다.

3

API Key 생성

API Key 페이지로 이동합니다.
페이지 상단에서 리전을 선택한 후 Create a Key를 클릭합니다.
Create a Key 대화 상자에서 Key Name을 입력하고 Accessible Range를 설정합니다.
- Select All: 현재 계정의 모든 모델과 추론 서비스에 접근합니다.
- Defined Range: 특정 모델과 추론 서비스만 선택해 접근을 제한합니다.
Confirm을 클릭해 생성합니다.

생성 직후 표시되는 API Key를 반드시 복사해 안전하게 저장하세요. 이후 API 호출의 인증에 사용됩니다. 자세한 관리 방법은 API Key 관리를 참조하세요.

4

첫 API 호출

TokenHub는 OpenAI API 프로토콜과 호환되므로 기존 OpenAI SDK를 그대로 사용할 수 있습니다. 예시의 YOUR_API_KEY를 발급받은 키로, model 값을 사용할 모델로 교체하세요. 모델 값은 Model List의 Model (API Parameter) 항목에서 확인합니다.

cURL
Python
Node.js
Java
Go

curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/chat/completions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "deepseek-v3.2",
    "messages": [{"role": "user", "content": "hello"}],
    "stream": true
  }'

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://tokenhub-intl.tencentcloudmaas.com/v1"
)

response = client.chat.completions.create(
    model="deepseek-v3.2",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello, please introduce yourself"}
    ]
)
print(response.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://tokenhub-intl.tencentcloudmaas.com/v1',
});

async function main() {
  const response = await client.chat.completions.create({
    model: 'deepseek-v3.2',
    messages: [
      { role: 'system', content: 'You are a helpful assistant.' },
      { role: 'user', content: 'Hello, please introduce yourself' },
    ],
  });
  console.log(response.choices[0].message.content);
}

main();

import java.net.http.*;
import java.net.URI;

public class MaaSExample {
    public static void main(String[] args) throws Exception {
        String apiKey = "YOUR_API_KEY";
        String body = """
            {
                "model": "deepseek-v3.2",
                "messages": [{"role": "user", "content": "hello"}]
            }
            """;

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://tokenhub-intl.tencentcloudmaas.com/v1/chat/completions"))
            .header("Authorization", "Bearer " + apiKey)
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(body))
            .build();

        HttpClient client = HttpClient.newHttpClient();
        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    apiKey := "YOUR_API_KEY"
    body := map[string]interface{}{
        "model": "deepseek-v3.2",
        "messages": []map[string]string{
            {"role": "user", "content": "hello"},
        },
    }

    jsonBody, _ := json.Marshal(body)
    req, _ := http.NewRequest("POST",
        "https://tokenhub-intl.tencentcloudmaas.com/v1/chat/completions",
        bytes.NewBuffer(jsonBody))
    req.Header.Set("Authorization", "Bearer "+apiKey)
    req.Header.Set("Content-Type", "application/json")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    result, _ := io.ReadAll(resp.Body)
    fmt.Println(string(result))
}

예시는 Singapore 사이트 엔드포인트 기준입니다. 리전별 엔드포인트는 API 사용 가이드를 참조하세요.

다음 단계

Experience Center: 콘솔에서 모델 기능을 온라인으로 체험합니다.
Online Inference: 사용 중인 모델 서비스를 관리합니다.
Usage Statistics: 모델별 사용량을 확인합니다.

Last modified on August 16, 2026

⌘I