开发者文档 · 快速开始
从一个请求开始
使用一个客户端令牌,接入 GPT 文本、GPT 图片和 Gemini 3.8 Flash。示例与本站实际路由保持一致。
API Base URL
https://api.hygoi.com/v1认证:Authorization: Bearer <你的 API 令牌>。控制台登录密码不能代替 API 令牌。
1. 创建令牌
登录控制台 → API 令牌,新建令牌并设置合理的额度、有效期和模型权限。用不同令牌区分测试、开发与生产环境。令牌只放在服务端或本机环境变量中。
export IGO_API_KEY="替换为你在控制台创建的令牌"
2. 获取可用模型
curl https://api.hygoi.com/v1/models \
-H "Authorization: Bearer $IGO_API_KEY"
结果同时受令牌权限、分组和启用渠道影响。模型广场展示价格,/v1/models 用于确认当前令牌可请求的模型。
3. 发起首个请求
curl https://api.hygoi.com/v1/chat/completions \
-H "Authorization: Bearer $IGO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gemini-3.8-flash","messages":[{"role":"user","content":"用一句话介绍你能做什么。"}],"stream":false}'
当前模型
| 能力 | 请求模型 | 指南 |
|---|---|---|
| GPT 文本 | gpt-5.6 / auto | 文本与 SSE |
| GPT 图片 | gpt-image-2 / gpt-image-2.5 / gpt-image-2.5-flare / gpt-image-2.5-sunburst | 图片生成与编辑 |
| Google 路由 | gemini-3.8-flash | Gemini 3.8 Flash |
gemini-3.8-flash 是本站统一别名,映射至上游 gemini-3.8-flash-low。GPT 图片后缀同样是上游路由名称,不能据名称推断固定速度、质量或官方型号。
客户端填写
在支持 OpenAI 兼容协议的客户端中,选择对应提供方,填写 Base URL https://api.hygoi.com/v1 和自己的令牌,再手动添加准确模型 ID。若客户端单独自动拼接 /v1,则仅填 https://api.hygoi.com,以客户端最终请求路径只有一个 /v1 为准。能聊天不代表客户端支持图片接口。
下一步
GPT 文本与 SSE · 图片生成与编辑 · Gemini · 计费规则 · 错误排查。也可下载本站的 OpenAPI 接口描述。
最近更新:2026 年 10 月 24 日 · 参数、价格与可用性以本站当前配置为准。