Desenvolvedores · API v1

Uma API.
Todos os modelos.

Imagens, vídeo, áudio e 3D atrás de uma só API, pagos com o mesmo saldo do estúdio. Crie uma chave em Configurações. A CLI chega em breve.

Obter uma chave de APIInício rápido

Em breveA CLI e os SDKs chegam em breve. A API REST abaixo já funciona hoje.

Modelos
672
Endpoints
9
Recarga mínima
€ 3
01 · Exemplos

A mesma chamada, qualquer resultado

Troque o ID do modelo para alternar entre imagem, vídeo e voz. Os campos seguem o modelo.

1# 1. Generate an image2curl -X POST https://femimg.com/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $FEMIMG_API_KEY" \4  -H 'Content-Type: application/json' \5  -H "Idempotency-Key: $(uuidgen)" \6  -d '{7  "modelId": "luma/uni-v1/text-to-image",8  "inputs": {9    "prompt": "Neon city street after rain, cinematic night",10    "size": "16:9"11  }12}'13 14# 2. Poll with the generation id from step 1 until its status is succeeded15curl https://femimg.com/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $FEMIMG_API_KEY"17 18# 3. Download the file19curl https://femimg.com/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $FEMIMG_API_KEY" \21  -o result.jpeg
landing.dev.outputTitleluma/uni-v1/text-to-image
02 · Início rápido

Seu primeiro render em três passos

  1. 01Crie uma chave de APIEm Configurações > Chaves de API, dê um nome à chave e copie-a uma vez. Recarregue a partir de € 3 em Cobrança.export FEMIMG_API_KEY="YOUR_API_KEY"
  2. 02Inicie um renderEnvie o ID do modelo e as entradas. Você recebe na hora uma geração com status queued.POST /api/v1/api/catalog/generations
  3. 03Consulte e baixeConsulte a geração até o status ser succeeded e baixe o arquivo.GET /api/v1/api/catalog/generations/ID/content
03 · CLIEm breve

Renderize pelo terminal

Uma ferramenta de linha de comando para scripts, CI e agentes de código está a caminho, com as mesmas chaves e o mesmo saldo da API. Até lá, todas as chamadas desta página funcionam com curl.

Scripts e CIRenderize de qualquer shell, job ou cron.
Saída JSONUm documento JSON por execução, pronto para o próximo passo.
Agentes de códigoSeu agente confere o preço antes e limita o que gasta.
04 · O essencial da API

Feita para produção

Autenticação

Um token Bearer no cabeçalho Authorization. Crie chaves em Configurações.

Authorization: Bearer YOUR_API_KEY

Renders em segundo plano

Iniciar um render responde na hora com status queued. Consulte até virar succeeded, failed ou refunded.

{ "status": "queued" }

Preço primeiro

Peça o preço exato das suas entradas sem iniciar nada. Todo valor é em centavos de euro.

POST /api/v1/api/catalog/quote

Novas tentativas seguras

Envie um cabeçalho Idempotency-Key e uma nova tentativa nunca cobra duas vezes.

Idempotency-Key: render-042

Limites

Cada chave tem um limite de requisições por minuto. Acima dele, você recebe um erro 429.

429 Too Many Requests

Erros e reembolsos

Erros JSON com código e mensagem. Um render que falha é reembolsado ao seu saldo automaticamente.

{ "status": "refunded" }
05 · Referência

Endpoints

URL base https://femimg.com/api/v1

GET/api/catalog/meNome e limite da chave, e seu saldo
GET/api/catalog/modelsO catálogo de modelos com seus preços
GET/api/catalog/models/detail?id=MODEL_IDUm modelo com todos os seus campos
POST/api/catalog/quoteO preço exato de um conjunto de entradas
POST/api/catalog/generationsInicie um render com qualquer modelo
GET/api/catalog/generationsSuas gerações recentes
GET/api/catalog/generations/IDStatus, custo e resultado de uma geração
GET/api/catalog/generations/ID/contentBaixe o arquivo pronto
DELETE/api/catalog/generations/IDExclua uma geração

Recarregue € 3 e publique hoje

A API e o estúdio compartilham um só saldo. Um render que falha é reembolsado.

Obter uma chave de APIVer preços