ShareAI Platform Docs

Gerar imagens

A resposta JSON síncrona contém resultados de imagens nos dados.

Ver como Markdown
Nesta página
POST https://api.shareai.now/api/v1/images

Gerar imagens

URL Base
https://api.shareai.now
Autenticação
Chave de API Bearer ou token de acesso OAuth aprovado
Escopo necessário
inference or monetization_gateway

A resposta JSON síncrona contém resultados de imagens em data. O alias /api/v1/images/generations também é suportado. Opções como tamanho, resolução, proporção, qualidade e formato de saída dependem do modelo selecionado. As respostas são limitadas a 2 MiB; reduza a quantidade ou o tamanho das imagens, se necessário. As imagens retornadas são limitadas a 8192 pixels por lado.

Antes de começar#

Defina SHAREAI_API_KEY no seu servidor e substitua o espaço reservado do modelo por um modelo atualmente ativado. Nunca exponha a chave da API no código do navegador. O modelo, conta, credencial e fornecedor devem permitir esta operação. As configurações opcionais abaixo requerem suporte do modelo; os limites de segurança da API não garantem que todos os modelos suportem todos os valores.

Enviar uma solicitação#

cURL

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

Campos da solicitação#

CampoTipoSignificado e limites
model obrigatóriostringIdentificador exato do modelo público ativado. Deve declarar esta operação e ser permitido pela sua credencial.
prompt obrigatóriostringPrompt de geração não vazio, com no máximo 256 KiB de texto UTF-8.
ninteiroQuantidade opcional de imagens, 1–10; padrão 1. O seu modelo pode permitir menos.
sizestringTamanho de saída suportado pelo modelo, com no máximo 100 caracteres, por exemplo 1024×1024. Nem todos os modelos suportam esta opção.
resolutionstringSeletor de resolução suportada pelo modelo, com no máximo 100 caracteres; deve corresponder à variante tarifária publicada.
aspect_ratiostringSeletor de proporção de aspeto suportada pelo modelo, com no máximo 100 caracteres.
qualitystringSeletor de qualidade suportado pelo modelo, no máximo 100 caracteres; pode selecionar uma taxa diferente.
response_formatstringFormato de resposta suportado pelo modelo, com no máximo 100 caracteres. A operação determina se o resultado é JSON ou binário.
output_formatstringSeletor de codificação de saída suportado pelo modelo, no máximo 100 caracteres.
backgroundstringConfiguração opcional de fundo da imagem quando suportada pelo modelo.
seedinteiroSemente opcional suportada pelo modelo. O vídeo requer um número inteiro não negativo; a reprodutibilidade depende do executor.
input_referencesarrayNo máximo 16 partes image_url tipificadas com image_url.url definido para um URL HTTPS ou URL de dados de imagem suportado. É necessário suporte do modelo.
providerobjetoPreferências opcionais de roteamento do fornecedor. Utilize provider.only para etiquetas de fornecedor aceites, não como prefixo no ID do modelo. As restrições de conta e credencial ainda se aplicam.

Ler o resultado#

Sucesso retorna HTTP 200 com JSON. A resposta JSON síncrona contém resultados de imagens em data. O alias /api/v1/images/generations também é suportado. Opções como tamanho, resolução, proporção, qualidade e formato de saída dependem do modelo selecionado. As respostas são limitadas a 2 MiB; reduza a quantidade ou o tamanho das imagens, se necessário. As imagens retornadas são limitadas a 8192 pixels por lado.

Unidades de faturação#

As tarifas de imagens podem usar imagens geradas, megapixels medidos, referências de entrada, pedidos ou tokens reportados pelo Provider. Um URL de imagem não é uma medição de tamanho de imagem. Tarifas por megapixel exigem dimensões das imagens retornadas; use saída em base64 para essas rotas.

Escolha o identificador exato do modelo ativado no Console. A sua operação declarada e capacidades de entrada/saída devem corresponder a este endpoint; um modelo de chat de texto não pode ser substituído por outra operação. As restrições da sua credencial, fornecedor e conta ainda se aplicam.

Preços e utilização#

As tarifas são publicadas em créditos de IA em EUR para o modelo, fornecedor, unidades e variantes selecionados. Apenas as dimensões na sua tarifa ativa são cobradas. Uma estimativa reserva créditos antes da execução; os encargos finais utilizam a utilização medida. Os preços podem depender da resolução, formato de saída ou de uma faixa de utilização. Verifique a Utilização no Console para o débito final do ShareAI. Os campos de custo a montante e bytes de media não são convertidos em contagens de tokens inventadas.

Acesso e erros#

Uso inference para inferência aprovada de custo de rede ou monetization_gateway para uma margem aprovada do Builder e termos de faturação aceites. O acesso apenas por identidade não autoriza despesas. Validação, autorização de modelo, créditos insuficientes, limites de taxa e falhas de execução retornam uma estrutura error. Após um tempo limite ou submissão incerta, inspecione a Utilização ou o trabalho de vídeo antes de criar outro pedido potencialmente pago.

Última atualização 3 de Novembro de 2026

Documentação da Plataforma ShareAI
Toda a documentação

Pesquisar por título ou conteúdo.

Perguntar sobre esta página

Escolha um assistente para explorar esta página. Também pode copiar a página e colá-la na sua conversa.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI