Gradio 的四种界面类型

到目前为止，我们一直认为要构建 Gradio 演示，需要同时具备输入和输出。但这对于机器学习演示并非总是如此：例如，无条件图像生成模型不接受任何输入，但会生成图像作为输出。

事实证明，gradio.Interface 类实际上可以处理四种不同类型的演示

标准演示：同时具有独立输入和输出（例如图像分类器或语音转文本模型）
仅输出演示：不接受任何输入但产生输出（例如无条件图像生成模型）
仅输入演示：不产生任何输出但接受某种输入（例如将您上传的图像保存到持久外部数据库的演示）
统一演示：同时具有输入和输出组件，但输入和输出组件是相同的。这意味着生成的输出会覆盖输入（例如文本自动完成模型）

根据演示类型，用户界面 (UI) 看起来会略有不同

让我们看看如何使用 Interface 类构建每种类型的演示，并附带示例

标准演示

要创建同时具有输入和输出组件的演示，只需在 Interface() 中设置 inputs 和 outputs 参数的值即可。这是一个简单图像过滤器的演示示例

import numpy as np
import gradio as gr

def sepia(input_img):
    sepia_filter = np.array([
        [0.393, 0.769, 0.189],
        [0.349, 0.686, 0.168],
        [0.272, 0.534, 0.131]
    ])
    sepia_img = input_img.dot(sepia_filter.T)
    sepia_img /= sepia_img.max()
    return sepia_img

demo = gr.Interface(sepia, gr.Image(), "image")
demo.launch()

仅输出演示

那么只包含输出的演示呢？要构建此类演示，只需将 Interface() 中的 inputs 参数值设置为 None。这是一个模拟图像生成模型的演示示例

import time

import gradio as gr

def fake_gan():
    time.sleep(1)
    images = [
            "https://images.unsplash.com/photo-1507003211169-0a1dd7228f2d?ixlib=rb-1.2.1&ixid=MnwxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8&auto=format&fit=crop&w=387&q=80",
            "https://images.unsplash.com/photo-1554151228-14d9def656e4?ixlib=rb-1.2.1&ixid=MnwxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8&auto=format&fit=crop&w=386&q=80",
            "https://images.unsplash.com/photo-1542909168-82c3e7fdca5c?ixlib=rb-1.2.1&ixid=MnwxMjA3fDB8MHxzZWFyY2h8MXx8aHVtYW4lMjBmYWNlfGVufDB8fDB8fA%3D%3D&w=1000&q=80",
    ]
    return images

demo = gr.Interface(
    fn=fake_gan,
    inputs=None,
    outputs=gr.Gallery(label="Generated Images", columns=2),
    title="FD-GAN",
    description="This is a fake demo of a GAN. In reality, the images are randomly chosen from Unsplash.",
)

demo.launch()

仅输入演示

类似地，要创建仅包含输入的演示，请将 Interface() 中的 outputs 参数值设置为 None。这是一个将任何上传图像保存到磁盘的演示示例

import random
import string
import gradio as gr

def save_image_random_name(image):
    random_string = ''.join(random.choices(string.ascii_letters, k=20)) + '.png'
    image.save(random_string)
    print(f"Saved image to {random_string}!")

demo = gr.Interface(
    fn=save_image_random_name,
    inputs=gr.Image(type="pil"),
    outputs=None,
)
demo.launch()

统一演示

一个将单个组件同时作为输入和输出的演示。只需将 inputs 和 outputs 参数的值设置为相同组件即可创建。这是一个文本生成模型的演示示例

import gradio as gr
from transformers import pipeline

generator = pipeline('text-generation', model = 'gpt2')

def generate_text(text_prompt):
  response = generator(text_prompt, max_length = 30, num_return_sequences=5)
  return response[0]['generated_text']  

textbox = gr.Textbox()

demo = gr.Interface(generate_text, textbox, textbox)

demo.launch()

如果以上四种情况都不能满足您的确切需求，那么您需要使用 gr.Blocks() 方法！