POST/v1/images/generations

文生图

该接口兼容 OpenAI 风格图片生成请求，平台在服务层补充上游路由、计费与结果映射。

基础信息

鉴权	Authorization: Bearer sk-...
请求类型	application/json
响应类型	application/json

请求参数

Body

字段

类型

必填

位置

说明

model

string

是

body

图片生成模型。

示例："gpt-image-1"

prompt

string

是

body

生成提示词。

示例："一张展示开发者门户首页的等距插画"

size

string

否

body

输出尺寸。

示例："1024x1024"

quality

string

否

body

质量配置。

示例："high"

response_format

string

否

body

返回值格式。

示例："url"

n

integer

否

body

图片数量。

示例：1

请求示例

json

{
  "model": "gpt-image-1",
  "prompt": "一张展示开发者门户首页的等距插画",
  "size": "1024x1024",
  "quality": "high",
  "response_format": "url",
  "n": 1
}

响应示例

json

{
  "created": 1744512000,
  "data": [
    {
      "url": "https://cdn.example.com/generated/portal-home.png"
    }
  ]
}

错误码

HTTP	code	说明
400	`invalid_request_error`	请求体结构不合法、缺少必填参数，或 JSON 无法解析。
401	`invalid_auth_header`	缺少或传错鉴权头，网关无法识别当前调用身份。
403	`model_not_allowed`	当前 API Key 没有访问该模型的权限。
402	`insufficient_balance`	余额不足，平台在调用前预检时已拒绝请求。
503	`model_not_available`	当前模型没有可用路由或上游渠道不可用。

在线调试

Playground · 浏览器直连网关

文生图

统一图片生成接口，支持 URL 或 `b64_json` 格式返回。

Base URL Token / API Key

JSON 请求体

json

尚未发起请求。

bash

curl --location --request POST 'https://api.harnmodel.com/v1/images/generations' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data '{}'

多语言示例

bash

curl --location --request POST 'https://api.harnmodel.com/v1/images/generations' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-1",
    "prompt": "一张展示开发者门户首页的等距插画",
    "size": "1024x1024",
    "quality": "high",
    "response_format": "url",
    "n": 1
  }'