Documentation
Guides / 빠른 시작
Guides · 빠른 시작

빠른 시작

AllToken 시작하기.

소개

AllToken은 단일 인터페이스를 통해 수백 개의 AI 모델에 접근할 수 있는 통합 API를 제공하며, 자동 장애 조치(failover)와 최적의 가성비 옵션 선택을 처리합니다.

단 몇 줄의 코드로 원하는 SDK나 프레임워크를 사용해 바로 호출할 수 있습니다.

Base URL： https://api.alltoken.ai/v1

인증 방식： Bearer API Key

호환성： OpenAI 호환 API

API Key 발급

시작하기 전에 API Key를 먼저 생성하세요:

  1. 설정 → API Keys로 이동
  2. 새 Key 생성 클릭
  3. Key를 복사하여 안전하게 보관 — 한 번만 표시됩니다

API Key를 안전하게 보관하고, 클라이언트 코드나 공개 저장소에 노출하지 마세요.

에이전트 스킬로 설치

이미 사용하는 스택이 AllToken을 지원한다면 통합 코드를 직접 작성하지 않아도 됩니다. AllToken은 SKILL.md 파일을 로드하는 agent runtime용 공식 skill 두 가지를 제공하며, 한 번의 명령으로 설치하면 agent가 AllToken API 전체를 사용할 수 있습니다.

Skill기능
alltokenTypeScript 또는 Python AllToken 프로젝트를 생성합니다. chat, 비동기 이미지, 비동기 비디오, streaming, tool-calling agent core, 선택적 Ink TUI를 포함합니다.
alltoken-callagent가 채팅에서 인식하는 6개의 slash-style 명령: /alltoken-chat, /alltoken-image, /alltoken-video, /alltoken-search, /alltoken-models, /alltoken-cost. Stdlib Python recipes라서 pip install이 필요 없습니다.

둘 다 MIT로 배포됩니다. 소스: github.com/alltoken-ai/alltoken-skills.

runtime에 설치

OpenClaw (ClawHub CLI 사용):

OpenClaw
$clawhub skill install alltoken
clawhub skill install alltoken-call

Hermes Agent (직접 URL 설치):

Hermes Agent
$hermes skills install https://alltoken.ai/skills/alltoken/SKILL.md
hermes skills install https://alltoken.ai/skills/alltoken-call/SKILL.md

Claude Code / Codex CLI / OpenCode - SKILL.md 파일을 프로젝트의 skills/ 디렉터리에 넣습니다:

Claude Code / Codex CLI / OpenCode
$mkdir -p ./skills/alltoken-call
curl -fsSL https://alltoken.ai/skills/alltoken-call/SKILL.md -o ./skills/alltoken-call/SKILL.md

agent는 다음 session에서 skill을 로드합니다.

사용해 보기

agent가 실행되는 환경에 ALLTOKEN_API_KEY가 설정되어 있는지 확인하세요. 그런 다음 자연어로 요청합니다:

  • "alltoken-call skill을 사용해 1024x1024 찻주전자 이미지를 생성합니다."
  • "alltoken을 사용해 ./my-agent에 AllToken chat 프로젝트를 생성합니다."
  • "/alltoken-models --type=video를 실행해 사용 가능한 비디오 모델을 표시합니다."

SillyTavern으로 roleplay를 하나요? 전용 가이드를 확인하세요: Use AllToken with SillyTavern.

직접 통합 코드를 작성하려면 아래 SDK 설치로 이어서 TypeScript / Python 경로를 확인하세요.

SDK 설치

AllToken은 OpenAI SDK와 완전히 호환됩니다. 원하는 패키지 매니저로 설치하세요:

npm
$npm install openai

그런 다음 환경 변수를 설정하세요:

Shell
$export ALLTOKEN_API_KEY="your_alltoken_api_key"

첫 번째 요청 보내기

클라이언트를 생성하고, 모델을 선택한 후 채팅 요청을 전송하세요:

TypeScript
1import OpenAI from 'openai';
2
3const client = new OpenAI({
4 apiKey: process.env.ALLTOKEN_API_KEY,
5 baseURL: 'https://api.alltoken.ai/v1',
6});
7
8const completion = await client.chat.completions.create({
9 model: 'minimax-m2.7',
10 messages: [
11 {
12 role: 'user',
13 content: '인생의 의미는 무엇인가요?',
14 },
15 ],
16});
17
18console.log(completion.choices[0]?.message?.content);

Python 예제

Python
1from openai import OpenAI
2import os
3
4client = OpenAI(
5 api_key=os.environ.get("ALLTOKEN_API_KEY"),
6 base_url="https://api.alltoken.ai/v1",
7)
8
9completion = client.chat.completions.create(
10 model="minimax-m2.7",
11 messages=[
12 {"role": "user", "content": "인생의 의미는 무엇인가요?"}
13 ],
14)
15
16print(completion.choices[0].message.content)

API 직접 호출

cURL이나 임의의 HTTP 클라이언트로 API를 직접 호출할 수도 있습니다:

cURL
1curl https://api.alltoken.ai/v1/chat/completions \
2 -H "Authorization: Bearer $ALLTOKEN_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "model": "minimax-m2.7",
6 "messages": [
7 {"role": "user", "content": "안녕하세요!"}
8 ]
9 }'

스트리밍 응답

stream: true를 추가하면 Server-Sent Events를 통해 Token 단위로 응답을 수신할 수 있습니다:

TypeScript
1const stream = await client.chat.completions.create({
2 model: 'minimax-m2.7',
3 messages: [{ role: 'user', content: '이야기를 하나 들려주세요' }],
4 stream: true,
5});
6
7for await (const chunk of stream) {
8 const content = chunk.choices[0]?.delta?.content;
9 if (content) process.stdout.write(content);
10}

자세한 스트리밍 문서는 스트리밍 응답을 참고하세요.

다음 단계