Console da API

Use o gerador do Fellowi Images direto do seu código. Mesmos modelos, mesmos preços, mesma carteira de moedas, só que com uma chave de API no lugar do formulário da web.

Autenticação

Toda requisição precisa de uma chave de API no cabeçalho Authorization: Authorization: Bearer fk_live_.... As chaves são criadas abaixo e aparecem uma única vez, na criação, então guarde a sua em um lugar seguro.

Sua chave de API

Chave de API

Cole uma chave para preenchê-la em todos os exemplos desta página e testar a API daqui. Ela fica só nesta aba do navegador e é enviada apenas para a API deste site.

Lembrar nesta aba

Modelos

Escolha um modelo no campo model. Os preços são por imagem, em Fellowi Coins, e são exatamente os que o Estúdio de Imagens da web cobra. Texto para imagem é o que você recebe com a lista images vazia; ao enviar referências, entra o modelo de edição, que pode custar um valor diferente.

Se você omitir model, vale fellowi-text-to-image: o mesmo modelo e o mesmo preço que uma integração escrita antes dessa escolha existir sempre teve.

curl https://fellowi.com/api/v1/api/models

Criar uma imagem

POST /v1/api/images responde na hora com 202 e uma geração na fila; a imagem em si leva até alguns minutos. Envie um cabeçalho Idempotency-Key para que uma nova tentativa nunca cobre duas vezes.

images é opcional: até 10 URLs públicas de imagens a partir das quais o modelo edita (uma foto de companheiro, uma referência sua). Cada uma soma 10 moedas ao preço, e uma lista não vazia usa o modelo de edição em vez de texto para imagem.

curl -X POST https://fellowi.com/api/v1/api/images \
  -H "Authorization: Bearer fk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "prompt": "a neon-lit cyberpunk portrait",
    "model": "fellowi-text-to-image",
    "quality": "standard",
    "format": "png",
    "aspectRatio": "1:1",
    "enhancePrompt": false,
    "enhanceStyle": "default",
    "images": []
  }'

Opções da requisição

Tudo abaixo é opcional. Cada valor padrão é o comportamento que a API tinha antes de a opção existir, então uma integração antiga continua funcionando sem mudanças.

quality: standard ou high. Define a resolução e o preço, veja a tabela acima.
format: png ou jpeg. O padrão é png.
aspectRatio: auto (o padrão) ou uma entre 1:1, 3:4, 4:3, 2:3, 3:2, 4:5, 5:4, 16:9, 9:16, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21.
enhancePrompt / enhanceStyle: Defina enhancePrompt como true para que seu prompt seja reescrito antes da renderização, por 10 moedas a mais. enhanceStyle orienta essa reescrita: default, artistic, photographic, technical, anime ou realistic. É ignorado quando enhancePrompt está desligado.
images: Até 10 URLs de imagens acessíveis publicamente para editar. Enviar qualquer uma muda a requisição para o modelo de edição. Cada imagem de referência em images soma 10 moedas.

Consultar o resultado

Consulte GET /v1/api/images/{id} até o status ser succeeded e então baixe imageUrl. Gerações failed são reembolsadas automaticamente.

curl https://fellowi.com/api/v1/api/images/{id} \
  -H "Authorization: Bearer fk_live_..."

Quando uma geração falha

Uma geração que falha devolve as moedas e informa um de quatro códigos em failureCode: TIMEOUT, MODERATION_REJECTED, VENDOR_ERROR ou UNKNOWN. Nada mais específico é divulgado, porque um código interno diria algo sobre o nosso processamento, não sobre a sua requisição.

Limites de uso e custo

Cada chave tem seu próprio limite de requisições por minuto (visível no painel abaixo) e pode ter um teto diário de moedas. Servem como proteção contra abuso, não são o teto real: o que de fato limita quantas imagens você gera é o saldo de Fellowi Coins. 403 com uma página HTML: a requisição foi barrada antes de chegar à API, em geral por causa do User-Agent. O User-Agent padrão do Python-urllib é bloqueado, então envie o seu, por exemplo User-Agent: my-app/1.0.