Gerar uma imagem

Utilize um modelo de imagem atualmente ativado no ShareAI e permitido pelas suas credenciais. O modelo determina os tamanhos, níveis de qualidade e opções de saída que suporta.

Enviar uma solicitação#

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/images/generations" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
}'

import json
import os
import urllib.request

headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_IMAGE_MODEL', 'prompt': 'A quiet forest painted in watercolor.', 'n': 1, 'size': '1024x1024'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/images/generations', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=180) as response:
    print(json.load(response))

const url = "https://api.shareai.now/api/v1/images/generations";
const headers: Record = {
  Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());

Campos da solicitação#

Ler a imagem#

Inspecione as data entradas retornadas. Dependendo do modelo e do formato solicitado, uma entrada contém um URL de imagem HTTPS ou dados de imagem em base64. Utilize o formato retornado; não assuma que todos os fornecedores retornam um URL. A API não faz download de URLs de imagem retornados para si.

Limites de tamanho e tempo#

Os pedidos são síncronos. O texto combinado é limitado a 256 KiB, a chamada ao fornecedor a 120 segundos e a resposta a 2 MiB. Imagens grandes em base64 podem exceder esse limite de resposta. Selecione um tamanho de saída adequado ou um modelo que suporte saída em URL.

Tentar novamente com cuidado#

Gerar uma imagem pode incorrer em custos de utilização. Após um timeout ou uma falha de rede ambígua, verifique a atividade antes de tentar novamente; repetir o pedido pode gerar e cobrar por outra imagem. A API não tenta automaticamente novamente um pedido de imagem após a submissão a um fornecedor.

Operações suportadas#

Esta rota gera imagens a partir de texto. Edições de imagem, variações, uploads multipartidos e geração de imagens em streaming não são suportados. A faturação atual requer um contrato de utilização de tokens compatível com o modelo/fornecedor; fornecedores apenas por imagem podem não estar disponíveis.

Utilizar autorização do cliente#

Para um fluxo OAuth aprovado, envie o token de acesso como Bearer. A geração de imagens financiada pela conta requer surcharge e um plano de utilização aceito. Todas as restrições de modelo, fornecedor e conta permanecem em vigor.