OpenAPI 参考

Modelink API · 图像

Modelink 图像生成 API，提供基于 OpenAI 格式的同步生成与基于 Fal 格式的异步任务能力。Fal 格式接口使用 Authorization: Key {api_key}；其他接口使用 Bearer 鉴权。

版本 1.0.0

文生图

POST

/v1/images/generations

常用 size ：

1024x1024 (square)
1536x1024 (landscape)
1024x1536 (portrait)
2048x2048 (2K square)
2048x1152 (2K landscape)
3840x2160 (4K landscape)
2160x3840 (4K portrait)
auto (default)

也支持自定义 size：

最大边长必须小于或等于 3840px 两条边都必须是以下数字的倍数 16px 长边与短边之比不得超过 3:1 总像素数必须至少为 655,360，且不得超过 8,294,400

quality 支持

low
medium
high
auto (default)

prompt 长度限制

32000 characters ≈

英文：~5K–8K words
中文：~2万字左右

认证方式

BearerAuthBEARER

在 Authorization 请求头中传入 API Key 或访问令牌，格式：Bearer {token}。

Bearer 格式：JWT

请求体

请求体属性

modelstring, 必填
模型名称。GPT Image 2 使用 openai/gpt-image-2。
promptstring, 必填
图片生成提示词，必填，最长 32000 个字符。
- low
- medium
- high
- auto
sizestring
常用 size ： 1024x1024 (square) 1536x1024 (landscape) 1024x1536 (portrait) 2048x2048 (2K square) 2048x1152 (2K landscape) 3840x2160 (4K landscape) 2160x3840 (4K portrait) auto (default)

请求

POST/v1/images/generations

curl https://api.qnaigc.com/v1/images/generations \
  --request POST \
  --header 'Authorization: Bearer YOUR_BEARER_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "openai/gpt-image-2",
  "prompt": "可爱的少女，动漫",
  "quality": "high"
}'

响应

object

响应.

响应体属性

createdinteger, 必填
Unix 时间戳（秒）
- b64_jsonstring, 必填
  图片的 base64 数据（当前实现固定返回该字段）
backgroundstring
可选，背景类型
- png
- jpeg
- webp
sizestring
可选，图像尺寸
qualitystring
可选，图像质量
- total_tokensinteger
  可选。
- input_tokensinteger
  可选。
- output_tokensinteger
  可选。
- ti_quantityinteger
  可选。
- ii_quantityinteger
  可选。
- mi2i_quantityinteger
  可选。
- req_countinteger
  可选。
- - text_tokensinteger
    可选。
  - image_tokensinteger
    可选。
- - image_tokensinteger
    可选。
  - reasoning_tokensinteger
    可选。
  - text_tokensinteger
    可选。

响应

{
  "created": 42,
  "data": [
    {
      "b64_json": "string"
    }
  ],
  "background": "string",
  "output_format": "png",
  "size": "string",
  "quality": "string",
  "usage": {
    "total_tokens": 42,
    "input_tokens": 42,
    "output_tokens": 42,
    "ti_quantity": 42,
    "ii_quantity": 42,
    "mi2i_quantity": 42,
    "req_count": 42,
    "input_tokens_details": {
      "text_tokens": 42,
      "image_tokens": 42
    }
  }
}

图生图