模型 API 目录（含官方/标准）▾
POST标准渠道图像
图片放大 · 可调倍数 图像生成
model = image-upscale-by·¥0.10/次
- 异步处理模式：提交后立即返回 task_id，再轮询任务接口
- 统一生图接口 POST /api/v1/images/generations
- 异步任务接口：POST /api/v1/images/generations + GET /api/v1/tasks/{task_id}
- 渠道：标准渠道 · 售价 ¥0.10/次 · 失败自动退款
标准渠道
本模型为标准（经济）路由。同族若存在「官方渠道」条目，可在左侧目录展开切换。
模型 ID
请求体 model 必须为
image-upscale-by。简介
RunningHub 图片放大工作流，支持 2×、3×、4× 放大，按次计费。
Authorizations
需要 Bearer Token。在 API Key 管理 创建后，请求头加入：
Authorization: Bearer sk-你的API_Key
Base URL：https://xiaoguai123.xyz
Body
模型名称
- 固定填写
image-upscale-by
图像生成的文本描述
- 支持中英文，建议详细描述
- 可能触发内容安全策略，违规会直接报错
image
- 见取值说明
使用场景示例
文生图（最简）
{
"model": "image-upscale-by",
"prompt": "一只橘猫坐在窗台上看夕阳，水彩画风格"
}带默认参数的完整示例
{
"model": "image-upscale-by",
"prompt": "一只橘猫坐在窗台上看夕阳，水彩画风格",
"scale_by": "4"
}Response
提交成功时返回任务数组：
status：如 submitted（已提交）task_id：任务唯一标识，用于后续查询
查询任务结果
GET https://xiaoguai123.xyz/api/v1/tasks/{task_id}
Authorization: Bearer sk-你的API_Key• 提交（OpenAI 兼容）：POST https://xiaoguai123.xyz/api/v1/images/generations
• 查询（OpenAI 兼容）：GET https://xiaoguai123.xyz/api/v1/tasks/{task_id}
• 提交（原生）：POST https://xiaoguai123.xyz/api/v1/images/generations
• 查询（原生）：GET https://xiaoguai123.xyz/api/v1/tasks/{task_id}
• status=completed 时读取 result.images / result.videos；failed 已自动退款
详见 任务查询接口。
| 状态 | 含义 |
|---|---|
| pending / submitted | 已提交或排队 |
| processing | 上游处理中 |
| completed | 成功，result 可用 |
| failed | 失败，已自动退款 |
REQUEST
curl -X POST https://xiaoguai123.xyz/api/v1/images/generations \
-H "Authorization: Bearer sk-你的Key" \
-H "Content-Type: application/json" \
-d '{ "model": "image-upscale-by", "image": "https://example.com/input.png" }'RESPONSE
成功提交
{
"code": 200,
"data": [
{
"status": "submitted",
"task_id": "xg_01hxyz..."
}
]
}