快速开始

1. 拿到 API Key

在 控制台 创建令牌,形如 sk-xxxxxxxx。

密钥保管

请放在服务端调用,不要写进前端代码或客户端 App。

2. 发出第一个请求

默认接入端点为 https://api.llmnex.com；香港加速端点为 https://hk.llmnex.com。切换时只替换域名，不改接口路径。控制台地址不用于 API 接入，详见 API 地址与鉴权。

生图必须明确指定 IMAGE

为兼容首字快速响应，后端已兼容 TEXT 模式。生图时必须在 generationConfig.responseModalities 中明确包含 "IMAGE"，建议使用 ["IMAGE"]；省略该参数或仅指定 TEXT 时，Pro 模型可能生成文字。

生图(Gemini 协议)

curl -X POST "https://api.llmnex.com/v1beta/models/gemini-3-pro-image-c:generateContent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 300 \
  -d '{"contents":[{"parts":[{"text":"a red ceramic teapot"}]}],"generationConfig":{"responseModalities":["IMAGE"]}}'

查看可用模型

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.llmnex.com/v1/models

示例使用带 -c 后缀的模型，按次计费；不带 -c 的模型按 token 计费。请先查询当前 Key 的可用模型，确认完整名称与计费方式，详见 模型查询。

3. 三个必须知道的点

客户端超时给足：Gemini 300 秒

当前生图速度较此前大幅提升：1K 约 15–25 秒、2K 约 15–35 秒、4K 约 20–45 秒（服务端出图时间，不含图片传输）。这不是最长耗时保证；为高峰期排队、重试和传输留出余量，客户端超时仍建议设到 300 秒。

不要自己加激进重试

服务内部已有重试机制，不要在客户端叠加激进的循环重试。 429 可退避 2–5 秒后尝试重试一次，500 可稍后尝试重试一次；不保证重试成功。503 要先看错误消息：模型名或权限问题应先修正，只有临时上游连接问题才考虑退避后重试一次。400 / 451 不要原样自动重试。 报障时附上响应头 X-Oneapi-Request-Id。

451 是终态,不要重试

451 表示内容被安全审核拦截，请修改提示词或参考图，不要对同一请求自动重试；重复提交不保证通过审核，是否扣费以账单为准。

下一步

• 生图介绍 —— 模型清单与选型
• Gemini 接入指南 —— 完整参数、图生图、流式、错误处理