Codificar imagens em Base64
Para fazer solicitações de geração de imagens, é preciso enviar dados de imagem como texto codificado em Base64.
Como usar a linha de comando
Em uma solicitação gRPC, você pode simplesmente gravar os dados binários diretamente; no entanto, JSON é usado ao fazer uma solicitação REST. JSON é um formato de texto que não suporta diretamente dados binários, então você precisará converter esses dados binários em texto usando a codificação Base64.
A maioria dos ambientes de desenvolvimento contém um utilitário base64
nativo para
codificar um binário em dados de texto ASCII. Para codificar um arquivo, faça o seguinte:
Linux
Codifique o arquivo de vídeo usando a ferramenta de linha de comando em base64
, evitando a quebra de linha com a sinalização -w 0
:
base64 INPUT_FILE -w 0 > OUTPUT_FILE
macOS
Codifique o arquivo usando a ferramenta de linha de comando base64
:
base64 -i INPUT_FILE -o OUTPUT_FILE
Windows
Codifique o arquivo usando a ferramenta Base64.exe
:
Base64.exe -e INPUT_FILE > OUTPUT_FILE
PowerShell
Codifique o arquivo usando o método Convert.ToBase64String
:
[Convert]::ToBase64String([IO.File]::ReadAllBytes("./INPUT_FILE")) > OUTPUT_FILE
Crie um arquivo de solicitação JSON, incluindo os dados codificados em base64:
JSON
{ "instances": [ { "prompt": "TEXT_PROMPT", "image": { "bytes_base64_encoded": "B64_BASE_IMAGE" } } ] }
Como usar bibliotecas de cliente
Incorporar dados binários de áudio em solicitações por meio de editores de texto não é desejável nem prático. Na prática, você estará incorporando arquivos com codificação base64 no código do cliente. Todas as linguagens de programação compatíveis têm mecanismos integrados para o conteúdo de codificação base64:
Python
# Import the base64 encoding library.
import base64
# Pass the image data to an encoding function.
def encode_image(image):
with open(image, "rb") as image_file:
encoded_string = base64.b64encode(image_file.read())
return encoded_string
Node.js
// Read the file into memory.
var fs = require('fs');
var imageFile = fs.readFileSync('/path/to/file');
// Convert the image data to a Buffer and base64 encode it.
var encoded = Buffer.from(imageFile).toString('base64');
Java
// Import the Base64 encoding library.
import org.apache.commons.codec.binary.Base64;
// Encode the image.
byte[] imageData = Base64.encodeBase64(imageFile.getBytes());
String encodedString = Base64.getEncoder().encodeToString(imageData);
Go
import (
"bufio"
"encoding/base64"
"io"
"os"
)
// Open image file.
f, _ := os.Open("image.jpg")
// Read entire image into byte slice.
reader := bufio.NewReader(f)
content, _ := io.ReadAll(reader)
// Encode image as base64.
base64.StdEncoding.EncodeToString(content)
Decodificar imagens em Base64
As solicitações de API retornam imagens geradas ou editadas como strings codificadas em base64. Use as amostras de biblioteca de cliente a seguir para decodificar esses dados e salvá-los localmente como um arquivo de imagem.
Python
# Import the base64 encoding library.
import base64
# Pass the base64 encoded image data to a decoding function and save image file.
def decode_image(b64_encoded_string):
with open("b64DecodedImage.png", "wb") as fh:
fh.write(base64.decodebytes(b64_encoded_string))
Node.js
var fs = require('fs');
// Create buffer object, specifying base64 as encoding
var buf = Buffer.from(base64str,'base64');
// Write buffer content to a file
fs.writeFile("b64DecodedImage.png", buf, function(error){
if(error){
throw error;
}else{
console.log('File created from base64 string');
return true;
}
});
Java
// Import libraries
import org.apache.commons.codec.binary.Base64;
import org.apache.commons.io.FileUtils;
// Create new file
File file = new File("./b64DecodedImage.png");
// Convert base64 encoded string to byte array
byte[] bytes = Base64.decodeBase64("base64");
// Write out file
FileUtils.writeByteArrayToFile(file, bytes);
Go
// Import packages
import (
"encoding/base64"
"io"
"os"
)
// Add encoded file string
var b64 = `TWFuIGlz...Vhc3VyZS4=`
// Decode base64-encoded string
dec, err := base64.StdEncoding.DecodeString(b64)
if err != nil {
panic(err)
}
// Create output file
f, err := os.Create("b64DecodedImage.png")
if err != nil {
panic(err)
}
defer f.Close()
if _, err := f.Write(dec); err != nil {
panic(err)
}
if err := f.Sync(); err != nil {
panic(err)
}