目录

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=](docs/img/8faea5f8-b5c9-498a-b557-a39c474f0e59.png)