PT ▾
Obter chave de API

Chave de API Flux: o que é e onde se encaixa uma API de texto

Uma chave de API Flux é uma credencial para um serviço de geração de imagens, e este site não vende uma. O que ele vende é uma chave diferente, para uma API LLM de texto hospedada que pode escrever e expandir os prompts que você alimenta em um modelo de imagem.

Atualizado

Duas chaves separadas, uma vinculada a uma moldura de imagem e outra a balões de chat, duas APIs separadas

Pontos principais

  • Uma chave para um serviço de imagem Flux e uma chave para uma API LLM de texto são duas coisas separadas, emitidas por dois provedores separados.
  • Este site é apenas de texto: sem geração de imagem, áudio ou vídeo, e não é operado por nenhum fornecedor de modelo de imagem.
  • Uma chave de texto é útil ao lado de uma chave de imagem porque a escrita de prompts é uma tarefa de texto, cobrada por token.
  • Você altera apenas uma URL base e uma chave em qualquer cliente OpenAI para começar, e um crédito de teste cobre os primeiros testes.

O que as pessoas geralmente querem dizer com uma chave Flux

Flux é o nome de uma família de modelos de texto para imagem. Quando alguém digita flux api key em uma caixa de pesquisa, quase sempre quer uma credencial que permita que seu código envie um prompt para um serviço que hospeda um desses modelos de imagem e receba uma imagem de volta. Essa credencial vem de qualquer empresa que execute o endpoint de imagem que você escolheu. Ela está vinculada à conta deles, ao faturamento e aos termos deles.

Você verá a frase usada de algumas maneiras ligeiramente diferentes, e ajuda a classificá-las antes de colar uma chave em qualquer lugar:

  • Uma chave de um host de imagem que serve modelos Flux, usada em uma solicitação que retorna uma imagem.
  • Uma chave para uma configuração local ou auto-hospedada, onde você cria o token você mesmo e nada sai da sua máquina.
  • Uma chave para outra ferramenta em seu pipeline, como um modelo de texto que escreve os prompts, que só recebe o nome Flux porque o projeto é chamado assim.

Apenas as duas primeiras produzem imagens. A terceira é onde este site se encaixa. Executamos uma API LLM hospedada e compatível com OpenAI, e a chave que você obtém aqui funciona contra essa API e nada mais.

Por que uma chave de imagem não chama um modelo de chat

Os dois tipos de chave parecem semelhantes, pois ambas são cadeias de caracteres longas que você envia no cabeçalho Authorization, mas elas abrem portas diferentes. A chave de um provedor de imagem é verificada pelo próprio provedor de imagem. Se você enviá-la para um endpoint de chat, receberá um erro de autenticação, e o inverso também é verdadeiro: uma chave deste site retornará um erro se você a enviar para um host de imagem.

Os corpos da requisição também diferem. Uma chamada de imagem geralmente carrega um prompt, dimensões, uma semente e uma contagem de imagens. Uma chamada de chat carrega uma lista de mensagens com funções, e retorna texto. Não há um esquema compartilhado, portanto, não há nada para traduzir entre eles. Se você tem um script que funciona contra um host de imagem, mantenha esse script e sua chave exatamente como estão. Adicione a chamada de texto como uma etapa separada à frente dela.

O que este serviço não faz

Para manter as expectativas claras: a API aqui é apenas de texto. Não gera imagens, áudio ou vídeo, não cria embeddings e não oferece fine-tuning. Não é a API oficial de nenhum fornecedor de modelo e não é um roteador entre fornecedores. Serve um único modelo de pesos abertos, ajustado para responder sem recusas de conteúdo para uso adulto legal, e executado por um provedor independente. O ID do modelo que você passa é uncensored.

Onde uma API de texto se encaixa ao lado de uma chave de imagem

A escrita de prompts é o ponto de encontro óbvio. Modelos de imagem respondem bem a descrições específicas e estruturadas: sujeito, cenário, lente, iluminação, cor, humor. A maioria das pessoas escreve esses prompts à mão, depois os reescreve após um resultado ruim. Um modelo de texto pode fazer o primeiro rascunho, expandir uma ideia de três palavras em uma descrição completa ou produzir vinte variações de um tema enquanto você vai buscar um café.

Algumas tarefas que se encaixam bem:

  • Expansão. Transforme uma ideia curta em um prompt detalhado em um estilo que você define uma vez na mensagem do sistema.
  • Variação. Solicite dez abordagens diferentes sobre um mesmo assunto, retornadas como uma lista JSON que seu script pode percorrer.
  • Limpeza. Reescreva um prompt confuso escrito por um cliente em algo que um modelo de imagem processe melhor.
  • Scripts e legendas. Escreva a narração, a lista de tomadas ou a legenda que vai ao lado da imagem.

Como o modelo aqui não recusa por padrão, ele é adequado para ficção, design de personagens e temas maduros que outros modelos hospedados frequentemente recusam, desde que o uso seja legal e envolva adultos. Uma limitação rígida se aplica em todos os lugares: sem conteúdo sexual envolvendo menores de idade. Não oferecemos suporte a solicitações desse tipo, de forma alguma.

Uma primeira chamada em menos de um minuto

Qualquer SDK ou cliente HTTP OpenAI funciona assim que você troca a URL base e a chave. O endpoint para chat é POST /v1/chat/completions, e GET /v1/models lista o modelo. Aqui está a mesma solicitação em curl e em Python.

curl https://api.fluxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
      {"role": "user", "content": "a lighthouse in a storm, painterly"}
    ]
  }'
from openai import OpenAI

client = OpenAI(
    base_url="https://api.fluxapikey.com/v1",
    api_key="YOUR_KEY",
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
        {"role": "user", "content": "a lighthouse in a storm, painterly"},
    ],
)
print(reply.choices[0].message.content)

Qualquer string que retornar é o que você entrega ao seu serviço de imagem, usando a própria chave desse serviço. Os dois nunca se tocam. Para a lista completa de parâmetros, incluindo streaming, chamada de funções e modo JSON, consulte a documentação da API.

Você precisa de ambas as chaves?

Depende do que você está construindo. A tabela abaixo é uma maneira rápida de decidir.

Seu objetivoChave de imagemChave de texto
Gerar imagens a partir de prompts que você escreve sozinhoSimNão
Gerar imagens a partir de prompts que um modelo escreve ou expandeSimSim
Escrever apenas histórias, diálogos ou roteirosNãoSim
Construir um aplicativo de chat ou roleplay para adultosNãoSim
Produzir em lote centenas de variações de promptOpcionalSim

Se você apenas digita seus próprios prompts e está satisfeito com eles, uma chave de texto adiciona pouco. Se você se encontra reescrevendo prompts a tarde toda, ou precisa de volume, ela justifica o custo rapidamente. Também temos um tutorial curto sobre usar um LLM de texto em fluxos de trabalho de vídeo, que segue a mesma ideia de uma etapa de texto na frente de uma etapa de mídia.

Erros que surgem ao confundir chaves

A maioria dos problemas em uma configuração de dois serviços são pequenos e fáceis de identificar assim que você sabe o que procurar.

  • URL base errada. Se seu cliente ainda aponta para o host antigo, a nova chave é rejeitada. Verifique se a URL base termina em /v1 e corresponde à do exemplo acima.
  • Nome do modelo errado. O único ID de modelo aqui é uncensored. Passar o nome de um modelo de imagem retorna um erro, porque não há tal modelo nesta API.
  • Chaves em uma variável de ambiente. Dê a cada serviço sua própria variável, por exemplo TEXT_API_KEY e IMAGE_API_KEY. Compartilhar um nome é como uma chave acaba sendo enviada para o host errado.
  • Esperando imagens na resposta. A resposta é texto simples em choices[0].message.content. Se você precisa de uma imagem, esse texto precisa ser enviado ao seu serviço de imagem como uma segunda chamada.
  • Ignorando 429. Uma explosão acima de 8 requisições simultâneas retorna um 429 com o código de erro concurrency, e acima de 300 requisições por minuto com rate_limited. Reduza a taxa brevemente e tente novamente. Uma requisição de streaming mantém sua posição até que o streaming termine, então feche streams que você não está mais lendo.

A chave de teste tem limites mais baixos: 2 requisições simultâneas e 60 por minuto. Isso é mais do que suficiente para testar manualmente uma etapa de escrita de prompt, mas um lote grande deve aguardar uma chave recarregada.

Quanto custa escrever prompts

O faturamento é por token e pré-pago: $0,15 por 1 milhão de tokens de entrada e $0,50 por 1 milhão de tokens de saída, sem assinatura. As tarefas de prompt são pequenas, então os valores são baixos. Considere uma requisição com uma mensagem de sistema de 600 tokens mais a ideia (entrada) e um prompt expandido de 250 tokens (saída). A entrada custa 600 / 1.000.000 x $0,15 = $0,00009. A saída custa 250 / 1.000.000 x $0,50 = $0,000125. Uma requisição custa $0,000215.

Um lote de 1.000 dessas requisições, portanto, custa cerca de $0,215. O crédito de teste de $0,50, que você pode resgatar com um clique na página de chave após o cadastro, cobre aproximadamente 2.300 deles (0,50 / 0,000215). Não precisa de cartão e dura 7 dias. Requisições falhas ou recusadas não são cobradas, e o crédito que você adicionar posteriormente nunca expira. Os detalhes estão na página de preços.

Obtendo sua chave de texto

Cadastre-se com o Google, ou com um e-mail e senha, e abra a página da chave de API. Resgate o crédito de teste lá se quiser testar primeiro. Recargas pagas variam de $20 a $500 em qualquer valor inteiro, com bônus de +5% a partir de $50, +10% a partir de $100 e +15% a partir de $200. Você pode pagar com cripto (USDT na TRC20, USDC na Base). Cartão não é mais aceito.

Mantenha a chave fora do código do lado do cliente e de repositórios públicos. Os prompts que você envia não são usados para treinamento, mas uma chave vazada gasta seu crédito. A chave completa permite 8 requisições simultâneas e 300 requisições por minuto, então um lote de prompts pode ser executado em paralelo sem trabalho extra.

Perguntas e respostas

Posso usar essa chave para gerar imagens com o Flux?

Não. A chave funciona apenas contra a API de texto deste site. A geração de imagens precisa de uma chave de um provedor que hospede um modelo de imagem.

Esta é a API oficial do Flux?

Não. Esta é uma API de texto independente, hospedada e compatível com OpenAI, com um único modelo, chamado uncensored. Não é executada por nenhum fornecedor de modelos de imagem e não revende os serviços deles.

O modelo de texto pode escrever prompts para minha ferramenta de imagem?

Sim. Solicite um prompt na mensagem do sistema, pegue o texto da resposta e cole ou envie para o seu serviço de imagem. Os dois serviços permanecem independentes.

Preciso de um cartão para experimentar?

Não. Usuários novos podem resgatar $0,50 de crédito de teste com um clique na página de chave, válido por 7 dias, sem necessidade de cartão.

Sua chave está a um formulário de distância

Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.

Obter chave de API