快速开始
沿用你习惯的 agent —— Claude Code、OpenClaw Hermes、Cline、Aider、Continue,或任何支持 OpenAI 的工具。指向一个 base URL、填入密钥,就能在共享 GPU 上的开放模型里编程。
你的 agent → api.openalchemy.io → Grid 上的开放权重模型
三步
登录控制台,创建一个项目并生成 API 密钥。免费额度无需信用卡。
在 agent 设置里填入 base URL 与 API 密钥 —— OpenAI 兼容的 URL,或给 Claude Code 用的 Anthropic 兼容 URL。
选择一个模型 ID,例如 llama-3.1-8b-instruct,即可发送请求。随时切换模型,无需改动代码。
两种连接方式
大多数 agent 说 OpenAI API,Claude Code 说 Anthropic Messages API。OpenAlchemy 两者都开放,所以无论你的工具用哪种,同一把密钥都能用。
把这个 base_url 和密钥填进 OpenAI SDK 或任何 OpenAI 兼容 agent —— Hermes、Cline、Aider、Continue、Codex CLI。
将它设为 ANTHROPIC_BASE_URL,Claude Code 就会把 Messages API 调用直接发往 OpenAlchemy,中间无需代理。
AGENT 配置
每段代码都使用你创建的 OPENALCHEMY_API_KEY 和示例模型 llama-3.1-8b-instruct。可替换为目录中的任意模型。
Anthropic 的终端原生编程 agent。通过 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"
claude把 Hermes 的 OpenAI 兼容 provider 指向 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」provider。
# 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 provider。
# ~/.continue/config.yaml
models:
- name: OpenAlchemy
provider: openai
apiBase: https://api.openalchemy.io/v1
apiKey: ${OPENALCHEMY_API_KEY}
model: llama-3.1-8b-instruct任何基于 OpenAI 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.常见问题
是的。/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。非流式请求当前已完全支持。
开始构建
创建一个免费项目,取得密钥,把你的编程 agent 指向运行在 Grid 上的开放模型。