aisplice

Referência da API

Imagens: direto

Nenhum modelo atende a isto ainda

Nenhum modelo do catálogo oferece esta rota no momento. A página continua disponível como referência.
POST/v1/images/generations

Geração de imagens síncrona para os modelos que atendem a esta rota, em um único corpo no formato da OpenAI. A resposta traz as URLs finais das imagens.

#Parâmetros da requisição

  • modelstringobrigatório

    Um modelo de imagem que atende a esta rota síncrona. Modelos só de tarefa a rejeitam — use /v1/images/tasks.

  • promptstringobrigatório

    O que desenhar.

  • nintegeropcional

    Número de imagens (a cobrança é multiplicada por imagem).

  • sizestringopcional

    Proporção predefinida como "16:9" — o formato que a maioria dos modelos de imagem usa; os valores exatos estão na ficha do modelo. Alguns modelos mais antigos também aceitam WIDTHxHEIGHT.

  • resolutionstringopcional

    Faixa de resolução da saída como "1K", "2K" ou "4K", quando a ficha do modelo a lista — também uma dimensão da faixa de preço.

  • qualitystringopcional

    Nível de qualidade do provedor (por exemplo, standard / hd) — também uma dimensão da faixa de preço.

  • response_formatstringopcional

    "url" (padrão) ou "b64_json" para bytes inline.

Preço por faixa

size, quality e duration selecionam a faixa cobrada — a ficha do modelo lista o preço exato de cada faixa, e chamadas com falha são reembolsadas automaticamente.

#Erros relacionados

  • 422 unprocessable_entityO provedor rejeitou valores de parâmetros que o gateway repassou (por exemplo, tamanho ou duração não suportados).
  • 401Bearer token inválido ou ausente. Não há error.code neste caminho — verifique o status.
  • 402 insufficient_user_quotaO saldo da carteira não cobre a estimativa pré-reservada.
  • 429Limitação por chave. Corpo vazio; aguarde o Retry-After. Um 429 que traz insufficient_user_quota indica, na verdade, o limite de gastos diário.
  • 503 model_not_foundModelo desconhecido, ou nenhum canal saudável o atende no momento.

Tabela completa de códigos de erro →

#Exemplo de requisição

curl https://www.aisplice.store/v1/images/generations \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_SYNC_IMAGE_MODEL",
    "prompt": "A cyberpunk skyline at dusk, neon rain",
    "size": "1:1"
  }'

#Resposta

response.json
{
  "created": 1720000000,
  "data": [{"url": "https://…"}]
}

Ainda com problemas?

Envie para nós o ID da requisição ou a mensagem de erro e vamos investigar.

AnteriorMessages (formato Anthropic)PróximoImagens: tarefas assíncronas