100 lines
3.8 KiB
Markdown
100 lines
3.8 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 即可获得该图片
|
||
|
||
|
||
|
||
拼接地址 http://sl.vrgon.com:6060/files/tools/8faea5f8-b5c9-498a-b557-a39c474f0e59.png?timestamp=1713938972&nonce=ab195cba5d0c37924bbbdfe1fd2c62e9&sign=F_kZ8pAmMi2xgtg47yGhgYXv_lAUHnZTD9_NuFQLkj0=
|