OpenAPI 参考

Modelink API · 图像

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

版本 1.0.0

创建图像生成任务

POST

/queue/fal-ai/kling-image/o1

创建可灵 OmniImage 图像生成任务。支持文本提示词、参考图片的多模态输入方式。任务为异步执行，创建成功后返回任务 ID，需通过查询接口获取生成结果。

认证方式

FalApiKeyAuthAPI 密钥

Fal 格式接口鉴权方式：Authorization: Key {api_key}。

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

查询参数

Name
fal_webhook
Type
string<uri>
Description
可选。任务状态变化时接收 FAL 格式回调的 HTTPS 地址。详见 FAL 格式 Webhook。

请求体

请求体属性

promptstring, 必填
文本提示词，使用 <<<image_1>>> 引用参考图，最大 2500 字符
image_urlsstring<uri>[]
参考图 URL 列表，在 prompt 中用 <<<image_1>>> 引用（1-indexed），最多 10 张
- 1K
- 2K
- 1k
- 2k
num_imagesinteger
生成数量 1-9，默认 1
minimum: 1; maximum: 9
- auto
- 16:9
- 9:16
- 1:1
- 4:3
- 3:4
- 3:2
- 2:3
- 21:9

请求

POST/queue/fal-ai/kling-image/o1

curl 'https://api.qnaigc.com/queue/fal-ai/kling-image/o1?fal_webhook={fal_webhook}' \
  --request POST \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "一只可爱的橘猫在阳光下打盹",
  "num_images": 2,
  "resolution": "2K",
  "aspect_ratio": "16:9"
}'

响应

object

服务器内部错误

响应体属性

statusstring, 必填
必填。
request_idstring, 必填
必填。
response_urlstring, 必填
必填。
status_urlstring, 必填
必填。
cancel_urlstring, 必填
必填。

响应

{
  "status": "IN_QUEUE",
  "request_id": "qimage-root-1770199726278452760",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/kling-image/requests/qimage-root-1770199726278452760",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/kling-image/requests/qimage-root-1770199726278452760/status",
  "cancel_url": ""
}

查询图像生成任务

GET

/queue/fal-ai/kling-image/requests/{task_id}/status

根据任务 ID 查询图像生成任务的状态和结果。任务完成后，返回生成的图像 URL 列表。

认证方式

FalApiKeyAuthAPI 密钥

Fal 格式接口鉴权方式：Authorization: Key {api_key}。

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
task_id
Type
string, 必填
Description
任务 ID，由创建任务接口返回

请求体

暂无请求体

请求

GET/queue/fal-ai/kling-image/requests/{task_id}/status

curl https://api.qnaigc.com/queue/fal-ai/kling-image/requests/{task_id}/status \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object

服务器内部错误

响应体属性

statusstring, 必填
必填。
request_idstring, 必填
必填。
response_urlstring, 必填
必填。
status_urlstring, 必填
必填。
cancel_urlstring, 必填
必填。
- inference_timeinteger, 必填
  必填。
- - urlstring, 必填
    必填。
  - content_typestring, 必填
    必填。

响应

{
  "status": "COMPLETED",
  "request_id": "qimage-root-1770199726278452760",
  "response_url": "https://api.qnaigc.com/queue/fal-ai/kling-image/requests/qimage-root-1770199726278452760",
  "status_url": "https://api.qnaigc.com/queue/fal-ai/kling-image/requests/qimage-root-1770199726278452760/status",
  "cancel_url": "",
  "metrics": {
    "inference_time": 38
  },
  "result": {
    "images": [
      {
        "url": "https://aitoken-video.qnaigc.com/images/root/qimage-root-1770199726278452760/0.png?e=1770804564&token=IDB69r4gicDbMd9Fbmn9w2bWuEENg9i5_yasXqhp:QucLpFz96OaAUNr5PT0jMWGg6uw=",
        "content_type": "image/png"
      },
      {
        "url": "https://aitoken-video.qnaigc.com/images/root/qimage-root-1770199726278452760/1.png?e=1770804564&token=IDB69r4gicDbMd9Fbmn9w2bWuEENg9i5_yasXqhp:zP_T_jPES3OZAHZ0qkbe9MhK6sc=",
        "content_type": "image/png"
      }
    ]
  }
}

获取结果

GET

/queue/fal-ai/kling-image/requests/{task_id}

根据任务 ID 查询图像生成任务的状态和结果。任务完成后，返回生成的图像 URL 列表。

认证方式

FalApiKeyAuthAPI 密钥

Fal 格式接口鉴权方式：Authorization: Key {api_key}。

header 参数：Authorization

BearerAuthBEARER

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

Bearer 格式：JWT

路径参数

Name
task_id
Type
string, 必填
Description
任务 ID，由创建任务接口返回

请求体

暂无请求体

请求

GET/queue/fal-ai/kling-image/requests/{task_id}

curl https://api.qnaigc.com/queue/fal-ai/kling-image/requests/{task_id} \
  --header 'Authorization: YOUR_FAL_API_KEY_AUTH' \
  --header 'Accept: application/json'

响应

object

服务器内部错误

响应体属性

- urlstring, 必填
  必填。
- content_typestring, 必填
  必填。

响应

{
  "images": [
    {
      "url": "https://aitoken-video.qnaigc.com/images/root/qimage-root-1770105770654149000/0.png?e=1770710614&token=IDB69r4gicDbMd9Fbmn9w2bWuEENg9i5_yasXqhp:juaQpRC__BdIP-h8EDNgPmkk99M=",
      "content_type": "image/png"
    },
    {
      "url": "https://aitoken-video.qnaigc.com/images/root/qimage-root-1770105770654149000/1.png?e=1770710614&token=IDB69r4gicDbMd9Fbmn9w2bWuEENg9i5_yasXqhp:uB_mVes2XTcNByHqTdXPm1VGq5A=",
      "content_type": "image/png"
    }
  ]
}