퀵 스타트
쓰던 에이전트 그대로 — Claude Code, OpenClaw Hermes, Cline, Aider, Continue, 또는 OpenAI를 지원하는 어떤 도구든. base URL 하나를 지정하고 키를 넣으면 공유 GPU 위의 오픈 모델로 코딩할 수 있습니다.
당신의 에이전트 → api.openalchemy.io → Grid 위의 오픈 웨이트 모델
세 단계
콘솔에 로그인해 프로젝트를 만들고 API 키를 발급합니다. 무료 등급은 신용카드가 필요 없습니다.
에이전트 설정에 base URL과 API 키를 입력합니다. OpenAI 호환 URL, 또는 Claude Code용 Anthropic 호환 URL 중 하나입니다.
llama-3.1-8b-instruct 같은 모델 ID를 골라 요청을 보내면 됩니다. 코드 변경 없이 언제든 모델을 바꿀 수 있습니다.
두 가지 연결 방법
대부분의 에이전트는 OpenAI API를 사용합니다. Claude Code는 Anthropic Messages API를 사용합니다. OpenAlchemy는 둘 다 제공하므로 어느 도구를 쓰든 같은 키가 작동합니다.
이 base_url과 키를 OpenAI SDK나 OpenAI 호환 에이전트(Hermes·Cline·Aider·Continue·Codex CLI)에 넣기만 하면 됩니다.
이것을 ANTHROPIC_BASE_URL로 설정하면 Claude Code가 프록시 없이 Messages API 호출을 OpenAlchemy로 보냅니다.
에이전트 설정
각 스니펫은 생성한 OPENALCHEMY_API_KEY와 예시 모델 llama-3.1-8b-instruct를 사용합니다. 카탈로그의 어떤 모델로든 교체할 수 있습니다.
Anthropic의 터미널 기반 코딩 에이전트. Anthropic 호환 엔드포인트로 연결합니다.
# Claude Code speaks the Anthropic Messages API — point it at
# OpenAlchemy's Anthropic-compatible endpoint and run as usual.
export ANTHROPIC_BASE_URL="https://api.openalchemy.io"
export ANTHROPIC_AUTH_TOKEN="$OPENALCHEMY_API_KEY"
export ANTHROPIC_MODEL="llama-3.1-8b-instruct"
claudeHermes의 OpenAI 호환 프로바이더를 OpenAlchemy로 향하게 하고 모델을 선택합니다.
# Hermes uses an OpenAI-compatible provider. Export the base URL and
# key, then select the model inside Hermes.
export OPENAI_BASE_URL="https://api.openalchemy.io/v1"
export OPENAI_API_KEY="$OPENALCHEMY_API_KEY"
# Provider: OpenAI-compatible
# Base URL: https://api.openalchemy.io/v1
# Model: llama-3.1-8b-instruct
hermesVS Code 자율 코더(및 Roo Code 포크). 'OpenAI Compatible' 프로바이더를 사용합니다.
# VS Code → Cline (or Roo Code) settings → API Provider:
API Provider = OpenAI Compatible
Base URL = https://api.openalchemy.io/v1
API Key = $OPENALCHEMY_API_KEY
Model ID = llama-3.1-8b-instruct터미널 페어 프로그래머. Aider는 OPENAI_API_BASE를 통해 openai/llama-3.1-8b-instruct를 라우팅합니다.
export OPENAI_API_BASE="https://api.openalchemy.io/v1"
export OPENAI_API_KEY="$OPENALCHEMY_API_KEY"
aider --model openai/llama-3.1-8b-instruct오픈소스 IDE 어시스턴트. 커스텀 apiBase의 openai 프로바이더를 추가합니다.
# ~/.continue/config.yaml
models:
- name: OpenAlchemy
provider: openai
apiBase: https://api.openalchemy.io/v1
apiKey: ${OPENALCHEMY_API_KEY}
model: llama-3.1-8b-instructOpenAI SDK로 만든 모든 도구(Codex CLI 포함)는 동일한 base_url과 키로 연결됩니다.
from openai import OpenAI
client = OpenAI(
base_url="https://api.openalchemy.io/v1",
api_key="$OPENALCHEMY_API_KEY",
)
resp = client.chat.completions.create(
model="llama-3.1-8b-instruct",
messages=[{"role": "user", "content": "Write a haiku about distributed GPUs."}],
)
print(resp.choices[0].message.content)
# Codex CLI: add a custom provider with the same base_url + key.FAQ
네. /v1 표면은 OpenAI REST API(채팅 완성, 임베딩, 오디오 등)를 그대로 반영합니다. 기존 OpenAI SDK와 도구는 base_url과 키만 바꾸면 작동합니다.
네. OpenAlchemy는 Anthropic 호환 엔드포인트도 제공합니다. ANTHROPIC_BASE_URL을 https://api.openalchemy.io로, ANTHROPIC_AUTH_TOKEN을 키로 설정하면 됩니다. 프록시가 필요 없습니다.
모달리티 전반의 오픈 웨이트 모델 — 채팅용 Llama·Qwen·DeepSeek·Gemma에 더해 Whisper·임베딩·리랭커 등. GET /v1/models로 목록을 보고 요청에 ID를 전달하세요.
아니요. 무료 등급에서는 카드 없이 프로젝트 하나를 만들고 첫 1,000건의 요청을 실행할 수 있습니다.
사용량, 쿼터, 요청 로그는 프로젝트 단위로, 레이트 제한과 접근 제어는 도메인 단위로 적용됩니다. 키가 그 범위를 자동으로 가집니다.
스트리밍 응답(SSE)은 순차적으로 출시 중이며, 일부 엔드포인트는 현재 stream:true에 대해 501을 반환합니다. 비스트리밍 요청은 현재 완전히 지원됩니다.
빌드 시작
무료 프로젝트를 만들고 키를 받아 Grid 위에서 실행되는 오픈 모델로 에이전트를 향하게 하세요.