Processo de Solicitação
Para usar a API OpenAI Images Generations, primeiro você pode acessar a página OpenAI Images Generations API e clicar no botão “Acquire” para obter as credenciais necessárias para a solicitação:
Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, convidando-o a se registrar e fazer login. Após o registro e login, você será redirecionado de volta para a página atual.
Na primeira solicitação, haverá um crédito gratuito disponível, permitindo o uso gratuito da API.
Uso Básico
Em seguida, você pode preencher os campos correspondentes na interface, como mostrado na imagem:
authorization, que pode ser selecionado diretamente na lista suspensa. O outro parâmetro é model, que é a categoria do modelo que escolhemos usar do site oficial da OpenAI DALL-E; aqui temos principalmente 1 tipo de modelo, e os detalhes podem ser vistos nos modelos que fornecemos. O último parâmetro é prompt, que é a palavra-chave que inserimos para gerar a imagem.
Você também pode notar que há um código de chamada correspondente gerado à direita, que você pode copiar e executar diretamente, ou pode clicar no botão “Try” para testar.
created, o ID gerado para esta geração de imagem, usado para identificar exclusivamente esta tarefa.data, que contém as informações do resultado da geração da imagem.
data inclui as informações específicas da imagem gerada pelo modelo, e o url é o link detalhado da imagem gerada, que pode ser visualizado como mostrado na imagem.
Parâmetro de Qualidade da Imagem quality
A seguir, apresentaremos como definir alguns parâmetros detalhados do resultado da geração de imagens, onde o parâmetro de qualidade da imagem quality contém duas opções: a primeira standard indica que a imagem gerada é padrão, e a outra hd indica que a imagem criada possui detalhes mais refinados e maior consistência.
Abaixo, definimos o parâmetro de qualidade da imagem como standard, com a configuração mostrada na imagem:
standard é mostrada na imagem abaixo:
hd para obter a imagem mostrada abaixo:
hd possui detalhes mais refinados e maior consistência em comparação com a gerada com standard.
Parâmetro de Tamanho da Imagem size
我们还可以设置生成图片的尺寸大小，我们可以进行下面的设置。
下面设置图片的尺寸大小为 1024 * 1024 ，具体设置如下图：
1024 * 1024 的生成图片如下图所示：
1792 * 1024 ，可以得到如下图所示的图片：
可以看到图片的尺寸大小很明显不一样，另外还可以设置更多尺寸大小，详情信息参考我们官网文档。
图片风格参数 style
图片风格参数 style 包含俩个参数，第一种 vivid 表示生成的图片是更加生动的，另一种 natural 表示生成的图片更加的自然一点。
下面设置图片风格参数为 vivid ，具体设置如下图：
vivid 的生成图片如下图所示：
natural ，可以得到如下图所示的图片：
vivid 比 natural 生成的图片具有更加生动逼真。
图片链接的格式参数 response_format
最后一个图片链接的格式参数 response_format 也有俩种，第一种 b64_json 是对图片链接进行 Base64 编码，另一种 url 就是普通的图片链接，可以直接查看图片。
下面设置图片链接的格式参数为 url ，具体设置如下图：
url para a imagem gerada é URL da imagem e é acessível diretamente, o conteúdo da imagem é mostrado na figura abaixo:
b64_json para obter o resultado do link da imagem codificado em Base64, o resultado específico é mostrado na figura abaixo:
Callback Assíncrono
Como a API de Gerações de Imagens da OpenAI pode levar um tempo relativamente longo para gerar imagens, se a API não responder por um longo período, a requisição HTTP manterá a conexão, resultando em um consumo adicional de recursos do sistema. Portanto, esta API também oferece suporte a callbacks assíncronos. O fluxo geral é: quando o cliente inicia a requisição, deve especificar um campocallback_url adicional. Após o cliente fazer a requisição à API, a API retornará imediatamente um resultado, contendo um campo task_id, que representa o ID da tarefa atual. Quando a tarefa for concluída, o resultado da imagem gerada será enviado para o callback_url especificado pelo cliente em formato JSON POST, que também incluirá o campo task_id, permitindo que o resultado da tarefa seja associado pelo ID.
Vamos entender como operar isso através de um exemplo.
Primeiro, o callback Webhook é um serviço que pode receber requisições HTTP, e o desenvolvedor deve substituí-lo pela URL do servidor HTTP que ele configurou. Para facilitar a demonstração, usaremos um site de exemplo de Webhook público https://webhook.site/, ao abrir este site, você obterá uma URL de Webhook, como mostrado na imagem:
Copie esta URL e você pode usá-la como Webhook, o exemplo aqui é https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab.
Em seguida, podemos definir o campo callback_url para a URL do Webhook acima, ao mesmo tempo preenchendo os parâmetros correspondentes, como mostrado no código abaixo:
task_id, e o campo data inclui os mesmos resultados de geração de imagem que a chamada síncrona, permitindo que a tarefa seja associada pelo campo task_id.
Tratamento de Erros
Ao chamar a API, se ocorrer um erro, a API retornará o código de erro e a mensagem correspondente. Por exemplo:400 token_mismatched: Requisição inválida, possivelmente devido a parâmetros ausentes ou inválidos.400 api_not_implemented: Requisição inválida, possivelmente devido a parâmetros ausentes ou inválidos.401 invalid_token: Não autorizado, token de autorização inválido ou ausente.429 too_many_requests: Muitas requisições, você excedeu o limite de taxa.500 api_error: Erro interno do servidor, algo deu errado no servidor.