首页 文生图 图生图 API文档

API 文档

标准 OpenAI 兼容接口,支持文生图和图生图。Base URL 即开即用,一行代码集成图像生成能力到你的应用。

🚀 快速开始

Base URL: https://ai.ugooe.cn/api

无需 API Key 即可体验(使用平台默认Key),推荐注册账户获取专属 API Key 管理配额和用量。

获取 API Key:注册页面 注册后自动获取,或登录 API控制台 查看。

📡 接口列表

方法端点描述
POST/image/generate创建图片生成任务(文生图/图生图)
GET/image/query查询生成任务状态和结果

📤 创建生成任务 POST /image/generate

请求参数

参数类型必填说明
prompt string 图片描述文字,支持中文,最长1000字符
size string 图片尺寸,默认 1024x1024
可选:1024x10241216x832832x12161408x768
model string 模型名称,默认 gpt-image-2
api_key string 用户 API Key,不传则使用平台默认Key

返回结果

字段类型说明
successboolean是否成功提交
task_idstring任务ID,用于查询结果
promptstring原始提示词
sizestring图片尺寸
modelstring使用的模型
providerstring服务提供商
query_endpointstring查询结果用的端点

请求示例

curl 请求
curl -X POST "https://ai.ugooe.cn/api/image/generate?prompt=一只可爱的猫咪在草地上玩耍,水彩风格&size=1024x1024" \ -H "Content-Type: application/json"
Python 请求
import requests # 创建生成任务 resp = requests.post( "https://ai.ugooe.cn/api/image/generate", params={ "prompt": "一只可爱的猫咪在草地上玩耍,水彩风格", "size": "1024x1024", "api_key": "your_api_key_here" # 可选 } ) data = resp.json() print(f"任务ID: {data['task_id']}") # 轮询查询结果 import time task_id = data['task_id'] while True: result = requests.get( f"https://ai.ugooe.cn/api/image/query", params={"task_id": task_id} ).json() if result['state'] in ['completed', 'succeeded']: print(f"图片URL: {result['images']}") break time.sleep(3)
JavaScript 请求
// 创建生成任务 const params = new URLSearchParams({ prompt: '一只可爱的猫咪在草地上玩耍,水彩风格', size: '1024x1024', api_key: 'your_api_key_here' }); const resp = await fetch(`/api/image/generate?${params}`, { method: 'POST' }); const data = await resp.json(); console.log('任务ID:', data.task_id); // 轮询结果 async function pollResult(taskId) { while (true) { const res = await fetch(`/api/image/query?task_id=${taskId}`); const d = await res.json(); if (d.state === 'completed') { return d.images; } await new Promise(r => setTimeout(r, 3000)); } }

📥 查询生成结果 GET /image/query

参数类型必填说明
task_idstring生成任务返回的 task_id
返回字段类型说明
successboolean查询是否成功
task_idstring任务ID
statestring任务状态:pendingprocessingcompletedfailed
progressnumber进度百分比 (0-100)
imagesarray生成结果图片URL列表(完成时返回)
查询示例
curl "https://ai.ugooe.cn/api/image/query?task_id=task_xxxxxxxxxxxx"

建议: 前端以 3-5 秒为间隔轮询查询接口,最多等待 60 秒。生成完成后立即返回图片URL,请勿使用高频率请求。

⚠️ 错误处理

HTTP状态码说明处理方式
400参数错误检查请求参数是否正确
502上游服务错误重试请求,如持续失败请联系支持
504生成超时可重新提交任务
429请求过于频繁降低请求频率,等待后重试

❓ 常见问题

如何获取 API Key?
注册页面 注册账户后,系统会自动生成 API Key。你可以在 API控制台 查看和管理你的 Key。注册即赠送每日免费调用额度。
支持哪些图片尺寸?
支持以下尺寸:1024×1024 (1:1)、1216×832 (3:2)、832×1216 (2:3)、1408×768 (16:9)。不传参默认 1024×1024。
生成一张图片需要多长时间?
通常在 5-15 秒内完成。高峰期可能延长至 30 秒。建议前端使用异步轮询模式,不要阻塞等待。
支持图生图(以图绘图)吗?
当前 GPT Image 2 主要支持文生图。图生图功能正在集成中,你可以通过组合调用文生图 + 图片编辑来实现类似效果。将参考图的描述作为 prompt 的一部分传入。
有使用次数限制吗?
注册用户每日有 20 次免费调用。如需更多额度,可在 充值页面 购买额度。平台Key调用有总次数限制。
生成的图片有版权吗?
所有使用你的 API Key 生成的图片版权归你所有,可自由用于商业和非商业用途。平台不会保存你的生成记录。