TokenWorks

API 문서

상세한 연동 가이드와 API 참고 자료로 TokenWorks AI API 서비스를 빠르게 통합하실 수 있습니다

1빠른 시작

TokenWorks API를 사용하려면 세 가지 간단한 단계만 거치면 됩니다:

  1. TokenWorks 계정을 등록하고 콘솔에 로그인하세요
  2. 콘솔에서 API Key를 생성하세요
  3. API Key를 사용하여 인터페이스를 호출하세요

Tip: 신규 사용자는 가입 후 무료 체험 할당량을 받게 되며, 신용카드 등록 없이 바로 사용할 수 있습니다.

2인터페이스 주소

API 기본 주소는 다음과 같으며, 모든 요청은 HTTPS 프로토콜을 사용합니다:

text
https://www.token8341.com/v1

채팅 완성 인터페이스:

text
POST https://www.token8341.com/v1/chat/completions

Note: 이 인터페이스는 OpenAI의 Chat Completions 인터페이스 형식과 완전히 호환되므로, OpenAI SDK를 직접 사용하여 호출할 수 있습니다.

3인증 방식

TokenWorks는 Bearer Token을 사용하여 API 인증을 수행합니다. 요청 헤더에 API Key를 포함하세요:

text
Authorization: Bearer sk-your-api-key-here

콘솔의 'API Keys' 페이지에서 키를 생성하고 관리할 수 있습니다. API Key를 안전하게 보관하고, 공개 코드 저장소나 클라이언트 코드에 노출하지 마세요.

4지원 모델 목록

모델 ID모델 이름공급업체
gpt-4oGPT-4oOpenAI
gpt-4o-miniGPT-4o MiniOpenAI
claude-3-5-sonnetClaude 3.5 SonnetAnthropic
claude-4-sonnetClaude 4 SonnetAnthropic
gemini-2-0-proGemini 2.0 ProGoogle
deepseek-v4-proDeepSeek-V4-ProDeepSeek
qwen-maxQwen-MaxAlibaba Cloud

더 많은 모델이 지속적으로 연동되고 있습니다. 업데이트 공지를 확인해 주세요.

5예제 코드

curl

bash
curl https://www.token8341.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

Python (openai SDK)

python
from openai import OpenAI

client = OpenAI(
    base_url="https://www.token8341.com/v1",
    api_key="sk-your-api-key-here"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "Hello!"}
    ]
)

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

Node.js (openai SDK)

javascript
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://www.token8341.com/v1",
  apiKey: "sk-your-api-key-here",
});

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [
    { role: "user", content: "Hello!" },
  ],
});

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

6오류 코드 설명

API 요청 실패 시 해당 HTTP 상태 코드와 오류 정보가 반환되며, 형식은 다음과 같습니다:

json
{
  "error": {
    "message": "Insufficient balance",
    "type": "insufficient_balance",
    "code": 402
  }
}
상태 코드이름설명
400Bad Request请求参数错误，请检查请求体格式
401UnauthorizedAPI Key 无效或缺失，请检查 Authorization 请求头
402Insufficient Balance账户余额不足，请充值后重试
404Not Found请求的模型或接口不存在
429Rate Limit请求频率过高，请稍后重试
500Internal Server Error服务内部错误，请联系技术支持
503Service Unavailable模型服务暂时不可用，请稍后重试