# gpt-image-2/gpt-image-2.5接口 ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/api/generate: post: summary: gpt-image-2/gpt-image-2.5接口 deprecated: false description: |- 基础节点： https://grsaiapi.com (全球节点) https://grsai.dakka.com.cn (国内节点) 例子： https://grsaiapi.com/v1/api/generate https://grsai.dakka.com.cn/v1/api/generate tags: - Grsai图片/视频生成接口 parameters: - name: base_url in: path description: '' required: true schema: type: string - name: Authorization in: header description: 请前往以下页面获取APIKEY：https://grsai.ai/zh/dashboard/api-keys required: false example: Bearer sk-xxxxxxxxxxx schema: type: string requestBody: content: application/json: schema: type: object properties: model: type: string title: 模型名称 description: |- 支持以下模型 gpt-image-2 gpt-image-2-vip gpt-image-2.5 gpt-image-2.5-flare gpt-image-2.5-sunburst prompt: type: string title: 提示词 images: type: array items: type: string title: 参考图 description: 支持base64与url链接 aspectRatio: type: string title: 比例 description: |- 分辨率参数说明 gpt-image-2/gpt-image-2.5：支持比例（如 "16:9"）或1K像素值（如 "1024x1024"） gpt-image-2-vip/gpt-image-2.5-flare/gpt-image-2.5-sunburst：支持1-4K像素值（如 "1024x1024"、"2048x2048"），不支持比例 自定义像素值约束（仅限 vip 模型） 最大边长必须小于或等于3840px 两条边都必须是16的倍数 长边与短边之比不得超过 3:1 总像素数必须至少为 655,360且不得超过 8,294,400 gpt-image-2-vip/gpt-image-2.5-flare/gpt-image-2.5-sunburst比例参考（1K、2K、4K）： auto 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 gpt-image-2比例参考： auto 1:1：1024x1024 16:9：1672 x941 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 replyType: type: string title: 回复类型 description: |- 支持参数 json（返回json） stream（返回stream） async（异步轮询） 异步生成结果查询接口：https://qmy27nhsd9.apifox.cn/452409577e0 quality: type: string title: 质量 description: |- 支持以下质量选项: "auto" "low" "medium" "high" "xhigh" "max" (请根据模型支持情况进行选择) gpt-image-2: auto gpt-image-2.5: auto gpt-image-2-vip: medium gpt-image-2.5-flare: low、medium、high gpt-image-2.5-sunburst: low、medium、high、xhigh、max background: type: string title: 背景参数 description: |- 可选参数：transparent 以下模型支持该参数： gpt-image-2-vip gpt-image-2.5-flare gpt-image-2.5-sunburst mask: type: string title: mask description: https://xxxx.png required: - model - prompt x-apifox-orders: - model - prompt - images - aspectRatio - quality - background - mask - replyType example: model: gpt-image-2 prompt: 生成一张边牧与古牧正在抖音直播间直播带货截图 images: [] aspectRatio: 1024x1024 quality: auto replyType: json responses: '200': description: '' content: application/json: schema: type: object properties: id: type: string title: 任务id status: type: string title: 状态 description: | 任务状态 running (进行中) violation (违规) succeeded (生成成功) failed (任务失败) results: type: array items: type: object properties: url: type: string title: 图片/视频链接 x-apifox-orders: - url progress: type: integer title: 进度 description: 0~100 error: type: string title: 报错信息 required: - id - status x-apifox-orders: - id - status - progress - results - error example: id: 14-5f3cf761-a4bb-486a-8016-77f490998f80 status: succeeded results: - url: >- https://file1.aitohumanize.com/file/fcdd2d07449d438d9d69d450f5626976.png headers: {} x-apifox-name: 成功 '400': description: '' content: application/json: schema: type: object properties: id: type: string status: type: string title: 状态 description: |- 状态 violation（违规） failed（失败） error: type: string title: 报错信息 required: - id - status - error x-apifox-orders: - id - status - error example: id: 12-1f771fbf-f23a-4b89-a7d0-a98ba9862edb status: failed error: generate failed headers: {} x-apifox-name: 报错 x-200:异步生成返回结果: description: '' content: application/json: schema: type: object properties: id: type: string title: 任务id description: |- 通过该id调用异步结果查询接口 接口文档：https://qmy27nhsd9.apifox.cn/452409577e0 status: type: string title: 状态 01KQS7HP0FA36FTFVEPEF2D10R: type: string required: - id - status x-apifox-orders: - id - status - 01KQS7HP0FA36FTFVEPEF2D10R example: id: 6-f671fc51-d5d7-4eff-a1c7-26e612fe08ab status: running headers: {} x-apifox-name: 异步生成返回结果 security: [] x-apifox-folder: Grsai图片/视频生成接口 x-apifox-status: released x-run-in-apifox: https://app.apifox.com/web/project/8212034/apis/api-452409160-run components: schemas: {} securitySchemes: {} servers: [] security: [] ```