快速接入 · REDH Token

01拿到 Key

Key 按项目发放。告诉我们你在做什么、需要哪些模型，Key 会连同模型白名单和限速一起发给你。

把它放进环境变量：

export REDH_API_KEY="rh_live_••••••••"

申请 Key

02把 SDK 指向 REDH

格式接口地址端点

OpenAI 格式https://token.redh.ai/v1/chat/completions · /responses · /images · /videos · /audio · /embeddings

Claude 格式https://token.redh.ai/v1/messages

所有模型都能用 OpenAI 格式调用；Claude 模型同时支持 Claude 格式。

03第一次调用

curl https://token.redh.ai/v1/chat/completions \
  -H "Authorization: Bearer $REDH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "messages": [{"role": "user", "content": "你好，来自香港"}]
  }'

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://token.redh.ai/v1",
    api_key=os.environ["REDH_API_KEY"],
)

reply = client.chat.completions.create(
    model="gpt-6.1-sol",
    messages=[{"role": "user", "content": "你好，来自香港"}],
)
print(reply.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://token.redh.ai/v1",
  apiKey: process.env.REDH_API_KEY,
});

const reply = await client.chat.completions.create({
  model: "deepseek-v4.1-flash",
  messages: [{ role: "user", content: "你好，来自香港" }],
});
console.log(reply.choices[0].message.content);

换模型只要改 model 这一个字符串，别的都不用动。

04Claude 格式

import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://token.redh.ai",
    api_key=os.environ["REDH_API_KEY"],
)

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好，来自香港"}],
)
print(message.content[0].text)

curl https://token.redh.ai/v1/messages \
  -H "x-api-key: $REDH_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好，来自香港"}]
  }'

反复出现的长系统提示和工具定义会在上游缓存，读缓存的部分按输入价的一小部分计费。

05图像与视频

图像在同一次调用里返回。

curl https://token.redh.ai/v1/images/generations \
  -H "Authorization: Bearer $REDH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-image-2.5", "prompt": "A matte black robot hand holding a red chip", "size": "1024x1024"}'

视频是异步任务：先提交，记下任务 ID，生成好了再取回文件。

# 1. 提交任务，返回任务 ID
curl https://token.redh.ai/v1/videos \
  -H "Authorization: Bearer $REDH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "veo-3.1", "prompt": "Victoria Harbour at dusk, slow drone push", "seconds": "8"}'

# 2. 生成好了再取回
curl https://token.redh.ai/v1/videos/$JOB_ID \
  -H "Authorization: Bearer $REDH_API_KEY"

06编程工具

export ANTHROPIC_BASE_URL="https://token.redh.ai"
export ANTHROPIC_AUTH_TOKEN="$REDH_API_KEY"
claude

# ~/.codex/config.toml
model = "gpt-6.1-sol"
model_provider = "redh"

[model_providers.redh]
name = "REDH Token"
base_url = "https://token.redh.ai/v1"
env_key = "REDH_API_KEY"
wire_api = "responses"

07需要的模型不在列表里？

来信告诉我们模型名称和预计用量，我们会回复能否在你的 Key 上开通。

写信给我们