hopimg 接入文档

概览

拿到密钥

1. 1. 打开 hopimg.com,用邮箱注册。
2. 2. 进「钱包」充值任意套餐。
3. 3. 到「API 密钥」页点「新建密钥」。密钥只显示这一次,立刻复制保存!

下面例子里的 YOUR_API_KEY 全部换成你的密钥(形如 sk-...)。

Claude 对话(Messages API)

hopimg 提供 真 Claude 对话接口,完全兼容 Anthropic 的 POST /v1/messages。鉴权用 x-api-key(或 Authorization: Bearer),模型填 claude-opus-4-8。

curl -sS -N https://api.hopimg.com/v1/messages \
  -H "x-api-key: YOUR_CLAUDE_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 1024,
    "stream": true,
    "messages": [
      { "role": "user", "content": "用一句话介绍你自己" }
    ]
  }'

返回与 Anthropic 官方完全一致,文本在 content[0].text。建议带 stream:true —— 长回答非流式在边缘约 100 秒可能 524 超时。按 token 计费(输入 + 输出),用量在「用量历史」可见。

GPT 对话(OpenAI 兼容)

同一个网关也提供 OpenAI 兼容 的对话接口 POST /v1/chat/completions,模型填 gpt-5.5(也支持 gpt-5.5 / gpt-5.4-mini 等),鉴权用 Authorization: Bearer。

curl -sS -N https://api.hopimg.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_OPENAI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "stream": true,
    "messages": [
      { "role": "user", "content": "用一句话介绍你自己" }
    ]
  }'

返回与 OpenAI 官方一致,文本在 choices[0].message.content(流式在 delta.content)。建议带 stream:true,按 token 计费。

用 Claude Code

因为对话接口是 Anthropic 兼容的,官方 Claude Code 直接把 Base URL 指过来就能用 —— 设两个环境变量即可,密钥用「claude」分组的那把。

# 安装 Claude Code
npm i -g @anthropic-ai/claude-code

# 指向 hopimg(把 token 换成你的「claude」分组密钥)
export ANTHROPIC_BASE_URL=https://api.hopimg.com
export ANTHROPIC_AUTH_TOKEN=YOUR_CLAUDE_KEY

# 进入任意项目目录直接用
claude

ANTHROPIC_BASE_URL 用根域名 https://api.hopimg.com(不带 /v1),ANTHROPIC_AUTH_TOKEN 填你的密钥。其它 Anthropic 兼容客户端(Cline、各类 SDK)同理。

用 Codex CLI

OpenAI 官方 Codex CLI 也能直接接 hopimg —— 放好下面两个文件(密钥用 openai 分组),进任意项目跑 codex 即可。

1. ~/.codex/config.toml（放在文件开头）

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.hopimg.com"
wire_api = "responses"
requires_openai_auth = true

2. ~/.codex/auth.json

{ "OPENAI_API_KEY": "YOUR_OPENAI_KEY" }

base_url 指向 https://api.hopimg.com(根域名),模型 gpt-5.5。安装:npm i -g @openai/codex。若报 403 dispatch,同 GPT 对话:把密钥分组切到 openai。

文生图(Text → Image)

给一句 prompt,生成一张图。POST /v1/images/generations,JSON 请求体。复制下面任意一种,把密钥换上直接跑。

curl -sS -m 185 https://api.hopimg.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a red panda eating bamboo, studio lighting",
    "n": 1,
    "size": "1024x1024",
    "response_format": "b64_json"
  }' \
  | python3 -c "import sys,json,base64; d=json.load(sys.stdin); open('out.png','wb').write(base64.b64decode(d['data'][0]['b64_json'])); print('saved out.png')"

成功返回 data[0].b64_json(图片的 base64),解码写文件即可。

图生图(Image → Image)

传一张图 + 一句 prompt,在原图基础上改。POST /v1/images/edits,multipart/form-data(图片放 image 字段)。注意 endpoint 是复数 edits。

curl -sS -m 185 https://api.hopimg.com/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F model=gpt-image-2 \
  -F [email protected] \
  -F prompt="put the subject in a snowy forest at night" \
  -F size=1024x1024 \
  -F response_format=b64_json \
  | python3 -c "import sys,json,base64; d=json.load(sys.stdin); open('out.png','wb').write(base64.b64decode(d['data'][0]['b64_json'])); print('saved out.png')"

把 input.png 换成你自己的图(PNG / JPG / WebP),返回格式和文生图一样。

参数说明

返回格式

成功返回 200,图片在 data[0].b64_json 里,是纯 base64(无需去前缀),直接解码写文件即可。

{
  "created": 1781184210,
  "data": [
    { "b64_json": "iVBORw0KGgoAAAANSUhEUg..." }
  ],
  "usage": {
    "input_tokens": 8,
    "output_tokens": 0,
    "total_tokens": 8
  }
}

价格

以上为 1024×1024 的典型单价;实际按 token 用量计费,尺寸越大略高。按量计费,用多少扣多少;充值 ¥1 = $1 配额。图生图因含输入图片,单价高于文生图。用量与花费在控制台「用量历史」实时可见。

Base URL

任何 OpenAI 兼容客户端 / SDK,把 base_url 设成下面这个,api_key 用你的 hopimg 密钥即可:

https://api.hopimg.com/v1

错误码

常见问题

搞不定?找客服

接不通、报错、余额不对,都可以找我们。