返回首页 TOP API DOCS 开 发 文 档
文档 / 图片生成
TOP API DOCUMENTATION

图片生成

OpenAI Images 兼容接口,异步文生图。请求体必须固定带 "async": true,提交后立即返回任务号。

OpenAI ImagesAsync
请求方式
POST https://top-api.cc/draw/v1/images/generations
鉴权头
Authorization: Bearer sk-xxxxx
Content-Type
application/json
注意:这里使用 Top API 的图片生成地址 https://top-api.cc/draw/v1/images/generations。请不要填写第三方域名;请求体中的 async 固定为 true

用 AI Agent 傻瓜式生图

如果你有 AI Agent,可以把下面的提示词完整复制给它,让它直接调用中转 Images API 生图。

使用前请把 <密钥> 替换为你的 API Key,并将最后的“生图提示词”改成你想生成的画面描述。
我要通过中转 Images API 文生图,不要用内置 image_gen,也不要用会默认读取 b64_json 的 helper

中转信息:
- Endpoint: https://top-api.cc/v1/images/generations
- Model: gpt-image-2
- Auth: Bearer <密钥>
- response_format: url
- output_format: png(图片格式)
- n: 1
- size: 1:1(尺寸)
- imageSize: 1K(分辨率)
- quality: high(图片质量)

要求:
1. 直接用 HTTP POST 调 /v1/images/generations。
2. 如果报 Upstream temporarily unavailable / forbidden / no compatible accounts,先重试一次
3. 不要传 stream、partial_images、style;gpt-image-2 不要传 background=transparent

请生成:生图提示词

请求示例

curl -sS -X POST "https://top-api.cc/draw/v1/images/generations" \
  -H "Authorization: Bearer sk-xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴着太空头盔的橘猫,电影级光影",
    "n": 1,
    "size": "1:1",
    "imageSize": "1K",
    "async": true
  }'

参数

字段必填说明
model图片生成模型名
prompt提示词
async固定 true,立即返回任务号
n生成数量,缺省 1
size比例 1:116:99:164:3,或像素串 1024x1024
imageSize1K2K4K,nano-banana / gpt-image vip 模型可用
image参考图,data URL 数组,例如 data:image/png;base64,...
配置或调用过程中遇到问题,可以加客服微信 gtsj-001,我们可以帮你检查 API Key、请求地址、模型名和参数。
需要帮助?客服微信 gtsj-001 · 文档首页