IMA2 API 接口文档 Base URL: <a href="https://api.fuyewang.top" rel="nofollow">https://api.fuyewang.top</a> 鉴权方式： 图片生成相关接口请求头： Content-Type: application/json Authorization: Bearer sk-xxxxxxxxxxxx 当前开放接口： 1. POST /v1/api/generate 2. GET /v1/api/result?id=任务ID 3. POST /v1/images/generations 4. POST /client/openapi/getAPIKeyCredits API 自助诊断： 如果 API 调用失败、没有返回任务ID、请求超时、工作流报错，优先使用 API 自助诊断页面查询原因。 诊断页面： 【https://fuyewang.top/archives/15934】 使用方式： 1. 打开 API 自助诊断页面。 2. 输入完整 APIKEY。 3. 选择最近 1 小时、今天、最近 24 小时或最近 7 天。 4. 点击查询，即可查看近期 API 调用记录和诊断建议。 诊断页面可以帮助判断： – 请求是否到达本站 API – 是否请求体过大 – 是否客户端提前断开 – 是否生成服务异常 – 是否正常返回 – 请求耗时是否接近超时 – 查询结果接口是否正常返回 隐私说明： 诊断系统不会展示或保存完整 APIKEY，不保存 prompt，不保存 base64，不保存图片内容。日志仅使用 APIKEY 的“前六位 + 后八位”作为识别码进行匹配。 注意： 自助诊断主要匹配使用 Authorization 请求头的调用记录。建议所有图片生成、任务查询、同步生成请求都按文档携带： Authorization: Bearer sk-xxxxxxxxxxxx 如果使用 APIKey 积分余额查询接口，也建议额外携带 Authorization 请求头，方便诊断页面匹配记录；业务查询参数仍以 Body 中的 apiKey 为准。 重要字段区别： /v1/api/generate 使用 images 和 aspectRatio。 /v1/images/generations 使用 image 和 size。 一、支持模型 1. gpt-image-2 系列 支持模型： – gpt-image-2 – gpt-image-2-vip gpt-image-2：支持比例或 1K 像素值，例如 16:9、1:1、1024×1024。 gpt-image-2 普通版推荐尺寸：1:1=1024×1024，16:9=1672×941，9:16=941×1672，4:3=1443×1090，3:4=1090×1443，3:2=1536×1024，2:3=1024×1536，5:4=1408×1120，4:5=1120×1408，21:9=1920×832，9:21=832×1920，1:2=896×1792，2:1=1792×896。 gpt-image-2-vip：支持 1K-4K 像素值，例如 1024×1024、2048×2048、3840×2160。不建议填写比例，应填写具体像素。限制：最大边长 <=3840px；宽高都必须是16的倍数；长短边比不得超过3:1；总像素数至少655360，最多8294400。 gpt-image-2-vip 常用尺寸： 1:1 = 1024x1024 / 2048x2048 / 2880x2880 16:9 = 1280x720 / 2048x1152 / 3840x2160 9:16 = 720x1280 / 1152x2048 / 2160x3840 4:3 = 1152x864 / 2304x1728 / 3264x2448 3:4 = 864x1152 / 1728x2304 / 2448x3264 3:2 = 1536x1024 / 2048x1360 / 3504x2336 2:3 = 1024x1536 / 1360x2048 / 2336x3504 5:4 = 1120x896 / 2240x1792 / 3200x2560 4:5 = 896x1120 / 1792x2240 / 2560x3200 21:9 = 1456x624 / 2912x1248 / 3840x1648 2. nano-banana 系列支持模型：nano-banana、nano-banana-fast、nano-banana-2、nano-banana-2-cl、nano-banana-2-4k-cl、nano-banana-pro、nano-banana-pro-cl、nano-banana-pro-vip、nano-banana-pro-4k-vip。通用比例：auto、1:1、16:9、9:16、4:3、3:4、3:2、2:3、5:4、4:5、21:9。 nano-banana-2 系列额外比例：1:4、4:1、1:8、8:1。 imageSize：1K、2K、4K。 replyType：json、stream、async。二、异步图片生成接口 POST <a href="https://api.fuyewang.top/v1/api/generate" rel="nofollow">https://api.fuyewang.top/v1/api/generate</a> Headers: Content-Type: application/json Authorization: Bearer sk-xxxxxxxxxxxx Body 示例： { "model": "gpt-image-2", "prompt": "生成一张简单的白色小猫头像，纯色背景", "images": [], "aspectRatio": "1024x1024", "replyType": "async" } 返回示例：{"id":"6-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","status":"running"} 三、异步结果查询接口 GET <a href="https://api.fuyewang.top/v1/api/result?id=任务ID" rel="nofollow">https://api.fuyewang.top/v1/api/result?id=任务ID</a> Headers: Authorization: Bearer sk-xxxxxxxxxxxx 状态：running=生成中，succeeded=成功，failed=失败，violation=违规。四、同步图片生成接口说明：该接口会等待生成完成后直接返回结果，仅建议低频测试或特殊第三方工具兼容场景使用。正式接入、批量生成、多图参考、高分辨率生成时，强烈建议使用异步生成接口 /v1/api/generate，并设置 replyType=async。 POST <a href="https://api.fuyewang.top/v1/images/generations" rel="nofollow">https://api.fuyewang.top/v1/images/generations</a> Headers: Content-Type: application/json Authorization: Bearer sk-xxxxxxxxxxxx Body 示例： { "model": "gpt-image-2", "prompt": "生成一张简单的白色小猫头像，纯色背景", "image": [], "size": "1024x1024", "response_format": "url" } 注意：该接口参考图字段是 image，不是 images；尺寸字段是 size，不是 aspectRatio。五、APIKey 积分余额查询接口 POST <a href="https://api.fuyewang.top/client/openapi/getAPIKeyCredits" rel="nofollow">https://api.fuyewang.top/client/openapi/getAPIKeyCredits</a> Headers: Content-Type: application/json Authorization: Bearer sk-xxxxxxxxxxxx Body: {"apiKey":"sk-xxxxxxxxxxxx"} 说明： Authorization 请求头用于自助诊断记录匹配；实际积分查询参数仍以 Body 中的 apiKey 为准。六、图片上传建议参考图支持图片 URL 或 base64。小图、单图、偶尔图生图可以使用 base64。大图、多图、频繁图生图建议使用图片 URL。单张图片平均大于 3MB 时，强烈建议使用图片 URL。当前请求体大小限制为 30MB。base64 编码后的体积通常会比原始图片更大。如果大量使用图生图功能且图片质量平均大于 3MB 以上，为保证生成成功率和稳定性，强烈建议自行配置七牛云对象存储。七牛云对象存储每个月有 10GB 标准存储免费额度，具体配置方法请参考：https://fuyewang.top/archives/15852

IMA2 API 接口文档

本文档适用于图片生成、异步任务查询、同步图片生成以及 APIKey 积分余额查询。强烈建议优先使用异步生成，尤其适合多图参考、高分辨率生成和高频调用场景。所有示例均可直接复制给 AI、代码助手或开发工具参考。

一、基础信息

1. Base URL

所有接口请求均基于以下地址：

Base URL

https://api.fuyewang.top

2. 鉴权方式

图片生成相关接口需要在请求头中携带 APIKey：

Headers

Content-Type: application/json
Authorization: Bearer sk-xxxxxxxxxxxx

请勿把真实 APIKey 公开发布到文章、截图或交流群中。文档示例中的 sk-xxxxxxxxxxxx 需要替换为你自己的 APIKey。

强烈建议使用异步生成接口，不建议使用同步生成接口！

3. 当前开放接口

接口用途	请求方式	接口路径
异步图片生成接口（推荐）	POST	`/v1/api/generate`
异步任务结果查询接口	GET	`/v1/api/result`
同步图片生成接口（不推荐）	POST	`/v1/images/generations`
APIKey 积分余额查询接口	POST	`/client/openapi/getAPIKeyCredits`

4. API 自助诊断

如果 API 调用失败、没有返回任务ID、请求超时、工作流报错，可使用 API 自助诊断页面查询近期调用记录和诊断建议。

项目	说明
诊断入口	打开 API 自助诊断页面
查询方式	输入完整 APIKEY，选择时间范围后查询近期 API 调用记录。
可诊断内容	请求是否到达本站 API、是否请求体过大、是否客户端提前断开、是否生成服务异常、是否正常返回、请求耗时是否接近超时。
隐私说明	诊断系统不会展示或保存完整 APIKEY，不保存 prompt，不保存 base64，不保存图片内容，仅使用 APIKEY 的“前六位 + 后八位”识别码进行匹配。

为了让自助诊断页面能匹配到调用记录，请在图片生成、任务查询、同步生成等接口中按文档携带 Authorization: Bearer sk-xxxxxxxxxxxx 请求头。

二、重要字段区别

这是最容易写错的地方。不同接口的参考图字段和尺寸字段不一样。

接口	参考图字段	尺寸字段	说明
`/v1/api/generate`	`images`	`aspectRatio`	异步图片生成接口，支持 `json`、`stream`、`async`
`/v1/images/generations`	`image`	`size`	同步图片生成接口

/v1/api/generate

字段示例

{
  "images": [],
  "aspectRatio": "1024x1024"
}

/v1/images/generations

字段示例

{
  "image": [],
  "size": "1024x1024"
}

三、支持模型与尺寸规则

1. gpt-image-2 系列

模型名称	说明	尺寸填写方式
`gpt-image-2`	普通版图片生成模型	支持比例或 1K 像素值，例如 `16:9`、`1:1`、`1024x1024`
`gpt-image-2-vip`	VIP 图片生成模型，支持更高分辨率	支持 1K–4K 像素值，例如 `1024x1024`、`2048x2048`、`3840x2160`；不建议直接填写比例

2. gpt-image-2 普通版尺寸参考

比例	推荐尺寸
`1:1`	`1024x1024`
`16:9`	`1672x941`
`9:16`	`941x1672`
`4:3`	`1443x1090`
`3:4`	`1090x1443`
`3:2`	`1536x1024`
`2:3`	`1024x1536`
`5:4`	`1408x1120`
`4:5`	`1120x1408`
`21:9`	`1920x832`
`9:21`	`832x1920`
`1:2`	`896x1792`
`2:1`	`1792x896`

3. gpt-image-2-vip 自定义尺寸限制

使用 gpt-image-2-vip 时，建议填写具体像素尺寸，不要填写 16:9、1:1 这类比例。

限制项	要求
最大边长	小于或等于 `3840px`
边长倍数	宽和高都必须是 `16` 的倍数
长短边比例	长边与短边之比不得超过 `3:1`
总像素数	至少 `655360`，不超过 `8294400`

4. gpt-image-2-vip 常用尺寸参考

比例	1K	2K	4K
`1:1`	`1024x1024`	`2048x2048`	`2880x2880`
`16:9`	`1280x720`	`2048x1152`	`3840x2160`
`9:16`	`720x1280`	`1152x2048`	`2160x3840`
`4:3`	`1152x864`	`2304x1728`	`3264x2448`
`3:4`	`864x1152`	`1728x2304`	`2448x3264`
`3:2`	`1536x1024`	`2048x1360`	`3504x2336`
`2:3`	`1024x1536`	`1360x2048`	`2336x3504`
`5:4`	`1120x896`	`2240x1792`	`3200x2560`
`4:5`	`896x1120`	`1792x2240`	`2560x3200`
`21:9`	`1456x624`	`2912x1248`	`3840x1648`
`9:21`	`624x1456`	`1248x2912`	`1648x3840`
`1:3`	`688x2048`	–	`1280x3840`
`3:1`	`2048x688`	–	`3840x1280`
`2:1`	`1536x768`	`3072x1536`	`3840x1920`
`1:2`	`768x1536`	`1536x3072`	`1920x3840`

5. nano-banana 系列

支持模型	说明
`nano-banana`	基础模型
`nano-banana-fast`	快速模型
`nano-banana-2`	二代模型
`nano-banana-2-cl`	二代 CL 版本
`nano-banana-2-4k-cl`	二代 4K CL 版本
`nano-banana-pro`	Pro 模型
`nano-banana-pro-cl`	Pro CL 版本
`nano-banana-pro-vip`	Pro VIP 版本
`nano-banana-pro-4k-vip`	Pro 4K VIP 版本

6. nano-banana 比例、分辨率与返回方式

项目	支持值
通用比例	`auto`、`1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`3:2`、`2:3`、`5:4`、`4:5`、`21:9`
nano-banana-2 系列额外比例	`1:4`、`4:1`、`1:8`、`8:1`
`imageSize`	`1K`、`2K`、`4K`
`replyType`	`json`、`stream`、`async`

四、接口一：异步图片生成接口

该接口用于提交图片生成任务，支持文生图、图生图、多参考图、base64 图片和图片 URL。推荐使用 replyType: async，提交后先返回任务 ID，再通过结果查询接口获取最终图片。

1. 请求地址

Endpoint

POST https://api.fuyewang.top/v1/api/generate

2. 请求 Headers

Headers

Content-Type: application/json
Authorization: Bearer sk-xxxxxxxxxxxx

3. 请求参数

参数名	类型	必填	说明
`model`	string	是	模型名称，例如 `gpt-image-2`、`gpt-image-2-vip`、`nano-banana-2`
`prompt`	string	是	图片生成提示词
`images`	array	否	参考图数组，支持图片 URL 或 base64
`aspectRatio`	string	否	图片比例或尺寸，按模型规则填写
`imageSize`	string	否	分辨率，主要用于 nano-banana 系列，例如 `1K`、`2K`、`4K`
`replyType`	string	否	返回方式，支持 `json`、`stream`、`async`

4. 文生图请求示例：gpt-image-2

curl 示例

curl -X POST "https://api.fuyewang.top/v1/api/generate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "生成一张简单的白色小猫头像，纯色背景",
    "images": [],
    "aspectRatio": "1024x1024",
    "replyType": "async"
  }'

5. 图生图请求示例：使用图片 URL

curl 示例

curl -X POST "https://api.fuyewang.top/v1/api/generate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "请参考这张图片，生成一张风格相似但更精致的图片",
    "images": [
      "https://example.com/test.png"
    ],
    "aspectRatio": "1024x1024",
    "replyType": "async"
  }'

6. 图生图请求示例：使用 base64

JSON 示例

{
  "model": "gpt-image-2",
  "prompt": "请参考这张图片，生成一张风格相似但更精致的图片",
  "images": [
    "data:image/png;base64,这里填写base64内容"
  ],
  "aspectRatio": "1024x1024",
  "replyType": "async"
}

7. nano-banana 请求示例

curl 示例

curl -X POST "https://api.fuyewang.top/v1/api/generate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "生成一张边牧与古牧正在直播间带货的截图",
    "images": [],
    "aspectRatio": "1:1",
    "imageSize": "1K",
    "replyType": "async"
  }'

8. 异步提交成功返回示例

JSON 返回

{
  "id": "6-f671fc51-d5d7-4eff-a1c7-26e612fe08ab",
  "status": "running"
}

9. 直接返回成功示例

JSON 返回

{
  "id": "14-5f3cf761-a4bb-486a-8016-77f490998f80",
  "status": "succeeded",
  "progress": 100,
  "results": [
    {
      "url": "https://example.com/result.png"
    }
  ]
}

10. 失败返回示例

JSON 返回

{
  "id": "12-1f771fbf-f23a-4b89-a7d0-a98ba9862edb",
  "status": "failed",
  "error": "generate failed"
}

五、接口二：异步生成结果查询接口

该接口用于查询异步生成任务的状态和最终图片链接。

1. 请求地址

Endpoint

GET https://api.fuyewang.top/v1/api/result

2. 请求 Headers

Headers

Authorization: Bearer sk-xxxxxxxxxxxx

3. Query 参数

参数名	类型	必填	说明
`id`	string	是	异步生成接口返回的任务 ID

原始接口文档中 id 标记为非必填，但实际查询某个具体任务时必须传入任务 ID。

4. 请求示例

curl 示例

curl -X GET "https://api.fuyewang.top/v1/api/result?id=6-f671fc51-d5d7-4eff-a1c7-26e612fe08ab" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx"

5. 状态说明

status	说明
`running`	任务生成中
`succeeded`	任务生成成功
`failed`	任务生成失败
`violation`	内容违规

6. 生成中返回示例

JSON 返回

{
  "id": "6-f671fc51-d5d7-4eff-a1c7-26e612fe08ab",
  "status": "running",
  "progress": 2
}

7. 成功返回示例

JSON 返回

{
  "id": "14-5f3cf761-a4bb-486a-8016-77f490998f80",
  "status": "succeeded",
  "progress": 100,
  "results": [
    {
      "url": "https://example.com/result.png"
    }
  ]
}

8. 失败返回示例

JSON 返回

{
  "id": "12-1f771fbf-f23a-4b89-a7d0-a98ba9862edb",
  "status": "failed",
  "error": "generate failed"
}

六、接口三：同步图片生成接口

该接口为同步图片生成接口，字段使用 image 和 size，适合少量测试、低频调用或部分只支持同步图片生成的第三方工具。生产环境、批量生成、多图参考、高分辨率生成和高频调用场景，强烈建议优先使用异步生成接口。

强烈建议：正式接入请优先使用 /v1/api/generate 并设置 replyType: async，再通过 /v1/api/result 查询结果。同步生成需要等待最终图片返回，更容易受到网络中断、客户端超时、任务耗时波动等影响，不建议用于高频或批量生成。

1. 请求地址

Endpoint

POST https://api.fuyewang.top/v1/images/generations

如果某些第三方工具或客户端要求填写 Base URL，通常可填写：https://api.fuyewang.top/v1。如果工具要求填写完整接口地址，则填写：https://api.fuyewang.top/v1/images/generations。

2. 请求 Headers

Headers

Content-Type: application/json
Authorization: Bearer sk-xxxxxxxxxxxx

3. 请求参数

参数名	类型	必填	说明
`model`	string	是	模型名称，支持图片生成模型，例如 `gpt-image-2`
`prompt`	string	是	图片生成提示词
`image`	array	否	参考图数组，支持图片 URL 或 base64
`size`	string	否	图片比例或尺寸，规则参考具体模型
`response_format`	string	否	返回格式，推荐 `url`

该接口使用 image，不是 images；使用 size，不是 aspectRatio。

4. 请求示例：文生图

curl 示例

curl -X POST "https://api.fuyewang.top/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "生成一张简单的白色小猫头像，纯色背景",
    "image": [],
    "size": "1024x1024",
    "response_format": "url"
  }'

5. 请求示例：图生图

curl 示例

curl -X POST "https://api.fuyewang.top/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "请参考这张图片，生成一张风格相似但更精致的图片",
    "image": [
      "https://example.com/test.png"
    ],
    "size": "1024x1024",
    "response_format": "url"
  }'

6. 成功返回示例

JSON 返回

{
  "created": 1777689832,
  "data": [
    {
      "url": "https://example.com/image.png"
    }
  ],
  "usage": {
    "total_tokens": 6267,
    "input_tokens": 17,
    "output_tokens": 6250,
    "input_tokens_details": {}
  }
}

7. 失败返回示例

JSON 返回

{
  "error": {
    "message": "generation failed"
  }
}

七、接口四：APIKey 积分余额查询接口

该接口用于查询 APIKey 当前积分余额。

1. 请求地址

Endpoint

POST https://api.fuyewang.top/client/openapi/getAPIKeyCredits

2. 请求 Headers

Authorization请求头用于自助诊断记录匹配；实际积分查询参数仍以 Body 中的 apiKey 为准。

Headers

Content-Type: application/json
Authorization: Bearer sk-xxxxxxxxxxxx

3. 请求参数

参数名	类型	必填	说明
`apiKey`	string	是	需要查询余额的 APIKey

4. 请求示例

curl 示例

curl -X POST "https://api.fuyewang.top/client/openapi/getAPIKeyCredits" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -d '{
    "apiKey": "sk-xxxxxxxxxxxx"
  }'

5. 成功返回示例

JSON 返回

{
  "code": 0,
  "data": {
    "credits": 10000
  },
  "msg": "success"
}

实际返回中，data 可能包含更多字段：

JSON 返回

{
  "code": 0,
  "data": {
    "createTime": 1777283428,
    "credits": 608,
    "expireTime": 0,
    "type": 1
  },
  "msg": "success"
}

八、图片上传说明与大小限制

1. 支持的参考图方式

接口支持两种参考图传入方式：图片 URL 和 base64。

使用场景	建议方式
小图、单图、偶尔图生图	可以使用 base64
多图参考、高清图片、频繁图生图	推荐使用图片 URL
单张图片平均大于 3MB	强烈建议使用图片 URL
大量使用图生图功能	强烈建议配置对象存储
请求体超过 30MB	可能返回 `413 Request Entity Too Large`

2. 图片 URL 方式

/v1/api/generate 示例

{
  "images": [
    "https://example.com/test.png"
  ]
}

/v1/images/generations 示例

{
  "image": [
    "https://example.com/test.png"
  ]
}

图片 URL 必须是公网可访问地址。

3. base64 方式

base64 示例

{
  "images": [
    "data:image/png;base64,这里填写base64内容"
  ]
}

常见格式：

base64 MIME 示例

data:image/png;base64,xxxx
data:image/jpeg;base64,xxxx
data:image/webp;base64,xxxx

当前接口请求体大小限制为 30MB。base64 编码后的体积通常会比原始图片更大，且 base64 字符串中不要包含换行符。

4. 七牛云对象存储建议

如果大量使用图生图功能，且图片质量平均大于 3MB 以上，为保证生成成功率和稳定性，强烈建议自行配置七牛云对象存储。七牛云对象存储每个月有 10GB 标准存储免费额度，适合轻量图片存储和图生图参考图上传使用。具体配置方法请参考：七牛云对象存储配置手册。

5. 七牛云图片 URL 调用示例

JSON 示例

{
  "model": "gpt-image-2",
  "prompt": "请参考这张图片，生成一张风格相似但更精致的图片",
  "images": [
    "https://你的七牛云图片域名/test.png"
  ],
  "aspectRatio": "1024x1024",
  "replyType": "async"
}

九、常见错误说明

0. 先使用 API 自助诊断

如果你不确定问题出在接口、工作流、请求体大小、超时还是生成服务，请先打开
API 自助诊断页面，
输入完整 APIKEY 查询近期调用记录。诊断页面会给出“请求体过大、客户端提前断开、生成服务异常、正常返回”等判断结果。

1. 认证失败

可能原因包括 APIKey 错误、Authorization 格式错误、APIKey 余额不足或 APIKey 不可用。

正确格式

Authorization: Bearer sk-xxxxxxxxxxxx

2. 请求体过大

错误示例

413 Request Entity Too Large

可以尝试压缩图片、减少参考图数量，或改用图片 URL。

3. 生成失败

失败示例

{
  "status": "failed",
  "error": "generate failed"
}

4. 内容违规

违规示例

{
  "status": "violation",
  "error": "policy violation"
}

5. 任务一直 running

如果查询结果长时间为 running，可以稍后继续查询，检查任务 ID 是否正确，并确认 APIKey 是否与提交任务时一致。

十、推荐调用流程

方案 A：推荐异步调用

异步流程

1. 调用 POST /v1/api/generate
2. replyType 填 async
3. 接口返回 id
4. 调用 GET /v1/api/result?id=任务ID
5. 轮询直到 status 为 succeeded / failed / violation
6. succeeded 时读取 results[0].url

方案 B：同步生成调用（不推荐作为主流程）

同步生成流程

1. 使用 POST /v1/images/generations
2. 字段使用 image，不是 images
3. 字段使用 size，不是 aspectRatio
4. 等待接口直接返回 data[0].url
5. 该方式为同步等待，低频测试可用；正式接入建议改用异步生成

十一、最小可用示例

1. gpt-image-2 异步文生图

curl 示例

curl -X POST "https://api.fuyewang.top/v1/api/generate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "生成一张简单的白色小猫头像，纯色背景",
    "images": [],
    "aspectRatio": "1024x1024",
    "replyType": "async"
  }'

2. 查询异步结果

curl 示例

curl -X GET "https://api.fuyewang.top/v1/api/result?id=你的任务ID" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx"

3. 同步文生图

curl 示例

curl -X POST "https://api.fuyewang.top/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "生成一张简单的白色小猫头像，纯色背景",
    "image": [],
    "size": "1024x1024",
    "response_format": "url"
  }'

4. 查询积分余额

curl 示例

curl -X POST "https://api.fuyewang.top/client/openapi/getAPIKeyCredits" \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "sk-xxxxxxxxxxxx"
  }'

文章版权归作者所有，未经允许请勿转载。

THE END

日记

API调用文档

IMA2 API 接口文档

一、基础信息

1. Base URL

2. 鉴权方式

3. 当前开放接口

4. API 自助诊断

二、重要字段区别

三、支持模型与尺寸规则

1. gpt-image-2 系列

2. gpt-image-2 普通版尺寸参考

3. gpt-image-2-vip 自定义尺寸限制

4. gpt-image-2-vip 常用尺寸参考

5. nano-banana 系列

6. nano-banana 比例、分辨率与返回方式

四、接口一：异步图片生成接口

1. 请求地址

2. 请求 Headers

3. 请求参数

4. 文生图请求示例：gpt-image-2

5. 图生图请求示例：使用图片 URL

6. 图生图请求示例：使用 base64

7. nano-banana 请求示例

8. 异步提交成功返回示例

9. 直接返回成功示例

10. 失败返回示例

五、接口二：异步生成结果查询接口

1. 请求地址

2. 请求 Headers

3. Query 参数

4. 请求示例

5. 状态说明

6. 生成中返回示例

7. 成功返回示例

8. 失败返回示例

六、接口三：同步图片生成接口

1. 请求地址

2. 请求 Headers

3. 请求参数

4. 请求示例：文生图

5. 请求示例：图生图

6. 成功返回示例

7. 失败返回示例

七、接口四：APIKey 积分余额查询接口

1. 请求地址

2. 请求 Headers

3. 请求参数

4. 请求示例

5. 成功返回示例

八、图片上传说明与大小限制

1. 支持的参考图方式

2. 图片 URL 方式

3. base64 方式

4. 七牛云对象存储建议

5. 七牛云图片 URL 调用示例

九、常见错误说明

0. 先使用 API 自助诊断

1. 认证失败

2. 请求体过大

3. 生成失败

4. 内容违规

5. 任务一直 running

十、推荐调用流程

方案 A：推荐异步调用

方案 B：同步生成调用（不推荐作为主流程）

十一、最小可用示例

1. gpt-image-2 异步文生图

2. 查询异步结果

3. 同步文生图

4. 查询积分余额

请登录后发表评论