快速开始

获取 API Key 并选择接入点后，可以直接调用 HTTP API或配置客户端，发出第一条请求。

1. 注册并复制 API Key

打开注册，登录后到密钥设置复制 Key。Key 只放进各客户端自己的配置或登录命令，不要写进仓库、截图或聊天记录。泄露后在同一页点「轮换 Key」，旧 Key 立即失效。

2. 选择接入点

到接入点选择为要用的模型族选一个接入点，并保存。部分模型只在指定接入点提供，例如 Claude Fable 5 需要「Claude Max 20x 订阅」。没选接入点时，请求会直接失败，而不是自动挑一个。

直接发第一条 API 请求

在终端把站内 Key 设置为环境变量 ICODEEASY_API_KEY。下面用 deepseek-flash，请先为 DeepSeek 选好支持直接 HTTP 调用和 Chat Completions 的接入点。也可以换成你所选接入点支持的模型 ID。

curl -sS https://api.icodeeasy.cc/v1/chat/completions \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"model":"deepseek-flash","messages":[{"role":"user","content":"Say hello."}],"stream":false}'

收到 HTTP 200 后，从 choices[0].message.content 读取回复。

生成第一张图或第一个视频

• 图片。用 POST /v1/images/generations?sync=1 提交提示词。收到 HTTP 200 后打开 data[0].url。如果改用 ?async=1，保存返回的 task_id，查询 GET /v1/images/tasks/{task_id} 直到 completed，再读取 result_url。见图片请求示例。
• 视频。用 POST /v1/videos/generations 创建任务。收到 HTTP 202 后，保存 task_id 并轮询 status_url。状态变成 succeeded 后，通过 content_url 下载。见视频五分钟快速接入。

配置一个客户端

主 API 地址：

https://api.icodeeasy.cc

本机到这个域名慢或超时时，改用备用地址，路径和 Key 不变：

https://jp.icodeeasy.cc
https://sg.icodeeasy.cc

各客户端要改的字段不同，按对应指南填写，不要把一份配置原样贴到另一个客户端：

• Claude Code / Desktop
• Codex
• Gemini CLI：地址只填域名，不要加 /v1beta
• ICodeEasy

同一把 Key 可以同时用于这些客户端，见一把 Key 配多个客户端。

在客户端发一条普通消息，确认收到回复。

核对请求结果

收到响应后，到请求日志核对模型、状态和费用。价格以价格页和用量与余额为准。

还没有 Node.js 时，先做环境准备。401、429 或一直连不上，看连接排查。