Qwen2 文生图
接口
POST /images/generations
完整 URL: https://modelfold.ai/v1/images/generations
鉴权:所有请求都需要
Authorization: Bearer <API_KEY>请求头。
模型参数直接放在 JSON 请求体中,不要套 input。请求等待生成完成后返回 data[].url;支持的媒体模型也可使用 异步创建、轮询及回调。示例素材地址须替换为自己的公开可访问文件。计费及错误说明见 API 网关。
生成任务的输入参数
请求参数
请求体 (application/json)
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 用于生成任务的模型名称。必填字段。 - 该端点使用 qwen2/text-to-image 模型。 默认值:"qwen2/text-to-image"。 可选值:qwen2/text-to-image。 示例:qwen2/text-to-image。 |
prompt | string | 是 | 本站网关要求传入 prompt,最长 2000 字。用于图像生成的文本提示词。最大长度:5000 字符。 maxLength: 2000. 示例:霓虹灯映照下的雨夜城市海报。。 |
image_size | string | 否 | 生成图像的尺寸规格。默认值:16:9 默认值:"16:9"。 可选值:1:1 / 3:4 / 4:3 / 9:16 / 16:9。 示例:16:9。 |
seed | integer | 否 | 随机种子值。相同的种子值、提示词和模型版本,每次生成的图像结果完全一致。 |
output_format | string | 否 | 输出格式:png 或 jpeg。请显式传入。 可选值:jpeg / png。 示例:png。 |
nsfw_checker | boolean | 否 | 默认 false。为 false 时不额外进行内容过滤,结果由模型直接返回。 |
请求示例
bash
curl -X POST "https://modelfold.ai/v1/images/generations" \
-H "Authorization: Bearer $MODELFOLD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen2/text-to-image",
"prompt": "霓虹灯映照下的雨夜城市海报。",
"image_size": "16:9"
}'json
{
"model": "qwen2/text-to-image",
"prompt": "霓虹灯映照下的雨夜城市海报。",
"image_size": "16:9"
}响应
200 — 生成完成。usage 返回实际计费明细;结果地址仅作结构示例。
json
{
"ok": true,
"created": 1792134000,
"data": [
{
"url": "https://modelfold.ai/uploads/outputs/result.png"
}
],
"usage": {}
}