接入方式
开发者对接
创建 Key，选择协议，把图片生成接进你的工具或项目。
让 AI 来读文档 🥺👉
- 01
创建 API Key
在控制台创建对应模型分组的 Key。
前往控制台 - 02
选择调用协议
新项目优先 Studio 统一协议；已有 SDK 可保留原生协议。
对比三种协议 - 03
填入连接信息并发送
复制 Base URL、模型名和当前语言的示例代码。
打开协议文档
地址与认证
默认
https://api.1route.dev频繁超时可改用 https://image-api.1route.dev| 项目 | 填写内容 |
|---|---|
| API Key | 在主站控制台创建的 Key |
| Studio 统一协议 | 服务地址作为 Base URL，模型带 openai/ 或 google/ 前缀 |
| OpenAI SDK | base_url 为服务地址加 /v1，如 https://api.1route.dev/v1 |
| Google Gen AI SDK | Base URL 使用服务地址，API 版本为 v1beta |
HTTP 示例统一使用 Authorization: Bearer YOUR_API_KEY。Google 官方 SDK 使用 x-goog-api-key。请求不同模型时，请使用对应分组的 Key。
没有 Key？去创建根据使用的模型，选择 🎨 GPT Image 或 🍌 Nano Banana 分组。
OpenAPI 接入
直接调用 Studio HTTP 接口时，可让 AI 读取这份 OpenAPI 文档，或导入支持 OpenAPI 的工具，核对接口、请求字段和响应结构。结合 Studio 协议说明中的模型扩展和异步任务流程生成接入代码。
选择模型
🎨 GPT Image 可选 gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst。Google 可选 gemini-3.1-flash-image（🍌 Nano Banana 2）和 gemini-3-pro-image（🍌 Nano Banana Pro）。具体名称与差异见模型对比。
例如，在 Studio 统一协议中使用 openai/gpt-image-2.5-flare；在 OpenAI Images 中使用 gpt-image-2.5-flare。
第一次调用
- 选择协议页，复制与你的语言对应的示例。
- 先用一条短提示词发送文生图请求，再加入参考图或其他参数。
- Studio 统一协议等待
completed后取结果；原生协议直接解析响应中的图片。 - 将图片保存到自己的存储。服务端图片 URL 与任务结果保留 72 小时。