96 lines
3.6 KiB
Markdown
96 lines
3.6 KiB
Markdown
|
|
|||
|
|
目录
|
|||
|
|
|
|||
|
|
1\. 文生图接口
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**1\. 文生图接口**
|
|||
|
|
#### 接口功能
|
|||
|
|
> 根据prompt生成图片
|
|||
|
|
|
|||
|
|
#### URL
|
|||
|
|
> http://sl.vrgon.com:6060/v1/workflows/run
|
|||
|
|
|
|||
|
|
#### Authorization
|
|||
|
|
> Bearer Token (密钥请联系算法团队)
|
|||
|
|
|
|||
|
|
#### 支持格式
|
|||
|
|
> JSON
|
|||
|
|
|
|||
|
|
#### HTTP请求方式
|
|||
|
|
> POST
|
|||
|
|
|
|||
|
|
#### 请求参数
|
|||
|
|
|
|||
|
|
##### Request Body
|
|||
|
|
|
|||
|
|
- inputs (object) Required 允许传入 App 定义的各变量值。 inputs 参数包含了多组键值对（Key/Value pairs），每组的键对应一个特定变量，每组的值则是该变量的具体值。
|
|||
|
|
- response_mode (string) Required 返回响应模式，支持：
|
|||
|
|
- streaming 流式模式（推荐）。基于 SSE（Server-Sent Events）实现类似打字机输出方式的流式返回。
|
|||
|
|
- blocking 阻塞模式，等待执行完毕后返回结果。（请求若流程较长可能会被中断）。 由于 Cloudflare 限制，请求会在 100 秒超时无返回后中断。
|
|||
|
|
- user (string) Required 用户标识，用于定义终端用户的身份，方便检索、统计。 由开发者定义规则，需保证用户标识在应用内唯一。
|
|||
|
|
|
|||
|
|
|参数|必选|类型|说明|
|
|||
|
|
|:----- |:-------|:-----|----- |
|
|||
|
|
|inputs |ture |json|请求数据 |
|
|||
|
|
|response_mode |true |string |返回方式。1：streaming；2：blocking 。|
|
|||
|
|
|user |true |string |用户名例如：zk-123。|
|
|||
|
|
|
|||
|
|
##### inputs (object)
|
|||
|
|
|
|||
|
|
|参数|必选|类型|说明|
|
|||
|
|
|:----- |:-------|:-----|----- |
|
|||
|
|
|prompt |ture |string|提示词 |
|
|||
|
|
|model_name |fasle |string |模型名称可选，[chilloutmix_NiPrunedFp32Fix],[dosmix_],[ghostmix_v20Bakedvae],[rundiffusionFX_v10],[v1-5-pruned-emaonly]默认为[v1-5-pruned-emaonly] 。|
|
|||
|
|
|
|||
|
|
#### 接口示例
|
|||
|
|
|
|||
|
|
``` javascript
|
|||
|
|
curl -X POST 'http://sl.vrgon.com:6060/v1/workflows/run' \
|
|||
|
|
--header 'Authorization: Bearer {api_key}' \
|
|||
|
|
--header 'Content-Type: application/json' \
|
|||
|
|
--data-raw '{
|
|||
|
|
"inputs": {
|
|||
|
|
"prompt": "一个胸有成竹的男人",
|
|||
|
|
"model_name": "chilloutmix_NiPrunedFp32Fix"
|
|||
|
|
},
|
|||
|
|
"response_mode": "blocking",
|
|||
|
|
"user": "alg123"
|
|||
|
|
}'
|
|||
|
|
```
|
|||
|
|
#### Response
|
|||
|
|
```javascript
|
|||
|
|
{
|
|||
|
|
"task_id": "40a1cce0-f8d1-4fa9-8d03-857ed804fe2a",
|
|||
|
|
"workflow_run_id": "00c81e90-5f5c-4606-8c10-de9195f5d159",
|
|||
|
|
"data": {
|
|||
|
|
"id": "00c81e90-5f5c-4606-8c10-de9195f5d159",
|
|||
|
|
"workflow_id": "aa4896ce-61eb-4873-8e8d-b18789bbd41b",
|
|||
|
|
"status": "succeeded",
|
|||
|
|
"outputs": {
|
|||
|
|
"files": [
|
|||
|
|
{
|
|||
|
|
"__variant": "FileVar",
|
|||
|
|
"tenant_id": "a28e2d2e-0eb5-49a6-8742-16369a5c22bd",
|
|||
|
|
"type": "image",
|
|||
|
|
"transfer_method": "tool_file",
|
|||
|
|
"url": "/files/tools/8faea5f8-b5c9-498a-b557-a39c474f0e59.png?timestamp=1713938972&nonce=ab195cba5d0c37924bbbdfe1fd2c62e9&sign=F_kZ8pAmMi2xgtg47yGhgYXv_lAUHnZTD9_NuFQLkj0=",
|
|||
|
|
"related_id": "8faea5f8-b5c9-498a-b557-a39c474f0e59",
|
|||
|
|
"filename": "image",
|
|||
|
|
"extension": ".png",
|
|||
|
|
"mime_type": "image/png"
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
},
|
|||
|
|
"error": null,
|
|||
|
|
"elapsed_time": 18.601953488003346,
|
|||
|
|
"total_tokens": 536,
|
|||
|
|
"total_steps": 5,
|
|||
|
|
"created_at": 1713938954,
|
|||
|
|
"finished_at": 1713938972
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
请求结果中的 url 即为生成好的图片,通过拼接http://sl.vrgon.com:6060 即可获得该图片
|
|||
|
|
|