官方文档: https://fal.ai/models/fal-ai/flux-1/dev
POST
/fal-ai/flux-1/dev/fal-ai/flux-1/dev
API Key application/json
请求示例
curl -X POST https://top.qingyuntop.ai/fal-ai/flux-1/dev \
-H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
"image_size": "landscape_4_3",
"num_inference_steps": 28,
"guidance_scale": 3.5,
"num_images": 1,
"enable_safety_checker": true,
"output_format": "jpeg",
"acceleration": "regular"
}'请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
prompt | JSON body | string | 是 | - | - |
image_size | JSON body | string | 否 | 生成图像的大小。默认值:landscape_4_3 范围(3:4、4:3、16:9、9:16) | - |
num_inference_steps | JSON body | integer | 否 | 要执行的推理步骤数。默认值:28 .范围值:0-50 | - |
guidance_scale | JSON body | number | 否 | CFG(无分类器引导)量表衡量了您希望模型在寻找相关图像时与提示的贴近程度。默认值:3.5 .范围值:1-20 | - |
num_images | JSON body | integer | 否 | 生成的图像数量。默认值:1 范围值:1-4 | - |
enable_safety_checker | JSON body | boolean | 否 | 如果设置为 true,则启用安全检查器。默认值:true | - |
output_format | JSON body | string | 否 | 生成图片的格式。默认值:"jpeg" .支持的格式default、JPEG、png | - |
acceleration | JSON body | string | 否 | 生成速度。速度越高,生成速度越快。默认值:"regular" 。支持:default、none、regular、high | - |
返回响应 (200)
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
status | 响应 JSON | string | 是 | - | - |
request_id | 响应 JSON | string | 是 | - | - |
response_url | 响应 JSON | string | 是 | - | - |
status_url | 响应 JSON | string | 是 | - | - |
cancel_url | 响应 JSON | string | 是 | - | - |
logs | 响应 JSON | null | 是 | - | - |
metrics | 响应 JSON | object | 是 | - | - |
queue_position | 响应 JSON | integer | 是 | - | - |
响应示例
{
"status": "IN_QUEUE",
"request_id": "3892f1e8-5fb1-469f-87b0-696d6054c9f2",
"response_url": "https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2",
"status_url": "https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2/status",
"cancel_url": "https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2/cancel",
"logs": null,
"metrics": {},
"queue_position": 0
}来源原始接口定义(用于追溯)
以下内容来自 Apifox 快照,可能包含兼容层字段或旧示例;公开调用请以本页的协议说明和当前模型列表为准。
{
"id": 495899886,
"name": "/fal-ai/flux-1/dev",
"type": "http",
"serverId": "",
"preProcessors": [],
"postProcessors": [],
"inheritPreProcessors": {},
"inheritPostProcessors": {},
"description": "官方文档: https://fal.ai/models/fal-ai/flux-1/dev",
"operationId": "",
"sourceUrl": "",
"method": "post",
"path": "/fal-ai/flux-1/dev",
"tags": [],
"status": 1,
"requestBody": {
"type": "application/json",
"parameters": [],
"jsonSchema": {
"type": "object",
"properties": {
"prompt": {
"type": "string"
},
"image_size": {
"type": "string",
"description": "生成图像的大小。默认值:landscape_4_3 范围(3:4、4:3、16:9、9:16)"
},
"num_inference_steps": {
"type": "integer",
"description": "要执行的推理步骤数。默认值:28 .范围值:0-50"
},
"guidance_scale": {
"type": "number",
"description": "CFG(无分类器引导)量表衡量了您希望模型在寻找相关图像时与提示的贴近程度。默认值:3.5 .范围值:1-20"
},
"num_images": {
"type": "integer",
"description": "生成的图像数量。默认值:1 范围值:1-4"
},
"enable_safety_checker": {
"type": "boolean",
"description": "如果设置为 true,则启用安全检查器。默认值:true"
},
"output_format": {
"type": "string",
"description": "生成图片的格式。默认值:\"jpeg\" .支持的格式default、JPEG、png"
},
"acceleration": {
"type": "string",
"description": "生成速度。速度越高,生成速度越快。默认值:\"regular\" 。支持:default、none、regular、high"
}
},
"required": [
"prompt"
],
"x-apifox-orders": [
"prompt",
"image_size",
"num_inference_steps",
"guidance_scale",
"num_images",
"enable_safety_checker",
"output_format",
"acceleration"
]
},
"examples": [
{
"mediaType": "application/json",
"value": "{\r\n \"prompt\": \"Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \\\"FLUX\\\" is painted over it in big, white brush strokes with visible texture.\",\r\n \"image_size\": \"landscape_4_3\",\r\n \"num_inference_steps\": 28,\r\n \"guidance_scale\": 3.5,\r\n \"num_images\": 1,\r\n \"enable_safety_checker\": true,\r\n \"output_format\": \"jpeg\",\r\n \"acceleration\": \"regular\"\r\n}"
}
],
"mediaType": "",
"oasExtensions": "",
"required": false,
"additionalContentTypes": []
},
"parameters": {
"path": [],
"query": [],
"cookie": [],
"header": []
},
"commonParameters": {
"query": [],
"body": [],
"cookie": [],
"header": []
},
"auth": {},
"responses": [
{
"id": 131443086,
"name": "成功",
"code": 200,
"contentType": "json",
"jsonSchema": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"request_id": {
"type": "string"
},
"response_url": {
"type": "string"
},
"status_url": {
"type": "string"
},
"cancel_url": {
"type": "string"
},
"logs": {
"type": "null"
},
"metrics": {
"type": "object",
"properties": {},
"x-apifox-orders": []
},
"queue_position": {
"type": "integer"
}
},
"required": [
"status",
"request_id",
"response_url",
"status_url",
"cancel_url",
"logs",
"metrics",
"queue_position"
],
"x-apifox-orders": [
"status",
"request_id",
"response_url",
"status_url",
"cancel_url",
"logs",
"metrics",
"queue_position"
]
},
"itemSchema": {},
"description": "",
"mediaType": "",
"headers": [],
"oasExtensions": ""
}
],
"responseExamples": [
{
"name": "成功示例",
"responseId": 131443086,
"data": "{\r\n \"status\": \"IN_QUEUE\",\r\n \"request_id\": \"3892f1e8-5fb1-469f-87b0-696d6054c9f2\",\r\n \"response_url\": \"https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2\",\r\n \"status_url\": \"https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2/status\",\r\n \"cancel_url\": \"https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2/cancel\",\r\n \"logs\": null,\r\n \"metrics\": {},\r\n \"queue_position\": 0\r\n}",
"description": "",
"oasKey": "",
"oasExtensions": "",
"id": "019fc09b-0b31-75fd-9d7e-324eb7b13255"
}
],
"codeSamples": [],
"projectId": 8662722,
"moduleId": 8310462,
"folderId": 92436089,
"ordering": 6,
"responsibleId": 0,
"commonResponseStatus": {},
"advancedSettings": {
"disabledSystemHeaders": {}
},
"customApiFields": {},
"oasExtensions": "",
"mockScript": {},
"createdAt": "2026-08-02T03:53:34.000Z",
"updatedAt": "2026-08-05T14:40:24.000Z",
"creatorId": 2863449,
"editorId": 2863449,
"creatorUserId": 2863449,
"editorUserId": 2863449,
"responseChildren": [
"BLANK.131443086"
],
"visibility": "INHERITED",
"securityScheme": {},
"callbacks": ""
}